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 ##### -->
137 Used to specify the style of the expanders drawn by a #GtkTreeView.
140 @GTK_EXPANDER_COLLAPSED: The style used for a collapsed subtree.
141 @GTK_EXPANDER_SEMI_COLLAPSED: Intermediate style used during animation.
142 @GTK_EXPANDER_SEMI_EXPANDED: Intermediate style used during animation.
143 @GTK_EXPANDER_EXPANDED: The style used for an expanded subtree.
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 ##### -->
186 Used to indicate which metric is used by a #GtkRuler.
191 @GTK_CENTIMETERS: Centimeters.
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 ##### -->
211 Represents the orientation of widgets which can be switched between horizontal
212 and vertical orientation on the fly, like #GtkToolbar.
215 @GTK_ORIENTATION_HORIZONTAL: The widget is in horizontal orientation.
216 @GTK_ORIENTATION_VERTICAL: The widget is in vertical orientation.
218 <!-- ##### ENUM GtkPackType ##### -->
220 Represents the packing location #GtkBox children. (See: #GtkVBox,
221 #GtkHBox, and #GtkButtonBox).
224 @GTK_PACK_START: The child is packed into the start of the box
225 @GTK_PACK_END: The child is packed into the end of the box
227 <!-- ##### ENUM GtkPathPriorityType ##### -->
232 @GTK_PATH_PRIO_LOWEST:
234 @GTK_PATH_PRIO_APPLICATION:
235 @GTK_PATH_PRIO_THEME:
237 @GTK_PATH_PRIO_HIGHEST:
239 <!-- ##### ENUM GtkPathType ##### -->
245 @GTK_PATH_WIDGET_CLASS:
248 <!-- ##### ENUM GtkPolicyType ##### -->
250 Determines when a scroll bar will be visible.
253 @GTK_POLICY_ALWAYS: The scrollbar is always visible.
254 @GTK_POLICY_AUTOMATIC: The scrollbar will appear and disappear as necessary. For example,
255 when all of a #GtkCList can not be seen.
256 @GTK_POLICY_NEVER: The scrollbar will never appear.
258 <!-- ##### ENUM GtkPositionType ##### -->
260 Describes which edge of a widget a certain feature is positioned at, e.g. the
261 tabs of a #GtkNotebook, the handle of a #GtkHandleBox or the label of a
265 @GTK_POS_LEFT: The feature is at the left edge.
266 @GTK_POS_RIGHT: The feature is at the right edge.
267 @GTK_POS_TOP: The feature is at the top edge.
268 @GTK_POS_BOTTOM: The feature is at the bottom edge.
270 <!-- ##### ENUM GtkPreviewType ##### -->
272 An enumeration which describes whether a preview
273 contains grayscale or red-green-blue data.
276 @GTK_PREVIEW_COLOR: the preview contains red-green-blue data.
277 @GTK_PREVIEW_GRAYSCALE: The preview contains grayscale data.
279 <!-- ##### ENUM GtkReliefStyle ##### -->
281 Indicated the relief to be drawn around a #GtkButton.
284 @GTK_RELIEF_NORMAL: Draw a normal relief.
285 @GTK_RELIEF_HALF: A half relief.
286 @GTK_RELIEF_NONE: No relief.
288 <!-- ##### ENUM GtkResizeMode ##### -->
295 @GTK_RESIZE_IMMEDIATE:
297 <!-- ##### ENUM GtkScrollType ##### -->
304 @GTK_SCROLL_STEP_BACKWARD:
305 @GTK_SCROLL_STEP_FORWARD:
306 @GTK_SCROLL_PAGE_BACKWARD:
307 @GTK_SCROLL_PAGE_FORWARD:
309 @GTK_SCROLL_STEP_DOWN:
311 @GTK_SCROLL_PAGE_DOWN:
312 @GTK_SCROLL_STEP_LEFT:
313 @GTK_SCROLL_STEP_RIGHT:
314 @GTK_SCROLL_PAGE_LEFT:
315 @GTK_SCROLL_PAGE_RIGHT:
319 <!-- ##### ENUM GtkSelectionMode ##### -->
325 @GTK_SELECTION_SINGLE:
326 @GTK_SELECTION_BROWSE:
327 @GTK_SELECTION_MULTIPLE:
328 @GTK_SELECTION_EXTENDED:
330 <!-- ##### ENUM GtkShadowType ##### -->
332 Used to change the appearance of an outline typically provided by a #GtkFrame.
335 @GTK_SHADOW_NONE: No outline.
336 @GTK_SHADOW_IN: The outline is bevelled inwards.
337 @GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
338 @GTK_SHADOW_ETCHED_IN: The outline itself is an inward bevel, but the frame
340 @GTK_SHADOW_ETCHED_OUT:
342 <!-- ##### ENUM GtkSideType ##### -->
352 <!-- ##### ENUM GtkStateType ##### -->
354 This type indicates the current state of a widget; the state determines how
355 the widget is drawn. The #GtkStateType enumeration is also used to
356 identify different colors in a #GtkStyle for drawing, so states can be
357 used for subparts of a widget as well as entire widgets.
360 @GTK_STATE_NORMAL: State during normal operation.
361 @GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button.
362 @GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over
363 the widget and the widget will respond to mouse clicks.
364 @GTK_STATE_SELECTED: State of a selected item, such the selected row in a list.
365 @GTK_STATE_INSENSITIVE: State indicating that the widget is
366 unresponsive to user actions.
368 <!-- ##### ENUM GtkSubmenuDirection ##### -->
370 Indicates the direction a sub-menu will appear.
373 @GTK_DIRECTION_LEFT: A sub-menu will appear
374 @GTK_DIRECTION_RIGHT:
376 <!-- ##### ENUM GtkSubmenuPlacement ##### -->
384 <!-- ##### ENUM GtkToolbarStyle ##### -->
386 Used to customize the appearance of a #GtkToolbar. Note that
387 setting the toolbar style overrides the user's preferences
388 for the default toolbar style.
391 @GTK_TOOLBAR_ICONS: Buttons display only icons in the toolbar.
392 @GTK_TOOLBAR_TEXT: Buttons display only text labels in the toolbar.
393 @GTK_TOOLBAR_BOTH: Buttons display text and icons in the toolbar.
394 @GTK_TOOLBAR_BOTH_HORIZ: Buttons display icons and text alongside each
395 other, rather than vertically stacked
397 <!-- ##### ENUM GtkUpdateType ##### -->
402 @GTK_UPDATE_CONTINUOUS:
403 @GTK_UPDATE_DISCONTINUOUS:
406 <!-- ##### ENUM GtkVisibility ##### -->
408 Used by #GtkCList and #GtkCTree to indicate whether a row is visible.
411 @GTK_VISIBILITY_NONE: The row is not visible.
412 @GTK_VISIBILITY_PARTIAL: The row is partially visible.
413 @GTK_VISIBILITY_FULL: The row is fully visible.
415 <!-- ##### ENUM GtkWindowPosition ##### -->
417 Window placement can be influenced using this enumeration.
420 @GTK_WIN_POS_NONE: No influence is made on placement.
421 @GTK_WIN_POS_CENTER: Windows should be placed in the center of the screen.
422 @GTK_WIN_POS_MOUSE: Windows should be placed at the current mouse position.
423 @GTK_WIN_POS_CENTER_ALWAYS: Keep window centered as it changes size, etc.
424 @GTK_WIN_POS_CENTER_ON_PARENT: Center the window on its transient
425 parent (see gtk_window_set_transient_for()).
427 <!-- ##### ENUM GtkWindowType ##### -->
429 A #GtkWindow can be one of these types. Most things you'd consider a
430 "window" should have type #GTK_WINDOW_TOPLEVEL; windows with this type
431 are managed by the window manager and have a frame by default (call
432 gtk_window_set_decorated() to toggle the frame). Windows with type
433 #GTK_WINDOW_POPUP are ignored by the window manager; window manager
434 keybindings won't work on them, the window manager won't decorate the
435 window with a frame, many GTK+ features that rely on the window
436 manager will not work (e.g. resize grips and
437 maximization/minimization). #GTK_WINDOW_POPUP is used to implement
438 widgets such as #GtkMenu or tooltips that you normally don't think of
439 as windows per se. Nearly all windows should be #GTK_WINDOW_TOPLEVEL.
440 In particular, do not use #GTK_WINDOW_POPUP just to turn off
441 the window borders; use gtk_window_set_decorated() for that.
444 @GTK_WINDOW_TOPLEVEL: A regular window, such as a dialog.
445 @GTK_WINDOW_POPUP: A special window such as a tooltip.
447 <!-- ##### ENUM GtkSortType ##### -->
449 Determines the direction of a sort.
452 @GTK_SORT_ASCENDING: Sorting is in ascending order.
453 @GTK_SORT_DESCENDING: Sorting is in descending order.