1/* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
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.
8 *
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.
13 *
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/>.
16 */
17
18/*
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/.
23 */
24
25#ifndef __GTK_ENUMS_H__
26#define __GTK_ENUMS_H__
27
28#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
29#error "Only <gtk/gtk.h> can be included directly."
30#endif
31
32#include <glib-object.h>
33
34
35/**
36 * SECTION:gtkenums
37 * @Short_description: Public enumerated types used throughout GTK+
38 * @Title: Standard Enumerations
39 */
40
41
42G_BEGIN_DECLS
43
44/**
45 * GtkAlign:
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
49 * or bottom
50 * @GTK_ALIGN_END: snap to right or bottom side, leaving space on left
51 * or top
52 * @GTK_ALIGN_CENTER: center natural width of widget inside the
53 * allocation
54 * @GTK_ALIGN_BASELINE: align the widget according to the baseline. Since 3.10.
55 *
56 * Controls how a widget deals with extra space in a single (x or y)
57 * dimension.
58 *
59 * Alignment only matters if the widget receives a “too large” allocation,
60 * for example if you packed the widget with the #GtkWidget:expand
61 * flag inside a #GtkBox, then the widget might get extra space. If
62 * you have for example a 16x16 icon inside a 32x32 space, the icon
63 * could be scaled and stretched, it could be centered, or it could be
64 * positioned to one side of the space.
65 *
66 * Note that in horizontal context @GTK_ALIGN_START and @GTK_ALIGN_END
67 * are interpreted relative to text direction.
68 *
69 * GTK_ALIGN_BASELINE support for it is optional for containers and widgets, and
70 * it is only supported for vertical alignment. When its not supported by
71 * a child or a container it is treated as @GTK_ALIGN_FILL.
72 */
73typedef enum
74{
75 GTK_ALIGN_FILL,
76 GTK_ALIGN_START,
77 GTK_ALIGN_END,
78 GTK_ALIGN_CENTER,
79 GTK_ALIGN_BASELINE
80} GtkAlign;
81
82/**
83 * GtkArrowType:
84 * @GTK_ARROW_UP: Represents an upward pointing arrow.
85 * @GTK_ARROW_DOWN: Represents a downward pointing arrow.
86 * @GTK_ARROW_LEFT: Represents a left pointing arrow.
87 * @GTK_ARROW_RIGHT: Represents a right pointing arrow.
88 * @GTK_ARROW_NONE: No arrow. Since 2.10.
89 *
90 * Used to indicate the direction in which an arrow should point.
91 */
92typedef enum
93{
94 GTK_ARROW_UP,
95 GTK_ARROW_DOWN,
96 GTK_ARROW_LEFT,
97 GTK_ARROW_RIGHT,
98 GTK_ARROW_NONE
99} GtkArrowType;
100
101/**
102 * GtkBaselinePosition:
103 * @GTK_BASELINE_POSITION_TOP: Align the baseline at the top
104 * @GTK_BASELINE_POSITION_CENTER: Center the baseline
105 * @GTK_BASELINE_POSITION_BOTTOM: Align the baseline at the bottom
106 *
107 * Whenever a container has some form of natural row it may align
108 * children in that row along a common typographical baseline. If
109 * the amount of verical space in the row is taller than the total
110 * requested height of the baseline-aligned children then it can use a
111 * #GtkBaselinePosition to select where to put the baseline inside the
112 * extra availible space.
113 *
114 * Since: 3.10
115 */
116typedef enum
117{
118 GTK_BASELINE_POSITION_TOP,
119 GTK_BASELINE_POSITION_CENTER,
120 GTK_BASELINE_POSITION_BOTTOM
121} GtkBaselinePosition;
122
123/**
124 * GtkDeleteType:
125 * @GTK_DELETE_CHARS: Delete characters.
126 * @GTK_DELETE_WORD_ENDS: Delete only the portion of the word to the
127 * left/right of cursor if we’re in the middle of a word.
128 * @GTK_DELETE_WORDS: Delete words.
129 * @GTK_DELETE_DISPLAY_LINES: Delete display-lines. Display-lines
130 * refers to the visible lines, with respect to to the current line
131 * breaks. As opposed to paragraphs, which are defined by line
132 * breaks in the input.
133 * @GTK_DELETE_DISPLAY_LINE_ENDS: Delete only the portion of the
134 * display-line to the left/right of cursor.
135 * @GTK_DELETE_PARAGRAPH_ENDS: Delete to the end of the
136 * paragraph. Like C-k in Emacs (or its reverse).
137 * @GTK_DELETE_PARAGRAPHS: Delete entire line. Like C-k in pico.
138 * @GTK_DELETE_WHITESPACE: Delete only whitespace. Like M-\ in Emacs.
139 *
140 * See also: #GtkEntry::delete-from-cursor.
141 */
142typedef enum
143{
144 GTK_DELETE_CHARS,
145 GTK_DELETE_WORD_ENDS,
146 GTK_DELETE_WORDS,
147 GTK_DELETE_DISPLAY_LINES,
148 GTK_DELETE_DISPLAY_LINE_ENDS,
149 GTK_DELETE_PARAGRAPH_ENDS,
150 GTK_DELETE_PARAGRAPHS,
151 GTK_DELETE_WHITESPACE
152} GtkDeleteType;
153
154/* Focus movement types */
155/**
156 * GtkDirectionType:
157 * @GTK_DIR_TAB_FORWARD: Move forward.
158 * @GTK_DIR_TAB_BACKWARD: Move backward.
159 * @GTK_DIR_UP: Move up.
160 * @GTK_DIR_DOWN: Move down.
161 * @GTK_DIR_LEFT: Move left.
162 * @GTK_DIR_RIGHT: Move right.
163 *
164 * Focus movement types.
165 */
166typedef enum
167{
168 GTK_DIR_TAB_FORWARD,
169 GTK_DIR_TAB_BACKWARD,
170 GTK_DIR_UP,
171 GTK_DIR_DOWN,
172 GTK_DIR_LEFT,
173 GTK_DIR_RIGHT
174} GtkDirectionType;
175
176/**
177 * GtkIconSize:
178 * @GTK_ICON_SIZE_INVALID: Invalid size.
179 * @GTK_ICON_SIZE_MENU: Size appropriate for menus (16px).
180 * @GTK_ICON_SIZE_SMALL_TOOLBAR: Size appropriate for small toolbars (16px).
181 * @GTK_ICON_SIZE_LARGE_TOOLBAR: Size appropriate for large toolbars (24px)
182 * @GTK_ICON_SIZE_BUTTON: Size appropriate for buttons (16px)
183 * @GTK_ICON_SIZE_DND: Size appropriate for drag and drop (32px)
184 * @GTK_ICON_SIZE_DIALOG: Size appropriate for dialogs (48px)
185 *
186 * Built-in stock icon sizes.
187 */
188typedef enum
189{
190 GTK_ICON_SIZE_INVALID,
191 GTK_ICON_SIZE_MENU,
192 GTK_ICON_SIZE_SMALL_TOOLBAR,
193 GTK_ICON_SIZE_LARGE_TOOLBAR,
194 GTK_ICON_SIZE_BUTTON,
195 GTK_ICON_SIZE_DND,
196 GTK_ICON_SIZE_DIALOG
197} GtkIconSize;
198
199/**
200 * GtkSensitivityType:
201 * @GTK_SENSITIVITY_AUTO: The arrow is made insensitive if the
202 * thumb is at the end
203 * @GTK_SENSITIVITY_ON: The arrow is always sensitive
204 * @GTK_SENSITIVITY_OFF: The arrow is always insensitive
205 *
206 * Determines how GTK+ handles the sensitivity of stepper arrows
207 * at the end of range widgets.
208 */
209typedef enum
210{
211 GTK_SENSITIVITY_AUTO,
212 GTK_SENSITIVITY_ON,
213 GTK_SENSITIVITY_OFF
214} GtkSensitivityType;
215
216/* Reading directions for text */
217/**
218 * GtkTextDirection:
219 * @GTK_TEXT_DIR_NONE: No direction.
220 * @GTK_TEXT_DIR_LTR: Left to right text direction.
221 * @GTK_TEXT_DIR_RTL: Right to left text direction.
222 *
223 * Reading directions for text.
224 */
225typedef enum
226{
227 GTK_TEXT_DIR_NONE,
228 GTK_TEXT_DIR_LTR,
229 GTK_TEXT_DIR_RTL
230} GtkTextDirection;
231
232/**
233 * GtkJustification:
234 * @GTK_JUSTIFY_LEFT: The text is placed at the left edge of the label.
235 * @GTK_JUSTIFY_RIGHT: The text is placed at the right edge of the label.
236 * @GTK_JUSTIFY_CENTER: The text is placed in the center of the label.
237 * @GTK_JUSTIFY_FILL: The text is placed is distributed across the label.
238 *
239 * Used for justifying the text inside a #GtkLabel widget. (See also
240 * #GtkAlignment).
241 */
242typedef enum
243{
244 GTK_JUSTIFY_LEFT,
245 GTK_JUSTIFY_RIGHT,
246 GTK_JUSTIFY_CENTER,
247 GTK_JUSTIFY_FILL
248} GtkJustification;
249
250/**
251 * GtkMenuDirectionType:
252 * @GTK_MENU_DIR_PARENT: To the parent menu shell
253 * @GTK_MENU_DIR_CHILD: To the submenu, if any, associated with the item
254 * @GTK_MENU_DIR_NEXT: To the next menu item
255 * @GTK_MENU_DIR_PREV: To the previous menu item
256 *
257 * An enumeration representing directional movements within a menu.
258 */
259typedef enum
260{
261 GTK_MENU_DIR_PARENT,
262 GTK_MENU_DIR_CHILD,
263 GTK_MENU_DIR_NEXT,
264 GTK_MENU_DIR_PREV
265} GtkMenuDirectionType;
266
267/**
268 * GtkMessageType:
269 * @GTK_MESSAGE_INFO: Informational message
270 * @GTK_MESSAGE_WARNING: Non-fatal warning message
271 * @GTK_MESSAGE_QUESTION: Question requiring a choice
272 * @GTK_MESSAGE_ERROR: Fatal error message
273 * @GTK_MESSAGE_OTHER: None of the above
274 *
275 * The type of message being displayed in the dialog.
276 */
277typedef enum
278{
279 GTK_MESSAGE_INFO,
280 GTK_MESSAGE_WARNING,
281 GTK_MESSAGE_QUESTION,
282 GTK_MESSAGE_ERROR,
283 GTK_MESSAGE_OTHER
284} GtkMessageType;
285
286/**
287 * GtkMovementStep:
288 * @GTK_MOVEMENT_LOGICAL_POSITIONS: Move forward or back by graphemes
289 * @GTK_MOVEMENT_VISUAL_POSITIONS: Move left or right by graphemes
290 * @GTK_MOVEMENT_WORDS: Move forward or back by words
291 * @GTK_MOVEMENT_DISPLAY_LINES: Move up or down lines (wrapped lines)
292 * @GTK_MOVEMENT_DISPLAY_LINE_ENDS: Move to either end of a line
293 * @GTK_MOVEMENT_PARAGRAPHS: Move up or down paragraphs (newline-ended lines)
294 * @GTK_MOVEMENT_PARAGRAPH_ENDS: Move to either end of a paragraph
295 * @GTK_MOVEMENT_PAGES: Move by pages
296 * @GTK_MOVEMENT_BUFFER_ENDS: Move to ends of the buffer
297 * @GTK_MOVEMENT_HORIZONTAL_PAGES: Move horizontally by pages
298 */
299typedef enum
300{
301 GTK_MOVEMENT_LOGICAL_POSITIONS,
302 GTK_MOVEMENT_VISUAL_POSITIONS,
303 GTK_MOVEMENT_WORDS,
304 GTK_MOVEMENT_DISPLAY_LINES,
305 GTK_MOVEMENT_DISPLAY_LINE_ENDS,
306 GTK_MOVEMENT_PARAGRAPHS,
307 GTK_MOVEMENT_PARAGRAPH_ENDS,
308 GTK_MOVEMENT_PAGES,
309 GTK_MOVEMENT_BUFFER_ENDS,
310 GTK_MOVEMENT_HORIZONTAL_PAGES
311} GtkMovementStep;
312
313/**
314 * GtkScrollStep:
315 * @GTK_SCROLL_STEPS: Scroll in steps.
316 * @GTK_SCROLL_PAGES: Scroll by pages.
317 * @GTK_SCROLL_ENDS: Scroll to ends.
318 * @GTK_SCROLL_HORIZONTAL_STEPS: Scroll in horizontal steps.
319 * @GTK_SCROLL_HORIZONTAL_PAGES: Scroll by horizontal pages.
320 * @GTK_SCROLL_HORIZONTAL_ENDS: Scroll to the horizontal ends.
321 */
322typedef enum
323{
324 GTK_SCROLL_STEPS,
325 GTK_SCROLL_PAGES,
326 GTK_SCROLL_ENDS,
327 GTK_SCROLL_HORIZONTAL_STEPS,
328 GTK_SCROLL_HORIZONTAL_PAGES,
329 GTK_SCROLL_HORIZONTAL_ENDS
330} GtkScrollStep;
331
332/**
333 * GtkOrientation:
334 * @GTK_ORIENTATION_HORIZONTAL: The element is in horizontal orientation.
335 * @GTK_ORIENTATION_VERTICAL: The element is in vertical orientation.
336 *
337 * Represents the orientation of widgets and other objects which can be switched
338 * between horizontal and vertical orientation on the fly, like #GtkToolbar or
339 * #GtkGesturePan.
340 */
341typedef enum
342{
343 GTK_ORIENTATION_HORIZONTAL,
344 GTK_ORIENTATION_VERTICAL
345} GtkOrientation;
346
347/**
348 * GtkPackType:
349 * @GTK_PACK_START: The child is packed into the start of the box
350 * @GTK_PACK_END: The child is packed into the end of the box
351 *
352 * Represents the packing location #GtkBox children. (See: #GtkVBox,
353 * #GtkHBox, and #GtkButtonBox).
354 */
355typedef enum
356{
357 GTK_PACK_START,
358 GTK_PACK_END
359} GtkPackType;
360
361/**
362 * GtkPositionType:
363 * @GTK_POS_LEFT: The feature is at the left edge.
364 * @GTK_POS_RIGHT: The feature is at the right edge.
365 * @GTK_POS_TOP: The feature is at the top edge.
366 * @GTK_POS_BOTTOM: The feature is at the bottom edge.
367 *
368 * Describes which edge of a widget a certain feature is positioned at, e.g. the
369 * tabs of a #GtkNotebook, the handle of a #GtkHandleBox or the label of a
370 * #GtkScale.
371 */
372typedef enum
373{
374 GTK_POS_LEFT,
375 GTK_POS_RIGHT,
376 GTK_POS_TOP,
377 GTK_POS_BOTTOM
378} GtkPositionType;
379
380/**
381 * GtkReliefStyle:
382 * @GTK_RELIEF_NORMAL: Draw a normal relief.
383 * @GTK_RELIEF_HALF: A half relief. Deprecated in 3.14, does the same as @GTK_RELIEF_NORMAL
384 * @GTK_RELIEF_NONE: No relief.
385 *
386 * Indicated the relief to be drawn around a #GtkButton.
387 */
388typedef enum
389{
390 GTK_RELIEF_NORMAL,
391 GTK_RELIEF_HALF,
392 GTK_RELIEF_NONE
393} GtkReliefStyle;
394
395/**
396 * GtkScrollType:
397 * @GTK_SCROLL_NONE: No scrolling.
398 * @GTK_SCROLL_JUMP: Jump to new location.
399 * @GTK_SCROLL_STEP_BACKWARD: Step backward.
400 * @GTK_SCROLL_STEP_FORWARD: Step forward.
401 * @GTK_SCROLL_PAGE_BACKWARD: Page backward.
402 * @GTK_SCROLL_PAGE_FORWARD: Page forward.
403 * @GTK_SCROLL_STEP_UP: Step up.
404 * @GTK_SCROLL_STEP_DOWN: Step down.
405 * @GTK_SCROLL_PAGE_UP: Page up.
406 * @GTK_SCROLL_PAGE_DOWN: Page down.
407 * @GTK_SCROLL_STEP_LEFT: Step to the left.
408 * @GTK_SCROLL_STEP_RIGHT: Step to the right.
409 * @GTK_SCROLL_PAGE_LEFT: Page to the left.
410 * @GTK_SCROLL_PAGE_RIGHT: Page to the right.
411 * @GTK_SCROLL_START: Scroll to start.
412 * @GTK_SCROLL_END: Scroll to end.
413 *
414 * Scrolling types.
415 */
416typedef enum
417{
418 GTK_SCROLL_NONE,
419 GTK_SCROLL_JUMP,
420 GTK_SCROLL_STEP_BACKWARD,
421 GTK_SCROLL_STEP_FORWARD,
422 GTK_SCROLL_PAGE_BACKWARD,
423 GTK_SCROLL_PAGE_FORWARD,
424 GTK_SCROLL_STEP_UP,
425 GTK_SCROLL_STEP_DOWN,
426 GTK_SCROLL_PAGE_UP,
427 GTK_SCROLL_PAGE_DOWN,
428 GTK_SCROLL_STEP_LEFT,
429 GTK_SCROLL_STEP_RIGHT,
430 GTK_SCROLL_PAGE_LEFT,
431 GTK_SCROLL_PAGE_RIGHT,
432 GTK_SCROLL_START,
433 GTK_SCROLL_END
434} GtkScrollType;
435
436/**
437 * GtkSelectionMode:
438 * @GTK_SELECTION_NONE: No selection is possible.
439 * @GTK_SELECTION_SINGLE: Zero or one element may be selected.
440 * @GTK_SELECTION_BROWSE: Exactly one element is selected.
441 * In some circumstances, such as initially or during a search
442 * operation, it’s possible for no element to be selected with
443 * %GTK_SELECTION_BROWSE. What is really enforced is that the user
444 * can’t deselect a currently selected element except by selecting
445 * another element.
446 * @GTK_SELECTION_MULTIPLE: Any number of elements may be selected.
447 * The Ctrl key may be used to enlarge the selection, and Shift
448 * key to select between the focus and the child pointed to.
449 * Some widgets may also allow Click-drag to select a range of elements.
450 *
451 * Used to control what selections users are allowed to make.
452 */
453typedef enum
454{
455 GTK_SELECTION_NONE,
456 GTK_SELECTION_SINGLE,
457 GTK_SELECTION_BROWSE,
458 GTK_SELECTION_MULTIPLE
459} GtkSelectionMode;
460
461/**
462 * GtkShadowType:
463 * @GTK_SHADOW_NONE: No outline.
464 * @GTK_SHADOW_IN: The outline is bevelled inwards.
465 * @GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
466 * @GTK_SHADOW_ETCHED_IN: The outline has a sunken 3d appearance.
467 * @GTK_SHADOW_ETCHED_OUT: The outline has a raised 3d appearance.
468 *
469 * Used to change the appearance of an outline typically provided by a #GtkFrame.
470 *
471 * Note that many themes do not differentiate the appearance of the
472 * various shadow types: Either their is no visible shadow (@GTK_SHADOW_NONE),
473 * or there is (any other value).
474 */
475typedef enum
476{
477 GTK_SHADOW_NONE,
478 GTK_SHADOW_IN,
479 GTK_SHADOW_OUT,
480 GTK_SHADOW_ETCHED_IN,
481 GTK_SHADOW_ETCHED_OUT
482} GtkShadowType;
483
484/* Widget states */
485
486/**
487 * GtkStateType:
488 * @GTK_STATE_NORMAL: State during normal operation.
489 * @GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button.
490 * @GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over
491 * the widget and the widget will respond to mouse clicks.
492 * @GTK_STATE_SELECTED: State of a selected item, such the selected row in a list.
493 * @GTK_STATE_INSENSITIVE: State indicating that the widget is
494 * unresponsive to user actions.
495 * @GTK_STATE_INCONSISTENT: The widget is inconsistent, such as checkbuttons
496 * or radiobuttons that aren’t either set to %TRUE nor %FALSE,
497 * or buttons requiring the user attention.
498 * @GTK_STATE_FOCUSED: The widget has the keyboard focus.
499 *
500 * This type indicates the current state of a widget; the state determines how
501 * the widget is drawn. The #GtkStateType enumeration is also used to
502 * identify different colors in a #GtkStyle for drawing, so states can be
503 * used for subparts of a widget as well as entire widgets.
504 *
505 * Deprecated: 3.14: All APIs that are using this enumeration have been deprecated
506 * in favor of alternatives using #GtkStateFlags.
507 */
508typedef enum
509{
510 GTK_STATE_NORMAL,
511 GTK_STATE_ACTIVE,
512 GTK_STATE_PRELIGHT,
513 GTK_STATE_SELECTED,
514 GTK_STATE_INSENSITIVE,
515 GTK_STATE_INCONSISTENT,
516 GTK_STATE_FOCUSED
517} GtkStateType;
518
519/**
520 * GtkToolbarStyle:
521 * @GTK_TOOLBAR_ICONS: Buttons display only icons in the toolbar.
522 * @GTK_TOOLBAR_TEXT: Buttons display only text labels in the toolbar.
523 * @GTK_TOOLBAR_BOTH: Buttons display text and icons in the toolbar.
524 * @GTK_TOOLBAR_BOTH_HORIZ: Buttons display icons and text alongside each
525 * other, rather than vertically stacked
526 *
527 * Used to customize the appearance of a #GtkToolbar. Note that
528 * setting the toolbar style overrides the user’s preferences
529 * for the default toolbar style. Note that if the button has only
530 * a label set and GTK_TOOLBAR_ICONS is used, the label will be
531 * visible, and vice versa.
532 */
533typedef enum
534{
535 GTK_TOOLBAR_ICONS,
536 GTK_TOOLBAR_TEXT,
537 GTK_TOOLBAR_BOTH,
538 GTK_TOOLBAR_BOTH_HORIZ
539} GtkToolbarStyle;
540
541/**
542 * GtkWrapMode:
543 * @GTK_WRAP_NONE: do not wrap lines; just make the text area wider
544 * @GTK_WRAP_CHAR: wrap text, breaking lines anywhere the cursor can
545 * appear (between characters, usually - if you want to be technical,
546 * between graphemes, see pango_get_log_attrs())
547 * @GTK_WRAP_WORD: wrap text, breaking lines in between words
548 * @GTK_WRAP_WORD_CHAR: wrap text, breaking lines in between words, or if
549 * that is not enough, also between graphemes
550 *
551 * Describes a type of line wrapping.
552 */
553typedef enum
554{
555 GTK_WRAP_NONE,
556 GTK_WRAP_CHAR,
557 GTK_WRAP_WORD,
558 GTK_WRAP_WORD_CHAR
559} GtkWrapMode;
560
561/**
562 * GtkSortType:
563 * @GTK_SORT_ASCENDING: Sorting is in ascending order.
564 * @GTK_SORT_DESCENDING: Sorting is in descending order.
565 *
566 * Determines the direction of a sort.
567 */
568typedef enum
569{
570 GTK_SORT_ASCENDING,
571 GTK_SORT_DESCENDING
572} GtkSortType;
573
574/* Style for gtk input method preedit/status */
575/**
576 * GtkIMPreeditStyle:
577 * @GTK_IM_PREEDIT_NOTHING: Deprecated
578 * @GTK_IM_PREEDIT_CALLBACK: Deprecated
579 * @GTK_IM_PREEDIT_NONE: Deprecated
580 *
581 * Style for input method preedit. See also
582 * #GtkSettings:gtk-im-preedit-style
583 *
584 * Deprecated: 3.10
585 */
586typedef enum
587{
588 GTK_IM_PREEDIT_NOTHING,
589 GTK_IM_PREEDIT_CALLBACK,
590 GTK_IM_PREEDIT_NONE
591} GtkIMPreeditStyle;
592
593/**
594 * GtkIMStatusStyle:
595 * @GTK_IM_STATUS_NOTHING: Deprecated
596 * @GTK_IM_STATUS_CALLBACK: Deprecated
597 * @GTK_IM_STATUS_NONE: Deprecated
598 *
599 * Style for input method status. See also
600 * #GtkSettings:gtk-im-status-style
601 *
602 * Deprecated: 3.10
603 */
604typedef enum
605{
606 GTK_IM_STATUS_NOTHING,
607 GTK_IM_STATUS_CALLBACK,
608 GTK_IM_STATUS_NONE
609} GtkIMStatusStyle;
610
611/**
612 * GtkPackDirection:
613 * @GTK_PACK_DIRECTION_LTR: Widgets are packed left-to-right
614 * @GTK_PACK_DIRECTION_RTL: Widgets are packed right-to-left
615 * @GTK_PACK_DIRECTION_TTB: Widgets are packed top-to-bottom
616 * @GTK_PACK_DIRECTION_BTT: Widgets are packed bottom-to-top
617 *
618 * Determines how widgets should be packed inside menubars
619 * and menuitems contained in menubars.
620 */
621typedef enum
622{
623 GTK_PACK_DIRECTION_LTR,
624 GTK_PACK_DIRECTION_RTL,
625 GTK_PACK_DIRECTION_TTB,
626 GTK_PACK_DIRECTION_BTT
627} GtkPackDirection;
628
629/**
630 * GtkPrintPages:
631 * @GTK_PRINT_PAGES_ALL: All pages.
632 * @GTK_PRINT_PAGES_CURRENT: Current page.
633 * @GTK_PRINT_PAGES_RANGES: Range of pages.
634 * @GTK_PRINT_PAGES_SELECTION: Selected pages.
635 *
636 * See also gtk_print_job_set_pages()
637 */
638typedef enum
639{
640 GTK_PRINT_PAGES_ALL,
641 GTK_PRINT_PAGES_CURRENT,
642 GTK_PRINT_PAGES_RANGES,
643 GTK_PRINT_PAGES_SELECTION
644} GtkPrintPages;
645
646/**
647 * GtkPageSet:
648 * @GTK_PAGE_SET_ALL: All pages.
649 * @GTK_PAGE_SET_EVEN: Even pages.
650 * @GTK_PAGE_SET_ODD: Odd pages.
651 *
652 * See also gtk_print_job_set_page_set().
653 */
654typedef enum
655{
656 GTK_PAGE_SET_ALL,
657 GTK_PAGE_SET_EVEN,
658 GTK_PAGE_SET_ODD
659} GtkPageSet;
660
661/**
662 * GtkNumberUpLayout:
663 * @GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM: ![](layout-lrtb.png)
664 * @GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP: ![](layout-lrbt.png)
665 * @GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM: ![](layout-rltb.png)
666 * @GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP: ![](layout-rlbt.png)
667 * @GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT: ![](layout-tblr.png)
668 * @GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT: ![](layout-tbrl.png)
669 * @GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT: ![](layout-btlr.png)
670 * @GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT: ![](layout-btrl.png)
671 *
672 * Used to determine the layout of pages on a sheet when printing
673 * multiple pages per sheet.
674 */
675typedef enum
676{
677 GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM, /*< nick=lrtb >*/
678 GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP, /*< nick=lrbt >*/
679 GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM, /*< nick=rltb >*/
680 GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP, /*< nick=rlbt >*/
681 GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT, /*< nick=tblr >*/
682 GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT, /*< nick=tbrl >*/
683 GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT, /*< nick=btlr >*/
684 GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT /*< nick=btrl >*/
685} GtkNumberUpLayout;
686
687/**
688 * GtkPageOrientation:
689 * @GTK_PAGE_ORIENTATION_PORTRAIT: Portrait mode.
690 * @GTK_PAGE_ORIENTATION_LANDSCAPE: Landscape mode.
691 * @GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT: Reverse portrait mode.
692 * @GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE: Reverse landscape mode.
693 *
694 * See also gtk_print_settings_set_orientation().
695 */
696typedef enum
697{
698 GTK_PAGE_ORIENTATION_PORTRAIT,
699 GTK_PAGE_ORIENTATION_LANDSCAPE,
700 GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT,
701 GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE
702} GtkPageOrientation;
703
704/**
705 * GtkPrintQuality:
706 * @GTK_PRINT_QUALITY_LOW: Low quality.
707 * @GTK_PRINT_QUALITY_NORMAL: Normal quality.
708 * @GTK_PRINT_QUALITY_HIGH: High quality.
709 * @GTK_PRINT_QUALITY_DRAFT: Draft quality.
710 *
711 * See also gtk_print_settings_set_quality().
712 */
713typedef enum
714{
715 GTK_PRINT_QUALITY_LOW,
716 GTK_PRINT_QUALITY_NORMAL,
717 GTK_PRINT_QUALITY_HIGH,
718 GTK_PRINT_QUALITY_DRAFT
719} GtkPrintQuality;
720
721/**
722 * GtkPrintDuplex:
723 * @GTK_PRINT_DUPLEX_SIMPLEX: No duplex.
724 * @GTK_PRINT_DUPLEX_HORIZONTAL: Horizontal duplex.
725 * @GTK_PRINT_DUPLEX_VERTICAL: Vertical duplex.
726 *
727 * See also gtk_print_settings_set_duplex().
728 */
729typedef enum
730{
731 GTK_PRINT_DUPLEX_SIMPLEX,
732 GTK_PRINT_DUPLEX_HORIZONTAL,
733 GTK_PRINT_DUPLEX_VERTICAL
734} GtkPrintDuplex;
735
736
737/**
738 * GtkUnit:
739 * @GTK_UNIT_NONE: No units.
740 * @GTK_UNIT_POINTS: Dimensions in points.
741 * @GTK_UNIT_INCH: Dimensions in inches.
742 * @GTK_UNIT_MM: Dimensions in millimeters
743 *
744 * See also gtk_print_settings_set_paper_width().
745 */
746typedef enum
747{
748 GTK_UNIT_NONE,
749 GTK_UNIT_POINTS,
750 GTK_UNIT_INCH,
751 GTK_UNIT_MM
752} GtkUnit;
753
754#define GTK_UNIT_PIXEL GTK_UNIT_NONE
755
756/**
757 * GtkTreeViewGridLines:
758 * @GTK_TREE_VIEW_GRID_LINES_NONE: No grid lines.
759 * @GTK_TREE_VIEW_GRID_LINES_HORIZONTAL: Horizontal grid lines.
760 * @GTK_TREE_VIEW_GRID_LINES_VERTICAL: Vertical grid lines.
761 * @GTK_TREE_VIEW_GRID_LINES_BOTH: Horizontal and vertical grid lines.
762 *
763 * Used to indicate which grid lines to draw in a tree view.
764 */
765typedef enum
766{
767 GTK_TREE_VIEW_GRID_LINES_NONE,
768 GTK_TREE_VIEW_GRID_LINES_HORIZONTAL,
769 GTK_TREE_VIEW_GRID_LINES_VERTICAL,
770 GTK_TREE_VIEW_GRID_LINES_BOTH
771} GtkTreeViewGridLines;
772
773/**
774 * GtkDragResult:
775 * @GTK_DRAG_RESULT_SUCCESS: The drag operation was successful.
776 * @GTK_DRAG_RESULT_NO_TARGET: No suitable drag target.
777 * @GTK_DRAG_RESULT_USER_CANCELLED: The user cancelled the drag operation.
778 * @GTK_DRAG_RESULT_TIMEOUT_EXPIRED: The drag operation timed out.
779 * @GTK_DRAG_RESULT_GRAB_BROKEN: The pointer or keyboard grab used
780 * for the drag operation was broken.
781 * @GTK_DRAG_RESULT_ERROR: The drag operation failed due to some
782 * unspecified error.
783 *
784 * Gives an indication why a drag operation failed.
785 * The value can by obtained by connecting to the
786 * #GtkWidget::drag-failed signal.
787 */
788typedef enum
789{
790 GTK_DRAG_RESULT_SUCCESS,
791 GTK_DRAG_RESULT_NO_TARGET,
792 GTK_DRAG_RESULT_USER_CANCELLED,
793 GTK_DRAG_RESULT_TIMEOUT_EXPIRED,
794 GTK_DRAG_RESULT_GRAB_BROKEN,
795 GTK_DRAG_RESULT_ERROR
796} GtkDragResult;
797
798/**
799 * GtkSizeGroupMode:
800 * @GTK_SIZE_GROUP_NONE: group has no effect
801 * @GTK_SIZE_GROUP_HORIZONTAL: group affects horizontal requisition
802 * @GTK_SIZE_GROUP_VERTICAL: group affects vertical requisition
803 * @GTK_SIZE_GROUP_BOTH: group affects both horizontal and vertical requisition
804 *
805 * The mode of the size group determines the directions in which the size
806 * group affects the requested sizes of its component widgets.
807 **/
808typedef enum {
809 GTK_SIZE_GROUP_NONE,
810 GTK_SIZE_GROUP_HORIZONTAL,
811 GTK_SIZE_GROUP_VERTICAL,
812 GTK_SIZE_GROUP_BOTH
813} GtkSizeGroupMode;
814
815/**
816 * GtkSizeRequestMode:
817 * @GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH: Prefer height-for-width geometry management
818 * @GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT: Prefer width-for-height geometry management
819 * @GTK_SIZE_REQUEST_CONSTANT_SIZE: Don’t trade height-for-width or width-for-height
820 *
821 * Specifies a preference for height-for-width or
822 * width-for-height geometry management.
823 */
824typedef enum
825{
826 GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH = 0,
827 GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT,
828 GTK_SIZE_REQUEST_CONSTANT_SIZE
829} GtkSizeRequestMode;
830
831/**
832 * GtkScrollablePolicy:
833 * @GTK_SCROLL_MINIMUM: Scrollable adjustments are based on the minimum size
834 * @GTK_SCROLL_NATURAL: Scrollable adjustments are based on the natural size
835 *
836 * Defines the policy to be used in a scrollable widget when updating
837 * the scrolled window adjustments in a given orientation.
838 */
839typedef enum
840{
841 GTK_SCROLL_MINIMUM = 0,
842 GTK_SCROLL_NATURAL
843} GtkScrollablePolicy;
844
845/**
846 * GtkStateFlags:
847 * @GTK_STATE_FLAG_NORMAL: State during normal operation.
848 * @GTK_STATE_FLAG_ACTIVE: Widget is active.
849 * @GTK_STATE_FLAG_PRELIGHT: Widget has a mouse pointer over it.
850 * @GTK_STATE_FLAG_SELECTED: Widget is selected.
851 * @GTK_STATE_FLAG_INSENSITIVE: Widget is insensitive.
852 * @GTK_STATE_FLAG_INCONSISTENT: Widget is inconsistent.
853 * @GTK_STATE_FLAG_FOCUSED: Widget has the keyboard focus.
854 * @GTK_STATE_FLAG_BACKDROP: Widget is in a background toplevel window.
855 * @GTK_STATE_FLAG_DIR_LTR: Widget is in left-to-right text direction. Since 3.8
856 * @GTK_STATE_FLAG_DIR_RTL: Widget is in right-to-left text direction. Since 3.8
857 * @GTK_STATE_FLAG_LINK: Widget is a link. Since 3.12
858 * @GTK_STATE_FLAG_VISITED: The location the widget points to has already been visited. Since 3.12
859 * @GTK_STATE_FLAG_CHECKED: Widget is checked. Since 3.14
860 * @GTK_STATE_FLAG_DROP_ACTIVE: Widget is highlighted as a drop target for DND. Since 3.20
861 *
862 * Describes a widget state. Widget states are used to match the widget
863 * against CSS pseudo-classes. Note that GTK extends the regular CSS
864 * classes and sometimes uses different names.
865 */
866typedef enum
867{
868 GTK_STATE_FLAG_NORMAL = 0,
869 GTK_STATE_FLAG_ACTIVE = 1 << 0,
870 GTK_STATE_FLAG_PRELIGHT = 1 << 1,
871 GTK_STATE_FLAG_SELECTED = 1 << 2,
872 GTK_STATE_FLAG_INSENSITIVE = 1 << 3,
873 GTK_STATE_FLAG_INCONSISTENT = 1 << 4,
874 GTK_STATE_FLAG_FOCUSED = 1 << 5,
875 GTK_STATE_FLAG_BACKDROP = 1 << 6,
876 GTK_STATE_FLAG_DIR_LTR = 1 << 7,
877 GTK_STATE_FLAG_DIR_RTL = 1 << 8,
878 GTK_STATE_FLAG_LINK = 1 << 9,
879 GTK_STATE_FLAG_VISITED = 1 << 10,
880 GTK_STATE_FLAG_CHECKED = 1 << 11,
881 GTK_STATE_FLAG_DROP_ACTIVE = 1 << 12
882} GtkStateFlags;
883
884/**
885 * GtkRegionFlags:
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.
892 *
893 * Describes a region within a widget.
894 */
895typedef enum {
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
902} GtkRegionFlags;
903
904/**
905 * GtkJunctionSides:
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.
915 *
916 * Describes how a rendered element connects to adjacent elements.
917 */
918typedef enum {
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)
928} GtkJunctionSides;
929
930/**
931 * GtkBorderStyle:
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 parallel 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
942 *
943 * Describes how the border of a UI element should be rendered.
944 */
945typedef enum {
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
956} GtkBorderStyle;
957
958/**
959 * GtkLevelBarMode:
960 * @GTK_LEVEL_BAR_MODE_CONTINUOUS: the bar has a continuous mode
961 * @GTK_LEVEL_BAR_MODE_DISCRETE: the bar has a discrete mode
962 *
963 * Describes how #GtkLevelBar contents should be rendered.
964 * Note that this enumeration could be extended with additional modes
965 * in the future.
966 *
967 * Since: 3.6
968 */
969typedef enum {
970 GTK_LEVEL_BAR_MODE_CONTINUOUS,
971 GTK_LEVEL_BAR_MODE_DISCRETE
972} GtkLevelBarMode;
973
974G_END_DECLS
975
976/**
977 * GtkInputPurpose:
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
988 * @GTK_INPUT_PURPOSE_TERMINAL: Allow any character, in addition to control codes
989 *
990 * Describes primary purpose of the input widget. This information is
991 * useful for on-screen keyboards and similar input methods to decide
992 * which keys should be presented to the user.
993 *
994 * Note that the purpose is not meant to impose a totally strict rule
995 * about allowed characters, and does not replace input validation.
996 * It is fine for an on-screen keyboard to let the user override the
997 * character set restriction that is expressed by the purpose. The
998 * application is expected to validate the entry contents, even if
999 * it specified a purpose.
1000 *
1001 * The difference between @GTK_INPUT_PURPOSE_DIGITS and
1002 * @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits
1003 * while the latter also some punctuation (like commas or points, plus,
1004 * minus) and “e” or “E” as in 3.14E+000.
1005 *
1006 * This enumeration may be extended in the future; input methods should
1007 * interpret unknown values as “free form”.
1008 *
1009 * Since: 3.6
1010 */
1011typedef enum
1012{
1013 GTK_INPUT_PURPOSE_FREE_FORM,
1014 GTK_INPUT_PURPOSE_ALPHA,
1015 GTK_INPUT_PURPOSE_DIGITS,
1016 GTK_INPUT_PURPOSE_NUMBER,
1017 GTK_INPUT_PURPOSE_PHONE,
1018 GTK_INPUT_PURPOSE_URL,
1019 GTK_INPUT_PURPOSE_EMAIL,
1020 GTK_INPUT_PURPOSE_NAME,
1021 GTK_INPUT_PURPOSE_PASSWORD,
1022 GTK_INPUT_PURPOSE_PIN,
1023 GTK_INPUT_PURPOSE_TERMINAL,
1024} GtkInputPurpose;
1025
1026/**
1027 * GtkInputHints:
1028 * @GTK_INPUT_HINT_NONE: No special behaviour suggested
1029 * @GTK_INPUT_HINT_SPELLCHECK: Suggest checking for typos
1030 * @GTK_INPUT_HINT_NO_SPELLCHECK: Suggest not checking for typos
1031 * @GTK_INPUT_HINT_WORD_COMPLETION: Suggest word completion
1032 * @GTK_INPUT_HINT_LOWERCASE: Suggest to convert all text to lowercase
1033 * @GTK_INPUT_HINT_UPPERCASE_CHARS: Suggest to capitalize all text
1034 * @GTK_INPUT_HINT_UPPERCASE_WORDS: Suggest to capitalize the first
1035 * character of each word
1036 * @GTK_INPUT_HINT_UPPERCASE_SENTENCES: Suggest to capitalize the
1037 * first word of each sentence
1038 * @GTK_INPUT_HINT_INHIBIT_OSK: Suggest to not show an onscreen keyboard
1039 * (e.g for a calculator that already has all the keys).
1040 * @GTK_INPUT_HINT_VERTICAL_WRITING: The text is vertical. Since 3.18
1041 * @GTK_INPUT_HINT_EMOJI: Suggest offering Emoji support. Since 3.22.20
1042 * @GTK_INPUT_HINT_NO_EMOJI: Suggest not offering Emoji support. Since 3.22.20
1043 *
1044 * Describes hints that might be taken into account by input methods
1045 * or applications. Note that input methods may already tailor their
1046 * behaviour according to the #GtkInputPurpose of the entry.
1047 *
1048 * Some common sense is expected when using these flags - mixing
1049 * @GTK_INPUT_HINT_LOWERCASE with any of the uppercase hints makes no sense.
1050 *
1051 * This enumeration may be extended in the future; input methods should
1052 * ignore unknown values.
1053 *
1054 * Since: 3.6
1055 */
1056typedef enum
1057{
1058 GTK_INPUT_HINT_NONE = 0,
1059 GTK_INPUT_HINT_SPELLCHECK = 1 << 0,
1060 GTK_INPUT_HINT_NO_SPELLCHECK = 1 << 1,
1061 GTK_INPUT_HINT_WORD_COMPLETION = 1 << 2,
1062 GTK_INPUT_HINT_LOWERCASE = 1 << 3,
1063 GTK_INPUT_HINT_UPPERCASE_CHARS = 1 << 4,
1064 GTK_INPUT_HINT_UPPERCASE_WORDS = 1 << 5,
1065 GTK_INPUT_HINT_UPPERCASE_SENTENCES = 1 << 6,
1066 GTK_INPUT_HINT_INHIBIT_OSK = 1 << 7,
1067 GTK_INPUT_HINT_VERTICAL_WRITING = 1 << 8,
1068 GTK_INPUT_HINT_EMOJI = 1 << 9,
1069 GTK_INPUT_HINT_NO_EMOJI = 1 << 10
1070} GtkInputHints;
1071
1072/**
1073 * GtkPropagationPhase:
1074 * @GTK_PHASE_NONE: Events are not delivered automatically. Those can be
1075 * manually fed through gtk_event_controller_handle_event(). This should
1076 * only be used when full control about when, or whether the controller
1077 * handles the event is needed.
1078 * @GTK_PHASE_CAPTURE: Events are delivered in the capture phase. The
1079 * capture phase happens before the bubble phase, runs from the toplevel down
1080 * to the event widget. This option should only be used on containers that
1081 * might possibly handle events before their children do.
1082 * @GTK_PHASE_BUBBLE: Events are delivered in the bubble phase. The bubble
1083 * phase happens after the capture phase, and before the default handlers
1084 * are run. This phase runs from the event widget, up to the toplevel.
1085 * @GTK_PHASE_TARGET: Events are delivered in the default widget event handlers,
1086 * note that widget implementations must chain up on button, motion, touch and
1087 * grab broken handlers for controllers in this phase to be run.
1088 *
1089 * Describes the stage at which events are fed into a #GtkEventController.
1090 *
1091 * Since: 3.14
1092 */
1093typedef enum
1094{
1095 GTK_PHASE_NONE,
1096 GTK_PHASE_CAPTURE,
1097 GTK_PHASE_BUBBLE,
1098 GTK_PHASE_TARGET
1099} GtkPropagationPhase;
1100
1101/**
1102 * GtkEventSequenceState:
1103 * @GTK_EVENT_SEQUENCE_NONE: The sequence is handled, but not grabbed.
1104 * @GTK_EVENT_SEQUENCE_CLAIMED: The sequence is handled and grabbed.
1105 * @GTK_EVENT_SEQUENCE_DENIED: The sequence is denied.
1106 *
1107 * Describes the state of a #GdkEventSequence in a #GtkGesture.
1108 *
1109 * Since: 3.14
1110 */
1111typedef enum
1112{
1113 GTK_EVENT_SEQUENCE_NONE,
1114 GTK_EVENT_SEQUENCE_CLAIMED,
1115 GTK_EVENT_SEQUENCE_DENIED
1116} GtkEventSequenceState;
1117
1118/**
1119 * GtkPanDirection:
1120 * @GTK_PAN_DIRECTION_LEFT: panned towards the left
1121 * @GTK_PAN_DIRECTION_RIGHT: panned towards the right
1122 * @GTK_PAN_DIRECTION_UP: panned upwards
1123 * @GTK_PAN_DIRECTION_DOWN: panned downwards
1124 *
1125 * Describes the panning direction of a #GtkGesturePan
1126 *
1127 * Since: 3.14
1128 */
1129typedef enum
1130{
1131 GTK_PAN_DIRECTION_LEFT,
1132 GTK_PAN_DIRECTION_RIGHT,
1133 GTK_PAN_DIRECTION_UP,
1134 GTK_PAN_DIRECTION_DOWN
1135} GtkPanDirection;
1136
1137/**
1138 * GtkPopoverConstraint:
1139 * @GTK_POPOVER_CONSTRAINT_NONE: Don't constrain the popover position
1140 * beyond what is imposed by the implementation
1141 * @GTK_POPOVER_CONSTRAINT_WINDOW: Constrain the popover to the boundaries
1142 * of the window that it is attached to
1143 *
1144 * Describes constraints to positioning of popovers. More values
1145 * may be added to this enumeration in the future.
1146 *
1147 * Since: 3.20
1148 */
1149typedef enum
1150{
1151 GTK_POPOVER_CONSTRAINT_NONE,
1152 GTK_POPOVER_CONSTRAINT_WINDOW
1153} GtkPopoverConstraint;
1154
1155
1156#endif /* __GTK_ENUMS_H__ */
1157

source code of include/gtk-3.0/gtk/gtkenums.h