AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Fix up docs for predefined style classes.

Browse Source 
The table was incomplete and out of date. Instead, just
put a list of links in that place, and move all the extra
documentation to the macros. Bug 653785
This commit is contained in:
Matthias Clasen 2011-06-30 19:18:26 -04:00
parent c22fb1684c
commit c2449763ce
3 changed files with 174 additions and 183 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/reference/gtk/gtk3-sections.txt
View File

@ -5547,18 +5547,23 @@ GTK_STYLE_CLASS_PROGRESSBAR
GTK_STYLE_CLASS_SPINNER GTK_STYLE_CLASS_SPINNER
GTK_STYLE_CLASS_TOOLBAR GTK_STYLE_CLASS_TOOLBAR
GTK_STYLE_CLASS_PRIMARY_TOOLBAR GTK_STYLE_CLASS_PRIMARY_TOOLBAR
GTK_STYLE_CLASS_INLINE_TOOLBAR
GTK_STYLE_CLASS_PANE_SEPARATOR GTK_STYLE_CLASS_PANE_SEPARATOR
GTK_STYLE_CLASS_SEPARATOR GTK_STYLE_CLASS_SEPARATOR
GTK_STYLE_CLASS_SIDEBAR
GTK_STYLE_CLASS_DND GTK_STYLE_CLASS_DND
GTK_STYLE_CLASS_ERROR GTK_STYLE_CLASS_ERROR
GTK_STYLE_CLASS_EXPANDER GTK_STYLE_CLASS_EXPANDER
GTK_STYLE_CLASS_FRAME GTK_STYLE_CLASS_FRAME
GTK_STYLE_CLASS_HIGHLIGHT GTK_STYLE_CLASS_HIGHLIGHT
GTK_STYLE_CLASS_IMAGE
GTK_STYLE_CLASS_INFO GTK_STYLE_CLASS_INFO
GTK_STYLE_CLASS_MARK GTK_STYLE_CLASS_MARK
GTK_STYLE_CLASS_NOTEBOOK GTK_STYLE_CLASS_NOTEBOOK
GTK_STYLE_CLASS_QUESTION GTK_STYLE_CLASS_QUESTION
GTK_STYLE_CLASS_SCALE GTK_STYLE_CLASS_SCALE
GTK_STYLE_CLASS_SCALE_HAS_MARKS_ABOVE
GTK_STYLE_CLASS_SCALE_HAS_MARKS_BELOW
GTK_STYLE_CLASS_SPINBUTTON GTK_STYLE_CLASS_SPINBUTTON
GTK_STYLE_CLASS_VIEW GTK_STYLE_CLASS_VIEW
GTK_STYLE_CLASS_WARNING GTK_STYLE_CLASS_WARNING

202
gtk/gtkstylecontext.c
View File

