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, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
27 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
28 #error "Only <gtk/gtk.h> can be included directly."
31 #ifndef __GTK_ENUMS_H__
32 #define __GTK_ENUMS_H__
34 #include <glib-object.h>
40 * @GTK_ALIGN_FILL: stretch to fill all space if possible, center if
41 * no meaningful way to stretch
42 * @GTK_ALIGN_START: snap to left or top side, leaving space on right
44 * @GTK_ALIGN_END: snap to right or bottom side, leaving space on left
46 * @GTK_ALIGN_CENTER: center natural width of widget inside the
49 * Controls how a widget deals with extra space in a single (x or y)
52 * Alignment only matters if the widget receives a "too large" allocation,
53 * for example if you packed the widget with the #GtkWidget:expand
54 * flag inside a #GtkBox, then the widget might get extra space. If
55 * you have for example a 16x16 icon inside a 32x32 space, the icon
56 * could be scaled and stretched, it could be centered, or it could be
57 * positioned to one side of the space.
85 /* Attach options (for tables) */
93 /* Button box styles */
96 GTK_BUTTONBOX_SPREAD = 1,
106 GTK_DELETE_WORD_ENDS, /* delete only the portion of the word to the
107 * left/right of cursor if we're in the middle
110 GTK_DELETE_DISPLAY_LINES,
111 GTK_DELETE_DISPLAY_LINE_ENDS,
112 GTK_DELETE_PARAGRAPH_ENDS, /* like C-k in Emacs (or its reverse) */
113 GTK_DELETE_PARAGRAPHS, /* C-k in pico, kill whole line */
114 GTK_DELETE_WHITESPACE /* M-\ in Emacs */
117 /* Focus movement types */
121 GTK_DIR_TAB_BACKWARD,
128 /* Expander styles */
131 GTK_EXPANDER_COLLAPSED,
132 GTK_EXPANDER_SEMI_COLLAPSED,
133 GTK_EXPANDER_SEMI_EXPANDED,
134 GTK_EXPANDER_EXPANDED
137 /* Built-in stock icon sizes */
140 GTK_ICON_SIZE_INVALID,
142 GTK_ICON_SIZE_SMALL_TOOLBAR,
143 GTK_ICON_SIZE_LARGE_TOOLBAR,
144 GTK_ICON_SIZE_BUTTON,
150 * GtkSensitivityType:
151 * @GTK_SENSITIVITY_AUTO: The arrow is made insensitive if the
152 * thumb is at the end
153 * @GTK_SENSITIVITY_ON: The arrow is always sensitive
154 * @GTK_SENSITIVITY_OFF: The arrow is always insensitive
156 * Determines how GTK+ handles the sensitivity of stepper arrows
157 * at the end of range widgets.
161 GTK_SENSITIVITY_AUTO,
164 } GtkSensitivityType;
166 /* Reading directions for text */
174 /* justification for label and maybe other widgets (text?) */
183 /* Menu keyboard movement types */
190 } GtkMenuDirectionType;
194 * @GTK_MESSAGE_INFO: Informational message
195 * @GTK_MESSAGE_WARNING: Nonfatal warning message
196 * @GTK_MESSAGE_QUESTION: Question requiring a choice
197 * @GTK_MESSAGE_ERROR: Fatal error message
198 * @GTK_MESSAGE_OTHER: None of the above, doesn't get an icon
200 * The type of message being displayed in the dialog.
206 GTK_MESSAGE_QUESTION,
213 * @GTK_MOVEMENT_LOGICAL_POSITIONS: Move forward or back by graphemes
214 * @GTK_MOVEMENT_VISUAL_POSITIONS: Move left or right by graphemes
215 * @GTK_MOVEMENT_WORDS: Move forward or back by words
216 * @GTK_MOVEMENT_DISPLAY_LINES: Move up or down lines (wrapped lines)
217 * @GTK_MOVEMENT_DISPLAY_LINE_ENDS: Move to either end of a line
218 * @GTK_MOVEMENT_PARAGRAPHS: Move up or down paragraphs (newline-ended lines)
219 * @GTK_MOVEMENT_PARAGRAPH_ENDS: Move to either end of a paragraph
220 * @GTK_MOVEMENT_PAGES: Move by pages
221 * @GTK_MOVEMENT_BUFFER_ENDS: Move to ends of the buffer
222 * @GTK_MOVEMENT_HORIZONTAL_PAGES: Move horizontally by pages
226 GTK_MOVEMENT_LOGICAL_POSITIONS,
227 GTK_MOVEMENT_VISUAL_POSITIONS,
229 GTK_MOVEMENT_DISPLAY_LINES,
230 GTK_MOVEMENT_DISPLAY_LINE_ENDS,
231 GTK_MOVEMENT_PARAGRAPHS,
232 GTK_MOVEMENT_PARAGRAPH_ENDS,
234 GTK_MOVEMENT_BUFFER_ENDS,
235 GTK_MOVEMENT_HORIZONTAL_PAGES
243 GTK_SCROLL_HORIZONTAL_STEPS,
244 GTK_SCROLL_HORIZONTAL_PAGES,
245 GTK_SCROLL_HORIZONTAL_ENDS
248 /* Orientation for toolbars, etc. */
251 GTK_ORIENTATION_HORIZONTAL,
252 GTK_ORIENTATION_VERTICAL
255 /* Placement type for scrolled window */
259 GTK_CORNER_BOTTOM_LEFT,
260 GTK_CORNER_TOP_RIGHT,
261 GTK_CORNER_BOTTOM_RIGHT
264 /* Packing types (for boxes) */
271 /* priorities for path lookups */
274 GTK_PATH_PRIO_LOWEST = 0,
275 GTK_PATH_PRIO_GTK = 4,
276 GTK_PATH_PRIO_APPLICATION = 8,
277 GTK_PATH_PRIO_THEME = 10,
278 GTK_PATH_PRIO_RC = 12,
279 GTK_PATH_PRIO_HIGHEST = 15
280 } GtkPathPriorityType;
281 #define GTK_PATH_PRIO_MASK 0x0f
283 /* widget path types */
287 GTK_PATH_WIDGET_CLASS,
291 /* Scrollbar policy types (for scrolled windows) */
295 GTK_POLICY_AUTOMATIC,
307 /* Style for buttons */
318 GTK_RESIZE_PARENT, /* Pass resize request to the parent */
319 GTK_RESIZE_QUEUE, /* Queue resizes on this widget */
320 GTK_RESIZE_IMMEDIATE /* Perform the resizes now */
323 /* scrolling types */
328 GTK_SCROLL_STEP_BACKWARD,
329 GTK_SCROLL_STEP_FORWARD,
330 GTK_SCROLL_PAGE_BACKWARD,
331 GTK_SCROLL_PAGE_FORWARD,
333 GTK_SCROLL_STEP_DOWN,
335 GTK_SCROLL_PAGE_DOWN,
336 GTK_SCROLL_STEP_LEFT,
337 GTK_SCROLL_STEP_RIGHT,
338 GTK_SCROLL_PAGE_LEFT,
339 GTK_SCROLL_PAGE_RIGHT,
344 /* list selection modes */
347 GTK_SELECTION_NONE, /* Nothing can be selected */
348 GTK_SELECTION_SINGLE,
349 GTK_SELECTION_BROWSE,
350 GTK_SELECTION_MULTIPLE
359 GTK_SHADOW_ETCHED_IN,
360 GTK_SHADOW_ETCHED_OUT
368 * This type indicates the current state of a widget; the state determines how
369 * the widget is drawn. The #GtkStateType enumeration is also used to
370 * identify different colors in a #GtkStyle for drawing, so states can be
371 * used for subparts of a widget as well as entire widgets.
373 * @GTK_STATE_NORMAL: State during normal operation.
374 * @GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button.
375 * @GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over
376 * the widget and the widget will respond to mouse clicks.
377 * @GTK_STATE_SELECTED: State of a selected item, such the selected row in a list.
378 * @GTK_STATE_INSENSITIVE: State indicating that the widget is
379 * unresponsive to user actions.
380 * @GTK_STATE_INCONSISTENT: The widget is inconsistent, such as checkbuttons
381 * or radiobuttons that aren't either set to %TRUE nor %FALSE,
382 * or buttons requiring the user attention.
383 * @GTK_STATE_FOCUSED: The widget has the keyboard focus.
391 GTK_STATE_INSENSITIVE,
392 GTK_STATE_INCONSISTENT,
396 /* Style for toolbars */
402 GTK_TOOLBAR_BOTH_HORIZ
405 /* Data update types (for ranges) */
408 GTK_UPDATE_CONTINUOUS,
409 GTK_UPDATE_DISCONTINUOUS,
413 /* Window position types */
419 GTK_WIN_POS_CENTER_ALWAYS,
420 GTK_WIN_POS_CENTER_ON_PARENT
446 /* Style for gtk input method preedit/status */
449 GTK_IM_PREEDIT_NOTHING,
450 GTK_IM_PREEDIT_CALLBACK,
456 GTK_IM_STATUS_NOTHING,
457 GTK_IM_STATUS_CALLBACK,
463 GTK_PACK_DIRECTION_LTR,
464 GTK_PACK_DIRECTION_RTL,
465 GTK_PACK_DIRECTION_TTB,
466 GTK_PACK_DIRECTION_BTT
472 GTK_PRINT_PAGES_CURRENT,
473 GTK_PRINT_PAGES_RANGES,
474 GTK_PRINT_PAGES_SELECTION
486 GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM, /*< nick=lrtb >*/
487 GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP, /*< nick=lrbt >*/
488 GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM, /*< nick=rltb >*/
489 GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP, /*< nick=rlbt >*/
490 GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT, /*< nick=tblr >*/
491 GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT, /*< nick=tbrl >*/
492 GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT, /*< nick=btlr >*/
493 GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT /*< nick=btrl >*/
498 GTK_PAGE_ORIENTATION_PORTRAIT,
499 GTK_PAGE_ORIENTATION_LANDSCAPE,
500 GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT,
501 GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE
502 } GtkPageOrientation;
506 GTK_PRINT_QUALITY_LOW,
507 GTK_PRINT_QUALITY_NORMAL,
508 GTK_PRINT_QUALITY_HIGH,
509 GTK_PRINT_QUALITY_DRAFT
514 GTK_PRINT_DUPLEX_SIMPLEX,
515 GTK_PRINT_DUPLEX_HORIZONTAL,
516 GTK_PRINT_DUPLEX_VERTICAL
529 * GtkTreeViewGridLines:
530 * @GTK_TREE_VIEW_GRID_LINES_NONE: No grid lines.
531 * @GTK_TREE_VIEW_GRID_LINES_HORIZONTAL: Horizontal grid lines.
532 * @GTK_TREE_VIEW_GRID_LINES_VERTICAL: Vertical grid lines.
533 * @GTK_TREE_VIEW_GRID_LINES_BOTH: Horizontal and vertical grid lines.
535 * Used to indicate which grid lines to draw in a tree view.
539 GTK_TREE_VIEW_GRID_LINES_NONE,
540 GTK_TREE_VIEW_GRID_LINES_HORIZONTAL,
541 GTK_TREE_VIEW_GRID_LINES_VERTICAL,
542 GTK_TREE_VIEW_GRID_LINES_BOTH
543 } GtkTreeViewGridLines;
547 GTK_DRAG_RESULT_SUCCESS,
548 GTK_DRAG_RESULT_NO_TARGET,
549 GTK_DRAG_RESULT_USER_CANCELLED,
550 GTK_DRAG_RESULT_TIMEOUT_EXPIRED,
551 GTK_DRAG_RESULT_GRAB_BROKEN,
552 GTK_DRAG_RESULT_ERROR
556 * GtkSizeRequestMode:
557 * @GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH: Prefer height-for-width geometry management
558 * @GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT: Prefer width-for-height geometry management
560 * Specifies a preference for height-for-width or
561 * width-for-height geometry management.
565 GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH = 0,
566 GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT
567 } GtkSizeRequestMode;
570 * GtkScrollablePolicy:
571 * @GTK_SCROLL_MINIMUM: Scrollable adjustments are based on the minimum size
572 * @GTK_SCROLL_NATURAL: Scrollable adjustments are based on the natural size
574 * Defines the policy to be used in a scrollable widget when updating
575 * the scrolled window adjustments in a given orientation.
579 GTK_SCROLL_MINIMUM = 0,
581 } GtkScrollablePolicy;
585 * @GTK_STATE_FLAG_ACTIVE: Widget is active.
586 * @GTK_STATE_FLAG_PRELIGHT: Widget has a mouse pointer over it.
587 * @GTK_STATE_FLAG_SELECTED: Widget is selected.
588 * @GTK_STATE_FLAG_INSENSITIVE: Widget is insensitive.
589 * @GTK_STATE_FLAG_INCONSISTENT: Widget is inconsistent.
590 * @GTK_STATE_FLAG_FOCUSED: Widget has the keyboard focus.
592 * Describes a widget state.
596 GTK_STATE_FLAG_ACTIVE = 1 << 0,
597 GTK_STATE_FLAG_PRELIGHT = 1 << 1,
598 GTK_STATE_FLAG_SELECTED = 1 << 2,
599 GTK_STATE_FLAG_INSENSITIVE = 1 << 3,
600 GTK_STATE_FLAG_INCONSISTENT = 1 << 4,
601 GTK_STATE_FLAG_FOCUSED = 1 << 5
606 * @GTK_REGION_EVEN: Region has an even number within a set.
607 * @GTK_REGION_ODD: Region has an odd number within a set.
608 * @GTK_REGION_FIRST: Region is the first one within a set.
609 * @GTK_REGION_LAST: Region is the last one within a set.
610 * @GTK_REGION_SORTED: Region is part of a sorted area.
612 * Describes a region within a widget.
615 GTK_REGION_EVEN = 1 << 0,
616 GTK_REGION_ODD = 1 << 1,
617 GTK_REGION_FIRST = 1 << 2,
618 GTK_REGION_LAST = 1 << 3,
619 GTK_REGION_SORTED = 1 << 5
624 * @GTK_JUNCTION_NONE: No junctions.
625 * @GTK_JUNCTION_CORNER_TOPLEFT: Element connects on the top-left corner.
626 * @GTK_JUNCTION_CORNER_TOPRIGHT: Element connects on the top-right corner.
627 * @GTK_JUNCTION_CORNER_BOTTOMLEFT: Element connects on the bottom-left corner.
628 * @GTK_JUNCTION_CORNER_BOTTOMRIGHT: Element connects on the bottom-right corner.
629 * @GTK_JUNCTION_TOP: Element connects on the top side.
630 * @GTK_JUNCTION_BOTTOM: Element connects on the bottom side.
631 * @GTK_JUNCTION_LEFT: Element connects on the left side.
632 * @GTK_JUNCTION_RIGHT: Element connects on the right side.
634 * Describes how a rendered element connects to adjacent elements.
637 GTK_JUNCTION_NONE = 0,
638 GTK_JUNCTION_CORNER_TOPLEFT = 1 << 0,
639 GTK_JUNCTION_CORNER_TOPRIGHT = 1 << 1,
640 GTK_JUNCTION_CORNER_BOTTOMLEFT = 1 << 2,
641 GTK_JUNCTION_CORNER_BOTTOMRIGHT = 1 << 3,
642 GTK_JUNCTION_TOP = (GTK_JUNCTION_CORNER_TOPLEFT | GTK_JUNCTION_CORNER_TOPRIGHT),
643 GTK_JUNCTION_BOTTOM = (GTK_JUNCTION_CORNER_BOTTOMLEFT | GTK_JUNCTION_CORNER_BOTTOMRIGHT),
644 GTK_JUNCTION_LEFT = (GTK_JUNCTION_CORNER_TOPLEFT | GTK_JUNCTION_CORNER_BOTTOMLEFT),
645 GTK_JUNCTION_RIGHT = (GTK_JUNCTION_CORNER_TOPRIGHT | GTK_JUNCTION_CORNER_BOTTOMRIGHT)
650 * @GTK_BORDER_STYLE_NONE: No visible border
651 * @GTK_BORDER_STYLE_SOLID: A solid border
652 * @GTK_BORDER_STYLE_INSET: An inset border
653 * @GTK_BORDER_STYLE_OUTSET: An outset border
655 * Describes how the border of a UI element should be rendered.
658 GTK_BORDER_STYLE_NONE,
659 GTK_BORDER_STYLE_SOLID,
660 GTK_BORDER_STYLE_INSET,
661 GTK_BORDER_STYLE_OUTSET
667 #endif /* __GTK_ENUMS_H__ */