1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
25 #ifndef __GTK_ENUMS_H__
26 #define __GTK_ENUMS_H__
28 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
29 #error "Only <gtk/gtk.h> can be included directly."
32 #include <glib-object.h>
37 * @Short_description: Public enumerated types used throughout GTK+
38 * @Title: Standard Enumerations
46 * @GTK_ALIGN_FILL: stretch to fill all space if possible, center if
47 * no meaningful way to stretch
48 * @GTK_ALIGN_START: snap to left or top side, leaving space on right
50 * @GTK_ALIGN_END: snap to right or bottom side, leaving space on left
52 * @GTK_ALIGN_CENTER: center natural width of widget inside the
55 * Controls how a widget deals with extra space in a single (x or y)
58 * Alignment only matters if the widget receives a "too large" allocation,
59 * for example if you packed the widget with the #GtkWidget:expand
60 * flag inside a #GtkBox, then the widget might get extra space. If
61 * you have for example a 16x16 icon inside a 32x32 space, the icon
62 * could be scaled and stretched, it could be centered, or it could be
63 * positioned to one side of the space.
65 * Note that in horizontal context @GTK_ALIGN_START and @GTK_ALIGN_END
66 * are interpreted relative to text direction.
79 * @GTK_ARROWS_BOTH: Place one arrow on each end of the menu.
80 * @GTK_ARROWS_START: Place both arrows at the top of the menu.
81 * @GTK_ARROWS_END: Place both arrows at the bottom of the menu.
83 * Used to specify the placement of scroll arrows in scrolling menus.
94 * @GTK_ARROW_UP: Represents an upward pointing arrow.
95 * @GTK_ARROW_DOWN: Represents a downward pointing arrow.
96 * @GTK_ARROW_LEFT: Represents a left pointing arrow.
97 * @GTK_ARROW_RIGHT: Represents a right pointing arrow.
98 * @GTK_ARROW_NONE: No arrow. Since 2.10.
100 * Used to indicate the direction in which a #GtkArrow should point.
113 * @GTK_EXPAND: the widget should expand to take up any extra space in its
114 * container that has been allocated.
115 * @GTK_SHRINK: the widget should shrink as and when possible.
116 * @GTK_FILL: the widget should fill the space allocated to it.
118 * Denotes the expansion properties that a widget will have when it (or its
119 * parent) is resized.
130 * @GTK_BUTTONBOX_DEFAULT_STYLE: Default packing.
131 * @GTK_BUTTONBOX_SPREAD: Buttons are evenly spread across the box.
132 * @GTK_BUTTONBOX_EDGE: Buttons are placed at the edges of the box.
133 * @GTK_BUTTONBOX_START: Buttons are grouped towards the start of the box,
134 * (on the left for a HBox, or the top for a VBox).
135 * @GTK_BUTTONBOX_END: Buttons are grouped towards the end of the box,
136 * (on the right for a HBox, or the bottom for a VBox).
137 * @GTK_BUTTONBOX_CENTER: Buttons are centered in the box. Since 2.12.
139 * Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
140 * contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
144 GTK_BUTTONBOX_SPREAD = 1,
155 GTK_DELETE_WORD_ENDS, /* delete only the portion of the word to the
156 * left/right of cursor if we're in the middle
159 GTK_DELETE_DISPLAY_LINES,
160 GTK_DELETE_DISPLAY_LINE_ENDS,
161 GTK_DELETE_PARAGRAPH_ENDS, /* like C-k in Emacs (or its reverse) */
162 GTK_DELETE_PARAGRAPHS, /* C-k in pico, kill whole line */
163 GTK_DELETE_WHITESPACE /* M-\ in Emacs */
166 /* Focus movement types */
170 GTK_DIR_TAB_BACKWARD,
179 * @GTK_EXPANDER_COLLAPSED: The style used for a collapsed subtree.
180 * @GTK_EXPANDER_SEMI_COLLAPSED: Intermediate style used during animation.
181 * @GTK_EXPANDER_SEMI_EXPANDED: Intermediate style used during animation.
182 * @GTK_EXPANDER_EXPANDED: The style used for an expanded subtree.
184 * Used to specify the style of the expanders drawn by a #GtkTreeView.
188 GTK_EXPANDER_COLLAPSED,
189 GTK_EXPANDER_SEMI_COLLAPSED,
190 GTK_EXPANDER_SEMI_EXPANDED,
191 GTK_EXPANDER_EXPANDED
194 /* Built-in stock icon sizes */
197 GTK_ICON_SIZE_INVALID,
199 GTK_ICON_SIZE_SMALL_TOOLBAR,
200 GTK_ICON_SIZE_LARGE_TOOLBAR,
201 GTK_ICON_SIZE_BUTTON,
207 * GtkSensitivityType:
208 * @GTK_SENSITIVITY_AUTO: The arrow is made insensitive if the
209 * thumb is at the end
210 * @GTK_SENSITIVITY_ON: The arrow is always sensitive
211 * @GTK_SENSITIVITY_OFF: The arrow is always insensitive
213 * Determines how GTK+ handles the sensitivity of stepper arrows
214 * at the end of range widgets.
218 GTK_SENSITIVITY_AUTO,
221 } GtkSensitivityType;
223 /* Reading directions for text */
233 * @GTK_JUSTIFY_LEFT: The text is placed at the left edge of the label.
234 * @GTK_JUSTIFY_RIGHT: The text is placed at the right edge of the label.
235 * @GTK_JUSTIFY_CENTER: The text is placed in the center of the label.
236 * @GTK_JUSTIFY_FILL: The text is placed is distributed across the label.
238 * Used for justifying the text inside a #GtkLabel widget. (See also
250 * GtkMenuDirectionType:
251 * @GTK_MENU_DIR_PARENT: To the parent menu shell
252 * @GTK_MENU_DIR_CHILD: To the submenu, if any, associated with the item
253 * @GTK_MENU_DIR_NEXT: To the next menu item
254 * @GTK_MENU_DIR_PREV: To the previous menu item
256 * An enumeration representing directional movements within a menu.
264 } GtkMenuDirectionType;
268 * @GTK_MESSAGE_INFO: Informational message
269 * @GTK_MESSAGE_WARNING: Nonfatal warning message
270 * @GTK_MESSAGE_QUESTION: Question requiring a choice
271 * @GTK_MESSAGE_ERROR: Fatal error message
272 * @GTK_MESSAGE_OTHER: None of the above, doesn't get an icon
274 * The type of message being displayed in the dialog.
280 GTK_MESSAGE_QUESTION,
287 * @GTK_MOVEMENT_LOGICAL_POSITIONS: Move forward or back by graphemes
288 * @GTK_MOVEMENT_VISUAL_POSITIONS: Move left or right by graphemes
289 * @GTK_MOVEMENT_WORDS: Move forward or back by words
290 * @GTK_MOVEMENT_DISPLAY_LINES: Move up or down lines (wrapped lines)
291 * @GTK_MOVEMENT_DISPLAY_LINE_ENDS: Move to either end of a line
292 * @GTK_MOVEMENT_PARAGRAPHS: Move up or down paragraphs (newline-ended lines)
293 * @GTK_MOVEMENT_PARAGRAPH_ENDS: Move to either end of a paragraph
294 * @GTK_MOVEMENT_PAGES: Move by pages
295 * @GTK_MOVEMENT_BUFFER_ENDS: Move to ends of the buffer
296 * @GTK_MOVEMENT_HORIZONTAL_PAGES: Move horizontally by pages
300 GTK_MOVEMENT_LOGICAL_POSITIONS,
301 GTK_MOVEMENT_VISUAL_POSITIONS,
303 GTK_MOVEMENT_DISPLAY_LINES,
304 GTK_MOVEMENT_DISPLAY_LINE_ENDS,
305 GTK_MOVEMENT_PARAGRAPHS,
306 GTK_MOVEMENT_PARAGRAPH_ENDS,
308 GTK_MOVEMENT_BUFFER_ENDS,
309 GTK_MOVEMENT_HORIZONTAL_PAGES
317 GTK_SCROLL_HORIZONTAL_STEPS,
318 GTK_SCROLL_HORIZONTAL_PAGES,
319 GTK_SCROLL_HORIZONTAL_ENDS
324 * @GTK_ORIENTATION_HORIZONTAL: The widget is in horizontal orientation.
325 * @GTK_ORIENTATION_VERTICAL: The widget is in vertical orientation.
327 * Represents the orientation of widgets which can be switched between horizontal
328 * and vertical orientation on the fly, like #GtkToolbar.
332 GTK_ORIENTATION_HORIZONTAL,
333 GTK_ORIENTATION_VERTICAL
338 * @GTK_CORNER_TOP_LEFT: Place the scrollbars on the right and bottom of the
339 * widget (default behaviour).
340 * @GTK_CORNER_BOTTOM_LEFT: Place the scrollbars on the top and right of the
342 * @GTK_CORNER_TOP_RIGHT: Place the scrollbars on the left and bottom of the
344 * @GTK_CORNER_BOTTOM_RIGHT: Place the scrollbars on the top and left of the
347 * Specifies which corner a child widget should be placed in when packed into
348 * a #GtkScrolledWindow. This is effectively the opposite of where the scroll
354 GTK_CORNER_BOTTOM_LEFT,
355 GTK_CORNER_TOP_RIGHT,
356 GTK_CORNER_BOTTOM_RIGHT
361 * @GTK_PACK_START: The child is packed into the start of the box
362 * @GTK_PACK_END: The child is packed into the end of the box
364 * Represents the packing location #GtkBox children. (See: #GtkVBox,
365 * #GtkHBox, and #GtkButtonBox).
373 /* priorities for path lookups */
376 GTK_PATH_PRIO_LOWEST = 0,
377 GTK_PATH_PRIO_GTK = 4,
378 GTK_PATH_PRIO_APPLICATION = 8,
379 GTK_PATH_PRIO_THEME = 10,
380 GTK_PATH_PRIO_RC = 12,
381 GTK_PATH_PRIO_HIGHEST = 15
382 } GtkPathPriorityType;
383 #define GTK_PATH_PRIO_MASK 0x0f
385 /* widget path types */
389 GTK_PATH_WIDGET_CLASS,
395 * @GTK_POLICY_ALWAYS: The scrollbar is always visible.
396 * @GTK_POLICY_AUTOMATIC: The scrollbar will appear and disappear as necessary. For example,
397 * when all of a #GtkCList can not be seen.
398 * @GTK_POLICY_NEVER: The scrollbar will never appear.
400 * Determines when a scroll bar will be visible.
405 GTK_POLICY_AUTOMATIC,
411 * @GTK_POS_LEFT: The feature is at the left edge.
412 * @GTK_POS_RIGHT: The feature is at the right edge.
413 * @GTK_POS_TOP: The feature is at the top edge.
414 * @GTK_POS_BOTTOM: The feature is at the bottom edge.
416 * Describes which edge of a widget a certain feature is positioned at, e.g. the
417 * tabs of a #GtkNotebook, the handle of a #GtkHandleBox or the label of a
430 * @GTK_RELIEF_NORMAL: Draw a normal relief.
431 * @GTK_RELIEF_HALF: A half relief.
432 * @GTK_RELIEF_NONE: No relief.
434 * Indicated the relief to be drawn around a #GtkButton.
445 * @GTK_RESIZE_PARENT: Pass resize request to the parent
446 * @GTK_RESIZE_QUEUE: Queue resizes on this widget
447 * @GTK_RESIZE_IMMEDIATE: Resize immediately. Deprecated.
456 /* scrolling types */
461 GTK_SCROLL_STEP_BACKWARD,
462 GTK_SCROLL_STEP_FORWARD,
463 GTK_SCROLL_PAGE_BACKWARD,
464 GTK_SCROLL_PAGE_FORWARD,
466 GTK_SCROLL_STEP_DOWN,
468 GTK_SCROLL_PAGE_DOWN,
469 GTK_SCROLL_STEP_LEFT,
470 GTK_SCROLL_STEP_RIGHT,
471 GTK_SCROLL_PAGE_LEFT,
472 GTK_SCROLL_PAGE_RIGHT,
479 * @GTK_SELECTION_NONE: No selection is possible.
480 * @GTK_SELECTION_SINGLE: Zero or one element may be selected.
481 * @GTK_SELECTION_BROWSE: Exactly one element is selected.
482 * In some circumstances, such as initially or during a search
483 * operation, it's possible for no element to be selected with
484 * %GTK_SELECTION_BROWSE. What is really enforced is that the user
485 * can't deselect a currently selected element except by selecting
487 * @GTK_SELECTION_MULTIPLE: Any number of elements may be selected.
488 * The Ctrl key may be used to enlarge the selection, and Shift
489 * key to select between the focus and the child pointed to.
490 * Some widgets may also allow Click-drag to select a range of elements.
491 * @GTK_SELECTION_EXTENDED: Deprecated, behaves identical to %GTK_SELECTION_MULTIPLE.
493 * Used to control what selections users are allowed to make.
498 GTK_SELECTION_SINGLE,
499 GTK_SELECTION_BROWSE,
500 GTK_SELECTION_MULTIPLE
505 * @GTK_SHADOW_NONE: No outline.
506 * @GTK_SHADOW_IN: The outline is bevelled inwards.
507 * @GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
508 * @GTK_SHADOW_ETCHED_IN: The outline has a sunken 3d appearance.
509 * @GTK_SHADOW_ETCHED_OUT: The outline has a raised 3d appearance.
511 * Used to change the appearance of an outline typically provided by a #GtkFrame.
518 GTK_SHADOW_ETCHED_IN,
519 GTK_SHADOW_ETCHED_OUT
526 * @GTK_STATE_NORMAL: State during normal operation.
527 * @GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button.
528 * @GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over
529 * the widget and the widget will respond to mouse clicks.
530 * @GTK_STATE_SELECTED: State of a selected item, such the selected row in a list.
531 * @GTK_STATE_INSENSITIVE: State indicating that the widget is
532 * unresponsive to user actions.
533 * @GTK_STATE_INCONSISTENT: The widget is inconsistent, such as checkbuttons
534 * or radiobuttons that aren't either set to %TRUE nor %FALSE,
535 * or buttons requiring the user attention.
536 * @GTK_STATE_FOCUSED: The widget has the keyboard focus.
538 * This type indicates the current state of a widget; the state determines how
539 * the widget is drawn. The #GtkStateType enumeration is also used to
540 * identify different colors in a #GtkStyle for drawing, so states can be
541 * used for subparts of a widget as well as entire widgets.
549 GTK_STATE_INSENSITIVE,
550 GTK_STATE_INCONSISTENT,
556 * @GTK_TOOLBAR_ICONS: Buttons display only icons in the toolbar.
557 * @GTK_TOOLBAR_TEXT: Buttons display only text labels in the toolbar.
558 * @GTK_TOOLBAR_BOTH: Buttons display text and icons in the toolbar.
559 * @GTK_TOOLBAR_BOTH_HORIZ: Buttons display icons and text alongside each
560 * other, rather than vertically stacked
562 * Used to customize the appearance of a #GtkToolbar. Note that
563 * setting the toolbar style overrides the user's preferences
564 * for the default toolbar style. Note that if the button has only
565 * a label set and GTK_TOOLBAR_ICONS is used, the label will be
566 * visible, and vice versa.
573 GTK_TOOLBAR_BOTH_HORIZ
578 * @GTK_WIN_POS_NONE: No influence is made on placement.
579 * @GTK_WIN_POS_CENTER: Windows should be placed in the center of the screen.
580 * @GTK_WIN_POS_MOUSE: Windows should be placed at the current mouse position.
581 * @GTK_WIN_POS_CENTER_ALWAYS: Keep window centered as it changes size, etc.
582 * @GTK_WIN_POS_CENTER_ON_PARENT: Center the window on its transient
583 * parent (see gtk_window_set_transient_for()).
585 * Window placement can be influenced using this enumeration. Note that
586 * using #GTK_WIN_POS_CENTER_ALWAYS is almost always a bad idea.
587 * It won't necessarily work well with all window managers or on all windowing systems.
594 GTK_WIN_POS_CENTER_ALWAYS,
595 GTK_WIN_POS_CENTER_ON_PARENT
600 * @GTK_WINDOW_TOPLEVEL: A regular window, such as a dialog.
601 * @GTK_WINDOW_POPUP: A special window such as a tooltip.
603 * A #GtkWindow can be one of these types. Most things you'd consider a
604 * "window" should have type #GTK_WINDOW_TOPLEVEL; windows with this type
605 * are managed by the window manager and have a frame by default (call
606 * gtk_window_set_decorated() to toggle the frame). Windows with type
607 * #GTK_WINDOW_POPUP are ignored by the window manager; window manager
608 * keybindings won't work on them, the window manager won't decorate the
609 * window with a frame, many GTK+ features that rely on the window
610 * manager will not work (e.g. resize grips and
611 * maximization/minimization). #GTK_WINDOW_POPUP is used to implement
612 * widgets such as #GtkMenu or tooltips that you normally don't think of
613 * as windows per se. Nearly all windows should be #GTK_WINDOW_TOPLEVEL.
614 * In particular, do not use #GTK_WINDOW_POPUP just to turn off
615 * the window borders; use gtk_window_set_decorated() for that.
625 * @GTK_WRAP_NONE: do not wrap lines; just make the text area wider
626 * @GTK_WRAP_CHAR: wrap text, breaking lines anywhere the cursor can
627 * appear (between characters, usually - if you want to be technical,
628 * between graphemes, see pango_get_log_attrs())
629 * @GTK_WRAP_WORD: wrap text, breaking lines in between words
630 * @GTK_WRAP_WORD_CHAR: wrap text, breaking lines in between words, or if
631 * that is not enough, also between graphemes
633 * Describes a type of line wrapping.
645 * @GTK_SORT_ASCENDING: Sorting is in ascending order.
646 * @GTK_SORT_DESCENDING: Sorting is in descending order.
648 * Determines the direction of a sort.
656 /* Style for gtk input method preedit/status */
659 GTK_IM_PREEDIT_NOTHING,
660 GTK_IM_PREEDIT_CALLBACK,
666 GTK_IM_STATUS_NOTHING,
667 GTK_IM_STATUS_CALLBACK,
673 * @GTK_PACK_DIRECTION_LTR: Widgets are packed left-to-right
674 * @GTK_PACK_DIRECTION_RTL: Widgets are packed right-to-left
675 * @GTK_PACK_DIRECTION_TTB: Widgets are packed top-to-bottom
676 * @GTK_PACK_DIRECTION_BTT: Widgets are packed bottom-to-top
678 * Determines how widgets should be packed insided menubars
679 * and menuitems contained in menubars.
683 GTK_PACK_DIRECTION_LTR,
684 GTK_PACK_DIRECTION_RTL,
685 GTK_PACK_DIRECTION_TTB,
686 GTK_PACK_DIRECTION_BTT
692 GTK_PRINT_PAGES_CURRENT,
693 GTK_PRINT_PAGES_RANGES,
694 GTK_PRINT_PAGES_SELECTION
706 * @GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM: <inlinegraphic valign="middle" fileref="layout-lrtb.png" format="PNG"></inlinegraphic>
707 * @GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP: <inlinegraphic valign="middle" fileref="layout-lrbt.png" format="PNG"></inlinegraphic>
708 * @GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM: <inlinegraphic valign="middle" fileref="layout-rltb.png" format="PNG"></inlinegraphic>
709 * @GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP: <inlinegraphic valign="middle" fileref="layout-rlbt.png" format="PNG"></inlinegraphic>
710 * @GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT: <inlinegraphic valign="middle" fileref="layout-tblr.png" format="PNG"></inlinegraphic>
711 * @GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT: <inlinegraphic valign="middle" fileref="layout-tbrl.png" format="PNG"></inlinegraphic>
712 * @GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT: <inlinegraphic valign="middle" fileref="layout-btlr.png" format="PNG"></inlinegraphic>
713 * @GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT: <inlinegraphic valign="middle" fileref="layout-btrl.png" format="PNG"></inlinegraphic>
715 * Used to determine the layout of pages on a sheet when printing
716 * multiple pages per sheet.
720 GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM, /*< nick=lrtb >*/
721 GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP, /*< nick=lrbt >*/
722 GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM, /*< nick=rltb >*/
723 GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP, /*< nick=rlbt >*/
724 GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT, /*< nick=tblr >*/
725 GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT, /*< nick=tbrl >*/
726 GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT, /*< nick=btlr >*/
727 GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT /*< nick=btrl >*/
732 GTK_PAGE_ORIENTATION_PORTRAIT,
733 GTK_PAGE_ORIENTATION_LANDSCAPE,
734 GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT,
735 GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE
736 } GtkPageOrientation;
740 GTK_PRINT_QUALITY_LOW,
741 GTK_PRINT_QUALITY_NORMAL,
742 GTK_PRINT_QUALITY_HIGH,
743 GTK_PRINT_QUALITY_DRAFT
748 GTK_PRINT_DUPLEX_SIMPLEX,
749 GTK_PRINT_DUPLEX_HORIZONTAL,
750 GTK_PRINT_DUPLEX_VERTICAL
762 #define GTK_UNIT_PIXEL GTK_UNIT_NONE
765 * GtkTreeViewGridLines:
766 * @GTK_TREE_VIEW_GRID_LINES_NONE: No grid lines.
767 * @GTK_TREE_VIEW_GRID_LINES_HORIZONTAL: Horizontal grid lines.
768 * @GTK_TREE_VIEW_GRID_LINES_VERTICAL: Vertical grid lines.
769 * @GTK_TREE_VIEW_GRID_LINES_BOTH: Horizontal and vertical grid lines.
771 * Used to indicate which grid lines to draw in a tree view.
775 GTK_TREE_VIEW_GRID_LINES_NONE,
776 GTK_TREE_VIEW_GRID_LINES_HORIZONTAL,
777 GTK_TREE_VIEW_GRID_LINES_VERTICAL,
778 GTK_TREE_VIEW_GRID_LINES_BOTH
779 } GtkTreeViewGridLines;
783 * @GTK_DRAG_RESULT_SUCCESS: The drag operation was successful.
784 * @GTK_DRAG_RESULT_NO_TARGET: No suitable drag target.
785 * @GTK_DRAG_RESULT_USER_CANCELLED: The user cancelled the drag operation.
786 * @GTK_DRAG_RESULT_TIMEOUT_EXPIRED: The drag operation timed out.
787 * @GTK_DRAG_RESULT_GRAB_BROKEN: The pointer or keyboard grab used
788 * for the drag operation was broken.
789 * @GTK_DRAG_RESULT_ERROR: The drag operation failed due to some
792 * Gives an indication why a drag operation failed.
793 * The value can by obtained by connecting to the
794 * #GtkWidget::drag-failed signal.
798 GTK_DRAG_RESULT_SUCCESS,
799 GTK_DRAG_RESULT_NO_TARGET,
800 GTK_DRAG_RESULT_USER_CANCELLED,
801 GTK_DRAG_RESULT_TIMEOUT_EXPIRED,
802 GTK_DRAG_RESULT_GRAB_BROKEN,
803 GTK_DRAG_RESULT_ERROR
808 * @GTK_SIZE_GROUP_NONE: group has no effect
809 * @GTK_SIZE_GROUP_HORIZONTAL: group affects horizontal requisition
810 * @GTK_SIZE_GROUP_VERTICAL: group affects vertical requisition
811 * @GTK_SIZE_GROUP_BOTH: group affects both horizontal and vertical requisition
813 * The mode of the size group determines the directions in which the size
814 * group affects the requested sizes of its component widgets.
818 GTK_SIZE_GROUP_HORIZONTAL,
819 GTK_SIZE_GROUP_VERTICAL,
824 * GtkSizeRequestMode:
825 * @GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH: Prefer height-for-width geometry management
826 * @GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT: Prefer width-for-height geometry management
827 * @GTK_SIZE_REQUEST_CONSTANT_SIZE: Dont trade height-for-width or width-for-height
829 * Specifies a preference for height-for-width or
830 * width-for-height geometry management.
834 GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH = 0,
835 GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT,
836 GTK_SIZE_REQUEST_CONSTANT_SIZE
837 } GtkSizeRequestMode;
840 * GtkScrollablePolicy:
841 * @GTK_SCROLL_MINIMUM: Scrollable adjustments are based on the minimum size
842 * @GTK_SCROLL_NATURAL: Scrollable adjustments are based on the natural size
844 * Defines the policy to be used in a scrollable widget when updating
845 * the scrolled window adjustments in a given orientation.
849 GTK_SCROLL_MINIMUM = 0,
851 } GtkScrollablePolicy;
855 * @GTK_STATE_FLAG_NORMAL: State during normal operation.
856 * @GTK_STATE_FLAG_ACTIVE: Widget is active.
857 * @GTK_STATE_FLAG_PRELIGHT: Widget has a mouse pointer over it.
858 * @GTK_STATE_FLAG_SELECTED: Widget is selected.
859 * @GTK_STATE_FLAG_INSENSITIVE: Widget is insensitive.
860 * @GTK_STATE_FLAG_INCONSISTENT: Widget is inconsistent.
861 * @GTK_STATE_FLAG_FOCUSED: Widget has the keyboard focus.
862 * @GTK_STATE_FLAG_BACKDROP: Widget is in a background toplevel window.
863 * @GTK_STATE_FLAG_DIR_LTR: Widget is in left-to-right text direction. Since 3.8
864 * @GTK_STATE_FLAG_DIR_RTL: Widget is in right-to-left text direction. Since 3.8
866 * Describes a widget state. Widget states are used to match the widget
867 * against CSS pseudo-classes. Note that GTK extends the regular CSS
868 * classes and sometimes uses different names.
872 GTK_STATE_FLAG_NORMAL = 0,
873 GTK_STATE_FLAG_ACTIVE = 1 << 0,
874 GTK_STATE_FLAG_PRELIGHT = 1 << 1,
875 GTK_STATE_FLAG_SELECTED = 1 << 2,
876 GTK_STATE_FLAG_INSENSITIVE = 1 << 3,
877 GTK_STATE_FLAG_INCONSISTENT = 1 << 4,
878 GTK_STATE_FLAG_FOCUSED = 1 << 5,
879 GTK_STATE_FLAG_BACKDROP = 1 << 6,
880 GTK_STATE_FLAG_DIR_LTR = 1 << 7,
881 GTK_STATE_FLAG_DIR_RTL = 1 << 8
886 * @GTK_REGION_EVEN: Region has an even number within a set.
887 * @GTK_REGION_ODD: Region has an odd number within a set.
888 * @GTK_REGION_FIRST: Region is the first one within a set.
889 * @GTK_REGION_LAST: Region is the last one within a set.
890 * @GTK_REGION_ONLY: Region is the only one within a set.
891 * @GTK_REGION_SORTED: Region is part of a sorted area.
893 * Describes a region within a widget.
896 GTK_REGION_EVEN = 1 << 0,
897 GTK_REGION_ODD = 1 << 1,
898 GTK_REGION_FIRST = 1 << 2,
899 GTK_REGION_LAST = 1 << 3,
900 GTK_REGION_ONLY = 1 << 4,
901 GTK_REGION_SORTED = 1 << 5
906 * @GTK_JUNCTION_NONE: No junctions.
907 * @GTK_JUNCTION_CORNER_TOPLEFT: Element connects on the top-left corner.
908 * @GTK_JUNCTION_CORNER_TOPRIGHT: Element connects on the top-right corner.
909 * @GTK_JUNCTION_CORNER_BOTTOMLEFT: Element connects on the bottom-left corner.
910 * @GTK_JUNCTION_CORNER_BOTTOMRIGHT: Element connects on the bottom-right corner.
911 * @GTK_JUNCTION_TOP: Element connects on the top side.
912 * @GTK_JUNCTION_BOTTOM: Element connects on the bottom side.
913 * @GTK_JUNCTION_LEFT: Element connects on the left side.
914 * @GTK_JUNCTION_RIGHT: Element connects on the right side.
916 * Describes how a rendered element connects to adjacent elements.
919 GTK_JUNCTION_NONE = 0,
920 GTK_JUNCTION_CORNER_TOPLEFT = 1 << 0,
921 GTK_JUNCTION_CORNER_TOPRIGHT = 1 << 1,
922 GTK_JUNCTION_CORNER_BOTTOMLEFT = 1 << 2,
923 GTK_JUNCTION_CORNER_BOTTOMRIGHT = 1 << 3,
924 GTK_JUNCTION_TOP = (GTK_JUNCTION_CORNER_TOPLEFT | GTK_JUNCTION_CORNER_TOPRIGHT),
925 GTK_JUNCTION_BOTTOM = (GTK_JUNCTION_CORNER_BOTTOMLEFT | GTK_JUNCTION_CORNER_BOTTOMRIGHT),
926 GTK_JUNCTION_LEFT = (GTK_JUNCTION_CORNER_TOPLEFT | GTK_JUNCTION_CORNER_BOTTOMLEFT),
927 GTK_JUNCTION_RIGHT = (GTK_JUNCTION_CORNER_TOPRIGHT | GTK_JUNCTION_CORNER_BOTTOMRIGHT)
932 * @GTK_BORDER_STYLE_NONE: No visible border
933 * @GTK_BORDER_STYLE_SOLID: A single line segment
934 * @GTK_BORDER_STYLE_INSET: Looks as if the content is sunken into the canvas
935 * @GTK_BORDER_STYLE_OUTSET: Looks as if the content is coming out of the canvas
936 * @GTK_BORDER_STYLE_HIDDEN: Same as @GTK_BORDER_STYLE_NONE
937 * @GTK_BORDER_STYLE_DOTTED: A series of round dots
938 * @GTK_BORDER_STYLE_DASHED: A series of square-ended dashes
939 * @GTK_BORDER_STYLE_DOUBLE: Two parrallel lines with some space between them
940 * @GTK_BORDER_STYLE_GROOVE: Looks as if it were carved in the canvas
941 * @GTK_BORDER_STYLE_RIDGE: Looks as if it were coming out of the canvas
943 * Describes how the border of a UI element should be rendered.
946 GTK_BORDER_STYLE_NONE,
947 GTK_BORDER_STYLE_SOLID,
948 GTK_BORDER_STYLE_INSET,
949 GTK_BORDER_STYLE_OUTSET,
950 GTK_BORDER_STYLE_HIDDEN,
951 GTK_BORDER_STYLE_DOTTED,
952 GTK_BORDER_STYLE_DASHED,
953 GTK_BORDER_STYLE_DOUBLE,
954 GTK_BORDER_STYLE_GROOVE,
955 GTK_BORDER_STYLE_RIDGE
960 * @GTK_LEVEL_BAR_MODE_CONTINUOUS: the bar has a continuous mode
961 * @GTK_LEVEL_BAR_MODE_DISCRETE: the bar has a discrete mode
963 * Describes how #GtkLevelBar contents should be rendered.
964 * Note that this enumeration could be extended with additional modes
970 GTK_LEVEL_BAR_MODE_CONTINUOUS,
971 GTK_LEVEL_BAR_MODE_DISCRETE
978 * @GTK_INPUT_PURPOSE_FREE_FORM: Allow any character
979 * @GTK_INPUT_PURPOSE_ALPHA: Allow only alphabetic characters
980 * @GTK_INPUT_PURPOSE_DIGITS: Allow only digits
981 * @GTK_INPUT_PURPOSE_NUMBER: Edited field expects numbers
982 * @GTK_INPUT_PURPOSE_PHONE: Edited field expects phone number
983 * @GTK_INPUT_PURPOSE_URL: Edited field expects URL
984 * @GTK_INPUT_PURPOSE_EMAIL: Edited field expects email address
985 * @GTK_INPUT_PURPOSE_NAME: Edited field expects the name of a person
986 * @GTK_INPUT_PURPOSE_PASSWORD: Like @GTK_INPUT_PURPOSE_FREE_FORM, but characters are hidden
987 * @GTK_INPUT_PURPOSE_PIN: Like @GTK_INPUT_PURPOSE_DIGITS, but characters are hidden
989 * Describes primary purpose of the input widget. This information is
990 * useful for on-screen keyboards and similar input methods to decide
991 * which keys should be presented to the user.
993 * Note that the purpose is not meant to impose a totally strict rule
994 * about allowed characters, and does not replace input validation.
995 * It is fine for an on-screen keyboard to let the user override the
996 * character set restriction that is expressed by the purpose. The
997 * application is expected to validate the entry contents, even if
998 * it specified a purpose.
1000 * The difference between @GTK_INPUT_PURPOSE_DIGITS and
1001 * @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits
1002 * while the latter also some punctuation (like commas or points, plus,
1003 * minus) and 'e' or 'E' as in 3.14E+000.
1005 * This enumeration may be extended in the future; input methods should
1006 * interpret unknown values as 'free form'.
1012 GTK_INPUT_PURPOSE_FREE_FORM,
1013 GTK_INPUT_PURPOSE_ALPHA,
1014 GTK_INPUT_PURPOSE_DIGITS,
1015 GTK_INPUT_PURPOSE_NUMBER,
1016 GTK_INPUT_PURPOSE_PHONE,
1017 GTK_INPUT_PURPOSE_URL,
1018 GTK_INPUT_PURPOSE_EMAIL,
1019 GTK_INPUT_PURPOSE_NAME,
1020 GTK_INPUT_PURPOSE_PASSWORD,
1021 GTK_INPUT_PURPOSE_PIN
1026 * @GTK_INPUT_HINT_NONE: No special behaviour suggested
1027 * @GTK_INPUT_HINT_SPELLCHECK: Suggest checking for typos
1028 * @GTK_INPUT_HINT_NO_SPELLCHECK: Suggest not checking for typos
1029 * @GTK_INPUT_HINT_WORD_COMPLETION: Suggest word completion
1030 * @GTK_INPUT_HINT_LOWERCASE: Suggest to convert all text to lowercase
1031 * @GTK_INPUT_HINT_UPPERCASE_CHARS: Suggest to capitalize all text
1032 * @GTK_INPUT_HINT_UPPERCASE_WORDS: Suggest to capitalize the first
1033 * character of each word
1034 * @GTK_INPUT_HINT_UPPERCASE_SENTENCES: Suggest to capitalize the
1035 * first word of each sentence
1036 * @GTK_INPUT_HINT_INHIBIT_OSK: Suggest to not show an onscreen keyboard
1037 * (e.g for a calculator that already has all the keys).
1039 * Describes hints that might be taken into account by input methods
1040 * or applications. Note that input methods may already tailor their
1041 * behaviour according to the #GtkInputPurpose of the entry.
1043 * Some common sense is expected when using these flags - mixing
1044 * @GTK_INPUT_HINT_LOWERCASE with any of the uppercase hints makes no sense.
1046 * This enumeration may be extended in the future; input methods should
1047 * ignore unknown values.
1053 GTK_INPUT_HINT_NONE = 0,
1054 GTK_INPUT_HINT_SPELLCHECK = 1 << 0,
1055 GTK_INPUT_HINT_NO_SPELLCHECK = 1 << 1,
1056 GTK_INPUT_HINT_WORD_COMPLETION = 1 << 2,
1057 GTK_INPUT_HINT_LOWERCASE = 1 << 3,
1058 GTK_INPUT_HINT_UPPERCASE_CHARS = 1 << 4,
1059 GTK_INPUT_HINT_UPPERCASE_WORDS = 1 << 5,
1060 GTK_INPUT_HINT_UPPERCASE_SENTENCES = 1 << 6,
1061 GTK_INPUT_HINT_INHIBIT_OSK = 1 << 7
1064 #endif /* __GTK_ENUMS_H__ */