@ -177,164 +177,50 @@
* Widgets can add style classes to their context, which can be used * Widgets can add style classes to their context, which can be used
* to associate different styles by class (see <xref linkend="gtkcssprovider-selectors"/>). Theme engines can also use style classes to vary their * to associate different styles by class (see <xref linkend="gtkcssprovider-selectors"/>). Theme engines can also use style classes to vary their
* rendering. GTK+ has a number of predefined style classes: * rendering. GTK+ has a number of predefined style classes:
* <informaltable> * #GTK_STYLE_CLASS_CELL,
* <tgroup cols="3"> * #GTK_STYLE_CLASS_ENTRY,
* <thead> * #GTK_STYLE_CLASS_BUTTON,
* <row> * #GTK_STYLE_CLASS_CALENDAR,
* <entry>Style class</entry> * #GTK_STYLE_CLASS_SLIDER,
* <entry>Macro</entry> * #GTK_STYLE_CLASS_BACKGROUND,
* <entry>Used by</entry> * #GTK_STYLE_CLASS_RUBBERBAND,
* </row> * #GTK_STYLE_CLASS_TOOLTIP,
* </thead> * #GTK_STYLE_CLASS_MENU,
* <tbody> * #GTK_STYLE_CLASS_MENUBAR,
* <row> * #GTK_STYLE_CLASS_MENUITEM,
* <entry>button</entry> * #GTK_STYLE_CLASS_TOOLBAR,
* <entry>GTK_STYLE_CLASS_BUTTON</entry> * #GTK_STYLE_CLASS_PRIMARY_TOOLBAR,
* <entry>#GtkButton, #GtkToggleButton, #GtkRadioButton, #GtkCheckButton</entry> * #GTK_STYLE_CLASS_INLINE_TOOLBAR,
* </row> * #GTK_STYLE_CLASS_RADIO,
* <row> * #GTK_STYLE_CLASS_CHECK,
* <entry>default</entry> * #GTK_STYLE_CLASS_TROUGH,
* <entry>GTK_STYLE_CLASS_DEFAULT</entry> * #GTK_STYLE_CLASS_SCROLLBAR,
* <entry>#GtkButton</entry> * #GTK_STYLE_CLASS_SCALE,
* </row> * #GTK_STYLE_CLASS_SCALE_HAS_MARKS_ABOVE,
* <row> * #GTK_STYLE_CLASS_SCALE_HAS_MARKS_BELOW,
* <entry>check</entry> * #GTK_STYLE_CLASS_HEADER,
* <entry>GTK_STYLE_CLASS_CHECK</entry> * #GTK_STYLE_CLASS_ACCELERATOR,
* <entry>#GtkCheckButton, #GtkCheckMenuItem, #GtkCellRendererToggle</entry> * #GTK_STYLE_CLASS_GRIP,
* </row> * #GTK_STYLE_CLASS_DOCK,
* <row> * #GTK_STYLE_CLASS_PROGRESSBAR,
* <entry>radio</entry> * #GTK_STYLE_CLASS_SPINNER,
* <entry>GTK_STYLE_CLASS_RADIO</entry> * #GTK_STYLE_CLASS_EXPANDER,
* <entry>#GtkRadioButton, #GtkRadioMenuItem, #GtkCellRendererToggle</entry> * #GTK_STYLE_CLASS_SPINBUTTON,
* </row> * #GTK_STYLE_CLASS_NOTEBOOK,
* <row> * #GTK_STYLE_CLASS_VIEW,
* <entry>arrow</entry> * #GTK_STYLE_CLASS_SIDEBAR,
* <entry>GTK_STYLE_CLASS_ARROW</entry> * #GTK_STYLE_CLASS_IMAGE,
* <entry>#GtkArrow</entry> * #GTK_STYLE_CLASS_HIGHLIGHT,
* </row> * #GTK_STYLE_CLASS_FRAME,
* <row> * #GTK_STYLE_CLASS_DND,
* <entry>calendar</entry> * #GTK_STYLE_CLASS_PANE_SEPARATOR,
* <entry>GTK_STYLE_CLASS_CALENDAR</entry> * #GTK_STYLE_CLASS_SEPARATOR,
* <entry>#GtkCalendar</entry> * #GTK_STYLE_CLASS_INFO,
* </row> * #GTK_STYLE_CLASS_WARNING,
* <row> * #GTK_STYLE_CLASS_QUESTION,
* <entry>entry</entry> * #GTK_STYLE_CLASS_ERROR,
* <entry>GTK_STYLE_CLASS_ENTRY</entry> * #GTK_STYLE_CLASS_HORIZONTAL,
* <entry>#GtkEntry</entry> * #GTK_STYLE_CLASS_VERTICAL.
* </row>
* <row>
* <entry>cell</entry>
* <entry>GTK_STYLE_CLASS_CELL</entry>
* <entry>#GtkCellRendererToggle</entry>
* </row>
* <row>
* <entry>menu</entry>
* <entry>GTK_STYLE_CLASS_MENU</entry>
* <entry>#GtkMenu, #GtkMenuItem, #GtkCheckMenuItem, #GtkRadioMenuItem</entry>
* </row>
* <row>
* <entry>expander</entry>
* <entry>GTK_STYLE_CLASS_EXPANDER</entry>
* <entry>#GtkExpander</entry>
* </row>
* <row>
* <entry>tooltip</entry>
* <entry>GTK_STYLE_CLASS_TOOLTIP</entry>
* <entry>#GtkTooltip</entry>
* </row>
* <row>
* <entry>frame</entry>
* <entry>GTK_STYLE_CLASS_FRAME</entry>
* <entry>#GtkFrame</entry>
* </row>
* <row>
* <entry>scrolled-window</entry>
* <entry></entry>
* <entry>#GtkScrolledWindow</entry>
* </row>
* <row>
* <entry>viewport</entry>
* <entry></entry>
* <entry>#GtkViewport</entry>
* </row>
* <row>
* <entry>trough</entry>
* <entry>GTK_STYLE_CLASS_TROUGH</entry>
* <entry>#GtkScrollbar, #GtkProgressBar, #GtkScale</entry>
* </row>
* <row>
* <entry>progressbar</entry>
* <entry>GTK_STYLE_CLASS_PROGRESSBAR</entry>
* <entry>#GtkProgressBar, #GtkCellRendererProgress</entry>
* </row>
* <row>
* <entry>slider</entry>
* <entry>GTK_STYLE_CLASS_SLIDER</entry>
* <entry>#GtkScrollbar, #GtkScale</entry>
* </row>
* <row>
* <entry>menuitem</entry>
* <entry>GTK_STYLE_CLASS_MENUITEM</entry>
* <entry>#GtkMenuItem</entry>
* </row>
* <row>
* <entry>popup</entry>
* <entry></entry>
* <entry>#GtkMenu</entry>
* </row>
* <row>
* <entry>accelerator</entry>
* <entry>GTK_STYLE_CLASS_ACCELERATOR</entry>
* <entry>#GtkAccelLabel</entry>
* </row>
* <row>
* <entry>menubar</entry>
* <entry>GTK_STYLE_CLASS_MENUBAR</entry>
* <entry>#GtkMenuBar</entry>
* </row>
* <row>
* <entry>toolbar</entry>
* <entry>GTK_STYLE_CLASS_TOOLBAR</entry>
* <entry>#GtkToolbar</entry>
* </row>
* <row>
* <entry>dock</entry>
* <entry>GTK_STYLE_CLASS_DOCK</entry>
* <entry>#GtkHandleBox</entry>
* </row>
* <row>
* <entry>notebook</entry>
* <entry></entry>
* <entry>#GtkNotebook</entry>
* </row>
* <row>
* <entry>background</entry>
* <entry>GTK_STYLE_CLASS_BACKGROUND</entry>
* <entry>#GtkWindow</entry>
* </row>
* <row>
* <entry>rubberband</entry>
* <entry>GTK_STYLE_CLASS_RUBBERBAND</entry>
* <entry></entry>
* </row>
* <row>
* <entry>header</entry>
* <entry>GTK_STYLE_CLASS_HEADER</entry>
* <entry></entry>
* </row>
* <row>
* <entry>grip</entry>
* <entry>GTK_STYLE_CLASS_GRIP</entry>
* <entry>#GtkWindow</entry>
* </row>
* <row>
* <entry>spinner</entry>
* <entry>GTK_STYLE_CLASS_SPINNER</entry>
* <entry>#GtkSpinner</entry>
* </row>
* </tbody>
* </tgroup>
* </informaltable>
* </para> * </para>
* <para> * <para>
* Widgets can also add regions with flags to their context. * Widgets can also add regions with flags to their context.

