1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
5 Public enumerated types used throughout GTK+
7 <!-- ##### SECTION Long_Description ##### -->
12 <!-- ##### SECTION See_Also ##### -->
17 <!-- ##### ENUM GtkAccelFlags ##### -->
26 <!-- ##### ENUM GtkAnchorType ##### -->
33 @GTK_ANCHOR_NORTH_WEST:
34 @GTK_ANCHOR_NORTH_EAST:
36 @GTK_ANCHOR_SOUTH_WEST:
37 @GTK_ANCHOR_SOUTH_EAST:
49 <!-- ##### ENUM GtkArrowType ##### -->
51 Used to indicate the direction in which a #GtkArrow should point.
54 @GTK_ARROW_UP: Represents an upward pointing arrow.
55 @GTK_ARROW_DOWN: Represents a downward pointing arrow.
56 @GTK_ARROW_LEFT: Represents a left pointing arrow.
57 @GTK_ARROW_RIGHT: Represents a right pointing arrow.
59 <!-- ##### ENUM GtkAttachOptions ##### -->
61 Denotes the expansion properties that a widget will have when it (or its
65 @GTK_EXPAND: the widget should expand to take up any extra space in its
66 container that has been allocated.
67 @GTK_SHRINK: the widget should shrink as and when possible.
68 @GTK_FILL: the widget should fill the space allocated to it.
70 <!-- ##### ENUM GtkButtonBoxStyle ##### -->
72 Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
73 contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
76 @GTK_BUTTONBOX_DEFAULT_STYLE: Default packing.
77 @GTK_BUTTONBOX_SPREAD: Buttons are evenly spread across the ButtonBox.
78 @GTK_BUTTONBOX_EDGE: Buttons are placed at the edges of the ButtonBox.
79 @GTK_BUTTONBOX_START: Buttons are grouped towards the start of box, (on the
80 left for a HBox, or the top for a VBox).
81 @GTK_BUTTONBOX_END: Buttons are grouped towards the end of a box, (on the
82 right for a HBox, or the bottom for a VBox).
84 <!-- ##### ENUM GtkCornerType ##### -->
86 Specifies which corner a child widget should be placed in when packed into
87 a #GtkScrolledWindow. This is effectively the opposite of where the scroll
91 @GTK_CORNER_TOP_LEFT: Place the scrollbars on the right and bottom of the
92 widget (default behaviour).
93 @GTK_CORNER_BOTTOM_LEFT: Place the scrollbars on the top and right of the
95 @GTK_CORNER_TOP_RIGHT: Place the scrollbars on the left and bottom of the
97 @GTK_CORNER_BOTTOM_RIGHT: Place the scrollbars on the top and left of the
100 <!-- ##### ENUM GtkCurveType ##### -->
105 @GTK_CURVE_TYPE_LINEAR:
106 @GTK_CURVE_TYPE_SPLINE:
107 @GTK_CURVE_TYPE_FREE:
109 <!-- ##### ENUM GtkDeleteType ##### -->
115 @GTK_DELETE_WORD_ENDS:
117 @GTK_DELETE_DISPLAY_LINES:
118 @GTK_DELETE_DISPLAY_LINE_ENDS:
119 @GTK_DELETE_PARAGRAPH_ENDS:
120 @GTK_DELETE_PARAGRAPHS:
121 @GTK_DELETE_WHITESPACE:
123 <!-- ##### ENUM GtkDirectionType ##### -->
128 @GTK_DIR_TAB_FORWARD:
129 @GTK_DIR_TAB_BACKWARD:
135 <!-- ##### ENUM GtkExpanderStyle ##### -->
140 @GTK_EXPANDER_COLLAPSED:
141 @GTK_EXPANDER_SEMI_COLLAPSED:
142 @GTK_EXPANDER_SEMI_EXPANDED:
143 @GTK_EXPANDER_EXPANDED:
145 <!-- ##### ENUM GtkIMPreeditStyle ##### -->
150 @GTK_IM_PREEDIT_NOTHING:
151 @GTK_IM_PREEDIT_CALLBACK:
153 <!-- ##### ENUM GtkIMStatusStyle ##### -->
158 @GTK_IM_STATUS_NOTHING:
159 @GTK_IM_STATUS_CALLBACK:
161 <!-- ##### ENUM GtkJustification ##### -->
163 Used for justifying the text inside a #GtkLabel widget. (See also
167 @GTK_JUSTIFY_LEFT: The text is placed at the left edge of the label.
168 @GTK_JUSTIFY_RIGHT: The text is placed at the right edge of the label.
169 @GTK_JUSTIFY_CENTER: The text is placed in the center of the label.
170 @GTK_JUSTIFY_FILL: The text is placed is distributed across the label.
172 <!-- ##### ENUM GtkMatchType ##### -->
184 <!-- ##### ENUM GtkMetricType ##### -->
193 <!-- ##### ENUM GtkMovementStep ##### -->
198 @GTK_MOVEMENT_LOGICAL_POSITIONS:
199 @GTK_MOVEMENT_VISUAL_POSITIONS:
201 @GTK_MOVEMENT_DISPLAY_LINES:
202 @GTK_MOVEMENT_DISPLAY_LINE_ENDS:
203 @GTK_MOVEMENT_PARAGRAPHS:
204 @GTK_MOVEMENT_PARAGRAPH_ENDS:
206 @GTK_MOVEMENT_BUFFER_ENDS:
207 @GTK_MOVEMENT_HORIZONTAL_PAGES:
209 <!-- ##### ENUM GtkOrientation ##### -->
214 @GTK_ORIENTATION_HORIZONTAL:
215 @GTK_ORIENTATION_VERTICAL:
217 <!-- ##### ENUM GtkPackType ##### -->
219 Represents the packing location #GtkBox children. (See: #GtkVBox,
220 #GtkHBox, and #GtkButtonBox).
223 @GTK_PACK_START: The child is packed into the start of the box
224 @GTK_PACK_END: The child is packed into the end of the box
226 <!-- ##### ENUM GtkPathPriorityType ##### -->
231 @GTK_PATH_PRIO_LOWEST:
233 @GTK_PATH_PRIO_APPLICATION:
234 @GTK_PATH_PRIO_THEME:
236 @GTK_PATH_PRIO_HIGHEST:
238 <!-- ##### ENUM GtkPathType ##### -->
244 @GTK_PATH_WIDGET_CLASS:
247 <!-- ##### ENUM GtkPolicyType ##### -->
249 Determines when a scroll bar will be visible.
252 @GTK_POLICY_ALWAYS: The scrollbar is always visible.
253 @GTK_POLICY_AUTOMATIC: The scrollbar will appear and disappear as necessary. For example,
254 when all of a #GtkCList can not be seen.
255 @GTK_POLICY_NEVER: The scrollbar will never appear.
257 <!-- ##### ENUM GtkPositionType ##### -->
267 <!-- ##### ENUM GtkPreviewType ##### -->
269 An enumeration which describes whether a preview
270 contains grayscale or red-green-blue data.
273 @GTK_PREVIEW_COLOR: the preview contains red-green-blue data.
274 @GTK_PREVIEW_GRAYSCALE: The preview contains grayscale data.
276 <!-- ##### ENUM GtkReliefStyle ##### -->
285 <!-- ##### ENUM GtkResizeMode ##### -->
292 @GTK_RESIZE_IMMEDIATE:
294 <!-- ##### ENUM GtkScrollType ##### -->
301 @GTK_SCROLL_STEP_BACKWARD:
302 @GTK_SCROLL_STEP_FORWARD:
303 @GTK_SCROLL_PAGE_BACKWARD:
304 @GTK_SCROLL_PAGE_FORWARD:
306 @GTK_SCROLL_STEP_DOWN:
308 @GTK_SCROLL_PAGE_DOWN:
309 @GTK_SCROLL_STEP_LEFT:
310 @GTK_SCROLL_STEP_RIGHT:
311 @GTK_SCROLL_PAGE_LEFT:
312 @GTK_SCROLL_PAGE_RIGHT:
316 <!-- ##### ENUM GtkSelectionMode ##### -->
322 @GTK_SELECTION_SINGLE:
323 @GTK_SELECTION_BROWSE:
324 @GTK_SELECTION_MULTIPLE:
325 @GTK_SELECTION_EXTENDED:
327 <!-- ##### ENUM GtkShadowType ##### -->
329 Used to change the appearance of an outline typically provided by a #GtkFrame.
332 @GTK_SHADOW_NONE: No outline.
333 @GTK_SHADOW_IN: The outline is bevelled inwards.
334 @GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
335 @GTK_SHADOW_ETCHED_IN: The outline itself is an inward bevel, but the frame
337 @GTK_SHADOW_ETCHED_OUT:
339 <!-- ##### ENUM GtkSideType ##### -->
349 <!-- ##### ENUM GtkStateType ##### -->
351 This type indicates the current state of a widget; the state determines how
352 the widget is drawn. The #GtkStateType enumeration is also used to
353 identify different colors in a #GtkStyle for drawing, so states can be
354 used for subparts of a widget as well as entire widgets.
357 @GTK_STATE_NORMAL: State during normal operation.
358 @GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button.
359 @GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over
360 the widget and the widget will respond to mouse clicks.
361 @GTK_STATE_SELECTED: State of a selected item, such the selected row in a list.
362 @GTK_STATE_INSENSITIVE: State indicating that the widget is
363 unresponsive to user actions.
365 <!-- ##### ENUM GtkSubmenuDirection ##### -->
367 Indicates the direction a sub-menu will appear.
370 @GTK_DIRECTION_LEFT: A sub-menu will appear
371 @GTK_DIRECTION_RIGHT:
373 <!-- ##### ENUM GtkSubmenuPlacement ##### -->
381 <!-- ##### ENUM GtkToolbarStyle ##### -->
383 Used to customize the appearance of a #GtkToolbar. Note that
384 setting the toolbar style overrides the user's preferences
385 for the default toolbar style.
388 @GTK_TOOLBAR_ICONS: Buttons display only icons in the toolbar.
389 @GTK_TOOLBAR_TEXT: Buttons display only text labels in the toolbar.
390 @GTK_TOOLBAR_BOTH: Buttons display text and icons in the toolbar.
391 @GTK_TOOLBAR_BOTH_HORIZ: Buttons display icons and text alongside each
392 other, rather than vertically stacked
394 <!-- ##### ENUM GtkUpdateType ##### -->
399 @GTK_UPDATE_CONTINUOUS:
400 @GTK_UPDATE_DISCONTINUOUS:
403 <!-- ##### ENUM GtkVisibility ##### -->
408 @GTK_VISIBILITY_NONE:
409 @GTK_VISIBILITY_PARTIAL:
410 @GTK_VISIBILITY_FULL:
412 <!-- ##### ENUM GtkWindowPosition ##### -->
414 Window placement can be influenced using this enumeration.
417 @GTK_WIN_POS_NONE: No influence is made on placement.
418 @GTK_WIN_POS_CENTER: Windows should be placed in the center of the screen.
419 @GTK_WIN_POS_MOUSE: Windows should be placed at the current mouse position.
420 @GTK_WIN_POS_CENTER_ALWAYS: Keep window centered as it changes size, etc.
421 @GTK_WIN_POS_CENTER_ON_PARENT: Center the window on its transient
422 parent (see gtk_window_set_transient_for()).
424 <!-- ##### ENUM GtkWindowType ##### -->
426 A #GtkWindow can be one of these types. Most things you'd consider a
427 "window" should have type #GTK_WINDOW_TOPLEVEL; windows with this type
428 are managed by the window manager and have a frame by default (call
429 gtk_window_set_decorated() to toggle the frame). Windows with type
430 #GTK_WINDOW_POPUP are ignored by the window manager; window manager
431 keybindings won't work on them, the window manager won't decorate the
432 window with a frame, many GTK+ features that rely on the window
433 manager will not work (e.g. resize grips and
434 maximization/minimization). #GTK_WINDOW_POPUP is used to implement
435 widgets such as #GtkMenu or tooltips that you normally don't think of
436 as windows per se. Nearly all windows should be #GTK_WINDOW_TOPLEVEL.
437 In particular, do not use #GTK_WINDOW_POPUP just to turn off
438 the window borders; use gtk_window_set_decorated() for that.
441 @GTK_WINDOW_TOPLEVEL: A regular window, such as a dialog.
442 @GTK_WINDOW_POPUP: A special window such as a tooltip.
444 <!-- ##### ENUM GtkSortType ##### -->
446 Determines the direction of a sort.
449 @GTK_SORT_ASCENDING: Sorting is in ascending order.
450 @GTK_SORT_DESCENDING: Sorting is in descending order.