Standard Enumerations

Standard Enumerations — Public enumerated types used throughout GTK+

Synopsis


#include <gtk/gtk.h>


enum        GtkAccelFlags;
enum        GtkAnchorType;
enum        GtkArrowType;
enum        GtkAttachOptions;
enum        GtkButtonBoxStyle;
enum        GtkCornerType;
enum        GtkCurveType;
enum        GtkDeleteType;
enum        GtkDirectionType;
enum        GtkExpanderStyle;
enum        GtkIMPreeditStyle;
enum        GtkIMStatusStyle;
enum        GtkJustification;
enum        GtkMatchType;
enum        GtkMetricType;
enum        GtkMovementStep;
enum        GtkOrientation;
enum        GtkPackType;
enum        GtkPathPriorityType;
enum        GtkPathType;
enum        GtkPolicyType;
enum        GtkPositionType;
enum        GtkPreviewType;
enum        GtkReliefStyle;
enum        GtkResizeMode;
enum        GtkScrollType;
enum        GtkSelectionMode;
enum        GtkShadowType;
enum        GtkSideType;
enum        GtkStateType;
enum        GtkSubmenuDirection;
enum        GtkSubmenuPlacement;
enum        GtkToolbarStyle;
enum        GtkUpdateType;
enum        GtkVisibility;
enum        GtkWindowPosition;
enum        GtkWindowType;
enum        GtkSortType;

Description

Details

enum GtkAccelFlags

typedef enum
{
  GTK_ACCEL_VISIBLE        = 1 << 0,	/* display in GtkAccelLabel? */
  GTK_ACCEL_LOCKED         = 1 << 1,	/* is it removable? */
  GTK_ACCEL_MASK           = 0x07
} GtkAccelFlags;


enum GtkAnchorType

typedef enum
{
  GTK_ANCHOR_CENTER,
  GTK_ANCHOR_NORTH,
  GTK_ANCHOR_NORTH_WEST,
  GTK_ANCHOR_NORTH_EAST,
  GTK_ANCHOR_SOUTH,
  GTK_ANCHOR_SOUTH_WEST,
  GTK_ANCHOR_SOUTH_EAST,
  GTK_ANCHOR_WEST,
  GTK_ANCHOR_EAST,
  GTK_ANCHOR_N		= GTK_ANCHOR_NORTH,
  GTK_ANCHOR_NW		= GTK_ANCHOR_NORTH_WEST,
  GTK_ANCHOR_NE		= GTK_ANCHOR_NORTH_EAST,
  GTK_ANCHOR_S		= GTK_ANCHOR_SOUTH,
  GTK_ANCHOR_SW		= GTK_ANCHOR_SOUTH_WEST,
  GTK_ANCHOR_SE		= GTK_ANCHOR_SOUTH_EAST,
  GTK_ANCHOR_W		= GTK_ANCHOR_WEST,
  GTK_ANCHOR_E		= GTK_ANCHOR_EAST
} GtkAnchorType;


enum GtkArrowType

typedef enum
{
  GTK_ARROW_UP,
  GTK_ARROW_DOWN,
  GTK_ARROW_LEFT,
  GTK_ARROW_RIGHT
} GtkArrowType;

Used to indicate the direction in which a GtkArrow should point.

GTK_ARROW_UPRepresents an upward pointing arrow.
GTK_ARROW_DOWNRepresents a downward pointing arrow.
GTK_ARROW_LEFTRepresents a left pointing arrow.
GTK_ARROW_RIGHTRepresents a right pointing arrow.

enum GtkAttachOptions

typedef enum
{
  GTK_EXPAND = 1 << 0,
  GTK_SHRINK = 1 << 1,
  GTK_FILL   = 1 << 2
} GtkAttachOptions;