150
gtk/gtkstylecontext.h
View File

@ -154,6 +154,9 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_CELL: * GTK_STYLE_CLASS_CELL:
* *
* A CSS class to match content rendered in cell views. * A CSS class to match content rendered in cell views.
*
* This is used by cell renderers, e.g. in #GtkIconView
* and #GtkTreeView.
*/ */
#define GTK_STYLE_CLASS_CELL "cell" #define GTK_STYLE_CLASS_CELL "cell"
@ -161,6 +164,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_ENTRY: * GTK_STYLE_CLASS_ENTRY:
* *
* A CSS class to match text entries. * A CSS class to match text entries.
*
* This is used by #GtkEntry.
*/ */
#define GTK_STYLE_CLASS_ENTRY "entry" #define GTK_STYLE_CLASS_ENTRY "entry"
@ -168,6 +173,10 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_BUTTON: * GTK_STYLE_CLASS_BUTTON:
* *
* A CSS class to match buttons. * A CSS class to match buttons.
*
* This is used by #GtkButton and its subclasses, as well
* as various other widget pieces that appear like buttons,
* e.g. the arrows in a #GtkCalendar.
*/ */
#define GTK_STYLE_CLASS_BUTTON "button" #define GTK_STYLE_CLASS_BUTTON "button"
@ -175,6 +184,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_CALENDAR: * GTK_STYLE_CLASS_CALENDAR:
* *
* A CSS class to match calendars. * A CSS class to match calendars.
*
* This is not used by GTK+ itself, currently.
*/ */
#define GTK_STYLE_CLASS_CALENDAR "calendar" #define GTK_STYLE_CLASS_CALENDAR "calendar"
@ -182,6 +193,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_SLIDER: * GTK_STYLE_CLASS_SLIDER:
* *
* A CSS class to match sliders. * A CSS class to match sliders.
*
* This is used by #GtkSwitch and #GtkRange and its subclasses.
*/ */
#define GTK_STYLE_CLASS_SLIDER "slider" #define GTK_STYLE_CLASS_SLIDER "slider"
@ -196,6 +209,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_RUBBERBAND: * GTK_STYLE_CLASS_RUBBERBAND:
* *
* A CSS class to match the rubberband selection rectangle. * A CSS class to match the rubberband selection rectangle.
*
* This is used in #GtkIconView and #GtkTreeView.
*/ */
#define GTK_STYLE_CLASS_RUBBERBAND "rubberband" #define GTK_STYLE_CLASS_RUBBERBAND "rubberband"
@ -210,6 +225,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_MENU: * GTK_STYLE_CLASS_MENU:
* *
* A CSS class to match popup menus. * A CSS class to match popup menus.
*
* This is used in #GtkMenu.
*/ */
#define GTK_STYLE_CLASS_MENU "menu" #define GTK_STYLE_CLASS_MENU "menu"
@ -217,6 +234,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_MENUBAR: * GTK_STYLE_CLASS_MENUBAR:
* *
* A CSS class to menubars. * A CSS class to menubars.
*
* This is used in #GtkMenuBar.
*/ */
#define GTK_STYLE_CLASS_MENUBAR "menubar" #define GTK_STYLE_CLASS_MENUBAR "menubar"
@ -224,6 +243,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_MENUITEM: * GTK_STYLE_CLASS_MENUITEM:
* *
* A CSS class to match menu items. * A CSS class to match menu items.
*
* This is used in #GtkMenuItem and its subclasses.
*/ */
#define GTK_STYLE_CLASS_MENUITEM "menuitem" #define GTK_STYLE_CLASS_MENUITEM "menuitem"
@ -231,6 +252,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_TOOLBAR: * GTK_STYLE_CLASS_TOOLBAR:
* *
* A CSS class to match toolbars. * A CSS class to match toolbars.
*
* This is used in #GtkToolbar.
*/ */
#define GTK_STYLE_CLASS_TOOLBAR "toolbar" #define GTK_STYLE_CLASS_TOOLBAR "toolbar"
@ -238,6 +261,9 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_PRIMARY_TOOLBAR: * GTK_STYLE_CLASS_PRIMARY_TOOLBAR:
* *
* A CSS class to match primary toolbars. * A CSS class to match primary toolbars.
*
* This should be used for the 'main' toolbar of an application,
* right below its menubar.
*/ */
#define GTK_STYLE_CLASS_PRIMARY_TOOLBAR "primary-toolbar" #define GTK_STYLE_CLASS_PRIMARY_TOOLBAR "primary-toolbar"
@ -245,6 +271,10 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_INLINE_TOOLBAR: * GTK_STYLE_CLASS_INLINE_TOOLBAR:
* *
* A CSS class to match inline toolbars. * A CSS class to match inline toolbars.
*
* This should be used for toolbars that are used to hold
* actions below lists, as seen e.g. in the left pane of the
* file chooser.
*/ */
#define GTK_STYLE_CLASS_INLINE_TOOLBAR "inline-toolbar" #define GTK_STYLE_CLASS_INLINE_TOOLBAR "inline-toolbar"
@ -252,6 +282,9 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_RADIO: * GTK_STYLE_CLASS_RADIO:
* *
* A CSS class to match radio buttons. * A CSS class to match radio buttons.
*
* This is used in #GtkRadioButton, #GtkRadioMenuItem and
* #GtkCellRendererToggle.
*/ */
#define GTK_STYLE_CLASS_RADIO "radio" #define GTK_STYLE_CLASS_RADIO "radio"
@ -259,6 +292,9 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_CHECK: * GTK_STYLE_CLASS_CHECK:
* *
* A CSS class to match check boxes. * A CSS class to match check boxes.
*
* This is used in #GtkCheckButton, #GtkCheckMenuItem and
* #GtkCellRendererToggle.
*/ */
#define GTK_STYLE_CLASS_CHECK "check" #define GTK_STYLE_CLASS_CHECK "check"
@ -266,6 +302,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_DEFAULT: * GTK_STYLE_CLASS_DEFAULT:
* *
* A CSS class to match the default widget. * A CSS class to match the default widget.
*
* This is used by #GtkButton.
*/ */
#define GTK_STYLE_CLASS_DEFAULT "default" #define GTK_STYLE_CLASS_DEFAULT "default"
@ -273,6 +311,9 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_TROUGH: * GTK_STYLE_CLASS_TROUGH:
* *
* A CSS class to match troughs, as in scrollbars and progressbars. * A CSS class to match troughs, as in scrollbars and progressbars.
*
* This is used in #GtkRange and its subclasses, #GtkProgressBar
* and #GtkSwitch.
*/ */
#define GTK_STYLE_CLASS_TROUGH "trough" #define GTK_STYLE_CLASS_TROUGH "trough"
@ -287,6 +328,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_SCALE: * GTK_STYLE_CLASS_SCALE:
* *
* A CSS class to match scale widgets. * A CSS class to match scale widgets.
*
* This is used in #GtkScale.
*/ */
#define GTK_STYLE_CLASS_SCALE "scale" #define GTK_STYLE_CLASS_SCALE "scale"
@ -312,6 +355,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_HEADER: * GTK_STYLE_CLASS_HEADER:
* *
* A CSS class to match a header element. * A CSS class to match a header element.
*
* This is used for the header in #GtkCalendar.
*/ */
#define GTK_STYLE_CLASS_HEADER "header" #define GTK_STYLE_CLASS_HEADER "header"
@ -319,6 +364,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_ACCELERATOR: * GTK_STYLE_CLASS_ACCELERATOR:
* *
* A CSS class to match an accelerator. * A CSS class to match an accelerator.
*
* This is used for the accelerator in #GtkAccelLabel.
*/ */
#define GTK_STYLE_CLASS_ACCELERATOR "accelerator" #define GTK_STYLE_CLASS_ACCELERATOR "accelerator"
@ -327,83 +374,111 @@ struct _GtkStyleContextClass
* *
* A CSS class to match a raised control, such as a raised * A CSS class to match a raised control, such as a raised
* button on a toolbar. * button on a toolbar.
*
* This should be used in conjunction with #GTK_STYLE_CLASS_PRIMARY_TOOLBAR.
*/ */
#define GTK_STYLE_CLASS_RAISED "raised" #define GTK_STYLE_CLASS_RAISED "raised"
/** /**
* GTK_STYLE_CLASS_GRIP: * GTK_STYLE_CLASS_GRIP:
* *
* A widget class defining a resize grip * A CSS class defining a resize grip.
*
* This is used for the resize grip in #GtkWindow.
*/ */
#define GTK_STYLE_CLASS_GRIP "grip" #define GTK_STYLE_CLASS_GRIP "grip"
/** /**
* GTK_STYLE_CLASS_DOCK: * GTK_STYLE_CLASS_DOCK:
* *
* A widget class defining a dock area * A CSS class defining a dock area.
*
* This is used by #GtkHandleBox.
*/ */
#define GTK_STYLE_CLASS_DOCK "dock" #define GTK_STYLE_CLASS_DOCK "dock"
/** /**
* GTK_STYLE_CLASS_PROGRESSBAR: * GTK_STYLE_CLASS_PROGRESSBAR:
* *
* A widget class defining a resize grip * A CSS class to use when rendering activity as a progressbar.
*
* This is used in #GtkProgressBar and when drawing progress
* inside a #GtkEntry or in #GtkCellRendererProgress.
*/ */
#define GTK_STYLE_CLASS_PROGRESSBAR "progressbar" #define GTK_STYLE_CLASS_PROGRESSBAR "progressbar"
/** /**
* GTK_STYLE_CLASS_SPINNER: * GTK_STYLE_CLASS_SPINNER:
* *
* A widget class defining a spinner * A CSS class to use when rendering activity as a 'spinner'.
*
* This is used by #GtkSpinner and #GtkCellRendererSpinner.
*/ */
#define GTK_STYLE_CLASS_SPINNER "spinner" #define GTK_STYLE_CLASS_SPINNER "spinner"
/** /**
* GTK_STYLE_CLASS_MARK: * GTK_STYLE_CLASS_MARK:
* *
* A widget class defining marks in a widget, such as in scales * A CSS class defining marks in a widget, such as in scales.
*
* Used in #GtkScale.
*/ */
#define GTK_STYLE_CLASS_MARK "mark" #define GTK_STYLE_CLASS_MARK "mark"
/** /**
* GTK_STYLE_CLASS_EXPANDER: * GTK_STYLE_CLASS_EXPANDER:
* *
* A widget class defining an expander, such as those in treeviews * A CSS class defining an expander, such as those in treeviews.
*
* Used for drawing expanders in #GtkTreeView, GtkExpander and
* #GtkToolItemGroup.
*/ */
#define GTK_STYLE_CLASS_EXPANDER "expander" #define GTK_STYLE_CLASS_EXPANDER "expander"
/** /**
* GTK_STYLE_CLASS_SPINBUTTON: * GTK_STYLE_CLASS_SPINBUTTON:
* *
* A widget class defining an spinbutton * A CSS class defining an spinbutton.
*
* This is used in #GtkSpinButton.
*/ */
#define GTK_STYLE_CLASS_SPINBUTTON "spinbutton" #define GTK_STYLE_CLASS_SPINBUTTON "spinbutton"
/** /**
* GTK_STYLE_CLASS_NOTEBOOK: * GTK_STYLE_CLASS_NOTEBOOK:
* *
* A widget class defining a notebook * A CSS class defining a notebook.
*
* Used in #GtkNotebook.
*/ */
#define GTK_STYLE_CLASS_NOTEBOOK "notebook" #define GTK_STYLE_CLASS_NOTEBOOK "notebook"
/** /**
* GTK_STYLE_CLASS_VIEW: * GTK_STYLE_CLASS_VIEW:
* *
* A widget class defining a view, such as iconviews or treeviews * A CSS class defining a view, such as iconviews or treeviews.
*
* This is used in #GtkTreeView, #GtkIconView, #GtkTextView,
* as well as #GtkCalendar.
*/ */
#define GTK_STYLE_CLASS_VIEW "view" #define GTK_STYLE_CLASS_VIEW "view"
/** /**
* GTK_STYLE_CLASS_SIDEBAR: * GTK_STYLE_CLASS_SIDEBAR:
* *
* A widget class defining a sidebar * A CSS class defining a sidebar, such as the left side in
* a file chooser.
*
* This is used in #GtkFileChooser and in #GtkAssistant.
*/ */
#define GTK_STYLE_CLASS_SIDEBAR "sidebar" #define GTK_STYLE_CLASS_SIDEBAR "sidebar"
/** /**
* GTK_STYLE_CLASS_IMAGE: * GTK_STYLE_CLASS_IMAGE:
* *
* A widget class defining an image, such as the icon in an entry. * A CSS class defining an image, such as the icon in an entry.
*
* This is used when rendering icons in #GtkEntry.
*/ */
#define GTK_STYLE_CLASS_IMAGE "image" #define GTK_STYLE_CLASS_IMAGE "image"
@ -411,22 +486,30 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_HIGHLIGHT: * GTK_STYLE_CLASS_HIGHLIGHT:
* *
* A CSS class defining a highlighted area, such as headings in * A CSS class defining a highlighted area, such as headings in
* assistants. * assistants and calendars.
*
* This is used in #GtkAssistant and #GtkCalendar.
*/ */
#define GTK_STYLE_CLASS_HIGHLIGHT "highlight" #define GTK_STYLE_CLASS_HIGHLIGHT "highlight"
/** /**
* GTK_STYLE_CLASS_FRAME: * GTK_STYLE_CLASS_FRAME:
* *
* A CSS class defining a frame delimiting content, such as GtkFrame * A CSS class defining a frame delimiting content, such as
* or the scrolled window frame around the scrollable area. * #GtkFrame or the scrolled window frame around the
* scrollable area.
*
* This is used in #GtkFrame and #GtkScrollbar.
*/ */
#define GTK_STYLE_CLASS_FRAME "frame" #define GTK_STYLE_CLASS_FRAME "frame"
/** /**
* GTK_STYLE_CLASS_DND: * GTK_STYLE_CLASS_DND:
* *
* A CSS class for a drag-and-drop indicator * A CSS class for a drag-and-drop indicator.
*
* This is used when drawing an outline around a potential
* drop target during DND.
*/ */
#define GTK_STYLE_CLASS_DND "dnd" #define GTK_STYLE_CLASS_DND "dnd"
@ -434,6 +517,8 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_PANE_SEPARATOR: * GTK_STYLE_CLASS_PANE_SEPARATOR:
* *
* A CSS class for a pane separator, such as those in #GtkPaned. * A CSS class for a pane separator, such as those in #GtkPaned.
*
* Used in #GtkPaned.
*/ */
#define GTK_STYLE_CLASS_PANE_SEPARATOR "pane-separator" #define GTK_STYLE_CLASS_PANE_SEPARATOR "pane-separator"
@ -441,52 +526,67 @@ struct _GtkStyleContextClass
* GTK_STYLE_CLASS_SEPARATOR: * GTK_STYLE_CLASS_SEPARATOR:
* *
* A CSS class for a separator. * A CSS class for a separator.
*
* This is used in #GtkSeparator, #GtkSeparatorMenuItem,
* #GtkSeparatorToolItem, and when drawing separators in #GtkTreeView.
*/ */
#define GTK_STYLE_CLASS_SEPARATOR "separator" #define GTK_STYLE_CLASS_SEPARATOR "separator"
/** /**
* GTK_STYLE_CLASS_INFO: * GTK_STYLE_CLASS_INFO:
* *
* A widget class for an area displaying an informational message, * A CSS class for an area displaying an informational message,
* such as those in infobars * such as those in infobars.
*
* This is used by #GtkInfoBar.
*/ */
#define GTK_STYLE_CLASS_INFO "info" #define GTK_STYLE_CLASS_INFO "info"
/** /**
* GTK_STYLE_CLASS_WARNING: * GTK_STYLE_CLASS_WARNING:
* *
* A widget class for an area displaying a warning message, * A CSS class for an area displaying a warning message,
* such as those in infobars * such as those in infobars.
*
* This is used by #GtkInfoBar.
*/ */
#define GTK_STYLE_CLASS_WARNING "warning" #define GTK_STYLE_CLASS_WARNING "warning"
/** /**
* GTK_STYLE_CLASS_QUESTION: * GTK_STYLE_CLASS_QUESTION:
* *
* A widget class for an area displaying a question to the user, * A CSS class for an area displaying a question to the user,
* such as those in infobars * such as those in infobars.
*
* This is used by #GtkInfoBar.
*/ */
#define GTK_STYLE_CLASS_QUESTION "question" #define GTK_STYLE_CLASS_QUESTION "question"
/** /**
* GTK_STYLE_CLASS_ERROR: * GTK_STYLE_CLASS_ERROR:
* *
* A widget class for an area displaying an error message, * A CSS class for an area displaying an error message,
* such as those in infobars * such as those in infobars.
*
* This is used by #GtkInfoBar.
*/ */
#define GTK_STYLE_CLASS_ERROR "error" #define GTK_STYLE_CLASS_ERROR "error"
/** /**
* GTK_STYLE_CLASS_HORIZONTAL: * GTK_STYLE_CLASS_HORIZONTAL:
* *
* A widget class for horizontally layered widgets. * A CSS class for horizontally layered widgets.
*
* This is used by widgets implementing #GtkOrientable.
*/ */
#define GTK_STYLE_CLASS_HORIZONTAL "horizontal" #define GTK_STYLE_CLASS_HORIZONTAL "horizontal"
/** /**
* GTK_STYLE_CLASS_VERTICAL: * GTK_STYLE_CLASS_VERTICAL:
* *
* A widget class for vertically layered widgets. * A CSS class for vertically layered widgets.
*
* This is used by widgets implementing #GtkOrientable.
*/ */
#define GTK_STYLE_CLASS_VERTICAL "vertical" #define GTK_STYLE_CLASS_VERTICAL "vertical"