Denotes the expansion properties that a widget will have when it (or it's parent) is resized.

GTK_EXPANDthe widget should expand to take up any extra space in its container that has been allocated.
GTK_SHRINKthe widget should shrink as and when possible.
GTK_FILLthe widget should fill the space allocated to it.

enum GtkButtonBoxStyle

typedef enum 
{
  GTK_BUTTONBOX_DEFAULT_STYLE,
  GTK_BUTTONBOX_SPREAD,
  GTK_BUTTONBOX_EDGE,
  GTK_BUTTONBOX_START,
  GTK_BUTTONBOX_END
} GtkButtonBoxStyle;

Used to dictate the style that a GtkButtonBox uses to layout the buttons it contains. (See also: GtkVButtonBox and GtkHButtonBox).

GTK_BUTTONBOX_DEFAULT_STYLEDefault packing.
GTK_BUTTONBOX_SPREADButtons are evenly spread across the ButtonBox.
GTK_BUTTONBOX_EDGEButtons are placed at the edges of the ButtonBox.
GTK_BUTTONBOX_STARTButtons are grouped towards the start of box, (on the left for a HBox, or the top for a VBox).
GTK_BUTTONBOX_ENDButtons are grouped towards the end of a box, (on the right for a HBox, or the bottom for a VBox).

enum GtkCornerType

typedef enum
{
  GTK_CORNER_TOP_LEFT,
  GTK_CORNER_BOTTOM_LEFT,
  GTK_CORNER_TOP_RIGHT,
  GTK_CORNER_BOTTOM_RIGHT
} GtkCornerType;

Specifies which corner a child widget should be placed in when packed into a GtkScrolledWindow. This is effectively the opposite of where the scroll bars are placed.

GTK_CORNER_TOP_LEFTPlace the scrollbars on the right and bottom of the widget (default behaviour).
GTK_CORNER_BOTTOM_LEFTPlace the scrollbars on the top and right of the widget.
GTK_CORNER_TOP_RIGHTPlace the scrollbars on the left and bottom of the widget.
GTK_CORNER_BOTTOM_RIGHTPlace the scrollbars on the top and left of the widget.

enum GtkCurveType

typedef enum
{
  GTK_CURVE_TYPE_LINEAR,       /* linear interpolation */
  GTK_CURVE_TYPE_SPLINE,       /* spline interpolation */
  GTK_CURVE_TYPE_FREE          /* free form curve */
} GtkCurveType;


enum GtkDeleteType

typedef enum {
  GTK_DELETE_CHARS,
  GTK_DELETE_WORD_ENDS,           /* delete only the portion of the word to the
                                   * left/right of cursor if we're in the middle
                                   * of a word */
  GTK_DELETE_WORDS,
  GTK_DELETE_DISPLAY_LINES,
  GTK_DELETE_DISPLAY_LINE_ENDS,
  GTK_DELETE_PARAGRAPH_ENDS,      /* like C-k in Emacs (or its reverse) */
  GTK_DELETE_PARAGRAPHS,          /* C-k in pico, kill whole line */
  GTK_DELETE_WHITESPACE           /* M-\ in Emacs */
} GtkDeleteType;


enum GtkDirectionType

typedef enum
{
  GTK_DIR_TAB_FORWARD,
  GTK_DIR_TAB_BACKWARD,
  GTK_DIR_UP,
  GTK_DIR_DOWN,
  GTK_DIR_LEFT,
  GTK_DIR_RIGHT
} GtkDirectionType;


enum GtkExpanderStyle

typedef enum
{
  GTK_EXPANDER_COLLAPSED,
  GTK_EXPANDER_SEMI_COLLAPSED,
  GTK_EXPANDER_SEMI_EXPANDED,
  GTK_EXPANDER_EXPANDED
} GtkExpanderStyle;


enum GtkIMPreeditStyle

typedef enum
{
  GTK_IM_PREEDIT_NOTHING,
  GTK_IM_PREEDIT_CALLBACK
} GtkIMPreeditStyle;


enum GtkIMStatusStyle

typedef enum
{
  GTK_IM_STATUS_NOTHING,
  GTK_IM_STATUS_CALLBACK
} GtkIMStatusStyle;


enum GtkJustification

typedef enum
{
  GTK_JUSTIFY_LEFT,
  GTK_JUSTIFY_RIGHT,
  GTK_JUSTIFY_CENTER,
  GTK_JUSTIFY_FILL
} GtkJustification;

Used for justifying the text inside a GtkLabel widget. (See also GtkAlignment).

GTK_JUSTIFY_LEFTThe text is placed at the left edge of the label.
GTK_JUSTIFY_RIGHTThe text is placed at the right edge of the label.
GTK_JUSTIFY_CENTERThe text is placed in the center of the label.
GTK_JUSTIFY_FILLThe text is placed is distributed across the label.

enum GtkMatchType

typedef enum
{
  GTK_MATCH_ALL,       /* "*A?A*" */
  GTK_MATCH_ALL_TAIL,  /* "*A?AA" */
  GTK_MATCH_HEAD,      /* "AAAA*" */
  GTK_MATCH_TAIL,      /* "*AAAA" */
  GTK_MATCH_EXACT,     /* "AAAAA" */
  GTK_MATCH_LAST
} GtkMatchType;

Warning

GtkMatchType is deprecated and should not be used in newly-written code.


enum GtkMetricType

typedef enum
{
  GTK_PIXELS,
  GTK_INCHES,
  GTK_CENTIMETERS
} GtkMetricType;


enum GtkMovementStep

typedef enum {
  GTK_MOVEMENT_LOGICAL_POSITIONS, /* move by forw/back graphemes */
  GTK_MOVEMENT_VISUAL_POSITIONS,  /* move by left/right graphemes */
  GTK_MOVEMENT_WORDS,             /* move by forward/back words */
  GTK_MOVEMENT_DISPLAY_LINES,     /* move up/down lines (wrapped lines) */
  GTK_MOVEMENT_DISPLAY_LINE_ENDS, /* move up/down lines (wrapped lines) */
  GTK_MOVEMENT_PARAGRAPHS,        /* move up/down paragraphs (newline-ended lines) */
  GTK_MOVEMENT_PARAGRAPH_ENDS,    /* move to either end of a paragraph */
  GTK_MOVEMENT_PAGES,	          /* move by pages */
  GTK_MOVEMENT_BUFFER_ENDS        /* move to ends of the buffer */
} GtkMovementStep;


enum GtkOrientation

typedef enum
{
  GTK_ORIENTATION_HORIZONTAL,
  GTK_ORIENTATION_VERTICAL
} GtkOrientation;


enum GtkPackType

typedef enum
{
  GTK_PACK_START,
  GTK_PACK_END
} GtkPackType;

Represents the packing location GtkBox children. (See: GtkVBox, GtkHBox, and GtkButtonBox).

GTK_PACK_STARTThe child is packed into the start of the box
GTK_PACK_ENDThe child is packed into the end of the box

enum GtkPathPriorityType

typedef enum
{
  GTK_PATH_PRIO_LOWEST      = 0,
  GTK_PATH_PRIO_GTK	    = 4,
  GTK_PATH_PRIO_APPLICATION = 8,
  GTK_PATH_PRIO_THEME       = 10,
  GTK_PATH_PRIO_RC          = 12,
  GTK_PATH_PRIO_HIGHEST     = 15
} GtkPathPriorityType;


enum GtkPathType

typedef enum
{
  GTK_PATH_WIDGET,
  GTK_PATH_WIDGET_CLASS,
  GTK_PATH_CLASS
} GtkPathType;


enum GtkPolicyType

typedef enum
{
  GTK_POLICY_ALWAYS,
  GTK_POLICY_AUTOMATIC,
  GTK_POLICY_NEVER
} GtkPolicyType;

Determines when a scroll bar will be visible.

GTK_POLICY_ALWAYSThe scrollbar is always visible.
GTK_POLICY_AUTOMATICThe scrollbar will appear and disappear as necessary. For example, when all of a GtkCList can not be seen.
GTK_POLICY_NEVERThe scrollbar will never appear.

enum GtkPositionType

typedef enum
{
  GTK_POS_LEFT,
  GTK_POS_RIGHT,
  GTK_POS_TOP,
  GTK_POS_BOTTOM
} GtkPositionType;


enum GtkPreviewType

typedef enum
{
  GTK_PREVIEW_COLOR,
  GTK_PREVIEW_GRAYSCALE
} GtkPreviewType;

Warning

GtkPreviewType is deprecated and should not be used in newly-written code.

An enumeration which describes whether a preview contains grayscale or red-green-blue data.

GTK_PREVIEW_COLORthe preview contains red-green-blue data.
GTK_PREVIEW_GRAYSCALEThe preview contains grayscale data.

enum GtkReliefStyle

typedef enum
{
  GTK_RELIEF_NORMAL,
  GTK_RELIEF_HALF,
  GTK_RELIEF_NONE
} GtkReliefStyle;


enum GtkResizeMode

typedef enum
{
  GTK_RESIZE_PARENT,		/* Pass resize request to the parent */
  GTK_RESIZE_QUEUE,		/* Queue resizes on this widget */
  GTK_RESIZE_IMMEDIATE		/* Perform the resizes now */
} GtkResizeMode;


enum GtkScrollType

typedef enum
{
  GTK_SCROLL_NONE,
  GTK_SCROLL_JUMP,
  GTK_SCROLL_STEP_BACKWARD,
  GTK_SCROLL_STEP_FORWARD,
  GTK_SCROLL_PAGE_BACKWARD,
  GTK_SCROLL_PAGE_FORWARD,
  GTK_SCROLL_STEP_UP,
  GTK_SCROLL_STEP_DOWN,
  GTK_SCROLL_PAGE_UP,
  GTK_SCROLL_PAGE_DOWN,
  GTK_SCROLL_STEP_LEFT,
  GTK_SCROLL_STEP_RIGHT,
  GTK_SCROLL_PAGE_LEFT,
  GTK_SCROLL_PAGE_RIGHT,
  GTK_SCROLL_START,
  GTK_SCROLL_END
} GtkScrollType;


enum GtkSelectionMode

typedef enum
{
  GTK_SELECTION_NONE,                             /* Nothing can be selected */
  GTK_SELECTION_SINGLE,
  GTK_SELECTION_BROWSE,
  GTK_SELECTION_MULTIPLE,
  GTK_SELECTION_EXTENDED = GTK_SELECTION_MULTIPLE /* Deprecated */
} GtkSelectionMode;


enum GtkShadowType

typedef enum
{
  GTK_SHADOW_NONE,
  GTK_SHADOW_IN,
  GTK_SHADOW_OUT,
  GTK_SHADOW_ETCHED_IN,
  GTK_SHADOW_ETCHED_OUT
} GtkShadowType;

Used to change the appearance of an outline typically provided by a GtkFrame.

GTK_SHADOW_NONENo outline.
GTK_SHADOW_INThe outline is bevelled inwards.
GTK_SHADOW_OUTThe outline is bevelled outwards like a button.
GTK_SHADOW_ETCHED_INThe outline itself is an inward bevel, but the frame does
GTK_SHADOW_ETCHED_OUT

enum GtkSideType

typedef enum
{
  GTK_SIDE_TOP,
  GTK_SIDE_BOTTOM,
  GTK_SIDE_LEFT,
  GTK_SIDE_RIGHT
} GtkSideType;

Warning

GtkSideType is deprecated and should not be used in newly-written code.


enum GtkStateType

typedef enum
{
  GTK_STATE_NORMAL,
  GTK_STATE_ACTIVE,
  GTK_STATE_PRELIGHT,
  GTK_STATE_SELECTED,
  GTK_STATE_INSENSITIVE
} GtkStateType;

This type indicates the current state of a widget; the state determines how the widget is drawn. The GtkStateType enumeration is also used to identify different colors in a GtkStyle for drawing, so states can be used for subparts of a widget as well as entire widgets.

GTK_STATE_NORMALState during normal operation.
GTK_STATE_ACTIVEState of a currently active widget, such as a depressed button.
GTK_STATE_PRELIGHTState indicating that the mouse pointer is over the widget and the widget will respond to mouse clicks.
GTK_STATE_SELECTEDState of a selected item, such the selected row in a list.
GTK_STATE_INSENSITIVEState indicating that the widget is unresponsive to user actions.

enum GtkSubmenuDirection

typedef enum
{
  GTK_DIRECTION_LEFT,
  GTK_DIRECTION_RIGHT
} GtkSubmenuDirection;

Warning

GtkSubmenuDirection is deprecated and should not be used in newly-written code.

Indicates the direction a sub-menu will appear.

GTK_DIRECTION_LEFTA sub-menu will appear
GTK_DIRECTION_RIGHT

enum GtkSubmenuPlacement

typedef enum
{
  GTK_TOP_BOTTOM,
  GTK_LEFT_RIGHT
} GtkSubmenuPlacement;

Warning

GtkSubmenuPlacement is deprecated and should not be used in newly-written code.


enum GtkToolbarStyle

typedef enum
{
  GTK_TOOLBAR_ICONS,
  GTK_TOOLBAR_TEXT,
  GTK_TOOLBAR_BOTH,
  GTK_TOOLBAR_BOTH_HORIZ
} GtkToolbarStyle;

Used to customize the appearance of a GtkToolbar. Note that setting the toolbar style overrides the user's preferences for the default toolbar style.

GTK_TOOLBAR_ICONSButtons display only icons in the toolbar.
GTK_TOOLBAR_TEXTButtons display only text labels in the toolbar.
GTK_TOOLBAR_BOTHButtons display text and icons in the toolbar.
GTK_TOOLBAR_BOTH_HORIZButtons display icons and text alongside each other, rather than vertically stacked

enum GtkUpdateType

typedef enum
{
  GTK_UPDATE_CONTINUOUS,
  GTK_UPDATE_DISCONTINUOUS,
  GTK_UPDATE_DELAYED
} GtkUpdateType;


enum GtkVisibility

typedef enum
{
  GTK_VISIBILITY_NONE,
  GTK_VISIBILITY_PARTIAL,
  GTK_VISIBILITY_FULL
} GtkVisibility;


enum GtkWindowPosition

typedef enum
{
  GTK_WIN_POS_NONE,
  GTK_WIN_POS_CENTER,
  GTK_WIN_POS_MOUSE,
  GTK_WIN_POS_CENTER_ALWAYS,
  GTK_WIN_POS_CENTER_ON_PARENT
} GtkWindowPosition;

Window placement can be influenced using this enumeration.

GTK_WIN_POS_NONENo influence is made on placement.
GTK_WIN_POS_CENTERWindows should be placed in the center of the screen.
GTK_WIN_POS_MOUSEWindows should be placed at the current mouse position.
GTK_WIN_POS_CENTER_ALWAYSKeep window centered as it changes size, etc.
GTK_WIN_POS_CENTER_ON_PARENTCenter the window on its transient parent (see gtk_window_set_transient_for()).

enum GtkWindowType

typedef enum
{
  GTK_WINDOW_TOPLEVEL,
  GTK_WINDOW_POPUP
} GtkWindowType;

A GtkWindow can be one of these types. Most things you'd consider a "window" should have type GTK_WINDOW_TOPLEVEL; windows with this type are managed by the window manager and have a frame by default (call gtk_window_set_decorated() to toggle the frame). Windows with type GTK_WINDOW_POPUP are ignored by the window manager; window manager keybindings won't work on them, the window manager won't decorate the window with a frame, many GTK+ features that rely on the window manager will not work (e.g. resize grips and maximization/minimization). GTK_WINDOW_POPUP is used to implement widgets such as GtkMenu or tooltips that you normally don't think of as windows per se. Nearly all windows should be GTK_WINDOW_TOPLEVEL. In particular, do not use GTK_WINDOW_POPUP just to turn off the window borders; use gtk_window_set_decorated() for that.

GTK_WINDOW_TOPLEVELA regular window, such as a dialog.
GTK_WINDOW_POPUPA special window such as a tooltip.

enum GtkSortType

typedef enum
{
  GTK_SORT_ASCENDING,
  GTK_SORT_DESCENDING
} GtkSortType;

Determines the direction of a sort.

GTK_SORT_ASCENDINGSorting is in ascending order.
GTK_SORT_DESCENDINGSorting is in descending order.