GTK+ Reference Manual |
||||
---|---|---|---|---|
Стандартные перечисленияStandard Enumerations Общие перечисления типов используемые повсеместно в GTK+ |
#include <gtk/gtk.h>
перечислимый тип GtkAccelFlags;
перечислимый тип GtkAnchorType;
перечислимый тип GtkArrowType;
перечислимый тип GtkAttachOptions;
перечислимый тип GtkButtonBoxStyle;
перечислимый тип GtkCornerType;
перечислимый тип GtkCurveType;
перечислимый тип GtkDeleteType;
перечислимый тип GtkDirectionType;
перечислимый тип GtkExpanderStyle;
перечислимый тип GtkIMPreeditStyle;
перечислимый тип GtkIMStatusStyle;
перечислимый тип GtkJustification;
перечислимый тип GtkMatchType;
перечислимый тип GtkMetricType;
перечислимый тип GtkMovementStep;
перечислимый тип GtkOrientation;
перечислимый тип GtkPackType;
перечислимый тип GtkPathPriorityType;
перечислимый тип GtkPathType;
перечислимый тип GtkPolicyType;
перечислимый тип GtkPositionType;
перечислимый тип GtkPreviewType;
перечислимый тип GtkReliefStyle;
перечислимый тип GtkResizeMode;
перечислимый тип GtkScrollStep;
перечислимый тип GtkScrollType;
перечислимый тип GtkSelectionMode;
перечислимый тип GtkShadowType;
перечислимый тип GtkSideType;
перечислимый тип GtkStateType;
перечислимый тип GtkSubmenuDirection;
перечислимый тип GtkSubmenuPlacement;
перечислимый тип GtkToolbarStyle;
перечислимый тип GtkUpdateType;
перечислимый тип GtkVisibility;
перечислимый тип GtkWindowPosition;
перечислимый тип GtkWindowType;
перечислимый тип GtkSortType;
typedef enum
{
GTK_ACCEL_VISIBLE = 1 << 0, /* display in GtkAccelLabel? */
GTK_ACCEL_LOCKED = 1 << 1, /* is it removable? */
GTK_ACCEL_MASK = 0x07
} GtkAccelFlags;
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;
typedef enum
{
GTK_ARROW_UP,
GTK_ARROW_DOWN,
GTK_ARROW_LEFT,
GTK_ARROW_RIGHT
} GtkArrowType;
Используется для индикации направления в котором должен указывать GtkArrow.
GTK_ARROW_UP |
Представляет направленную вверх стрелку. |
GTK_ARROW_DOWN |
Представляет направленную вниз стрелку. |
GTK_ARROW_LEFT |
Представляет направленную влево стрелку. |
GTK_ARROW_RIGHT |
Представляет направленную вправо стрелку. |
typedef enum
{
GTK_EXPAND = 1 << 0,
GTK_SHRINK = 1 << 1,
GTK_FILL = 1 << 2
} GtkAttachOptions;
Обозначает расширенные свойства виджета (или его родителя) при изменении размера.
GTK_EXPAND |
Виджет должен заменять всё свободное пространство контейнера в котором он находится. |
GTK_SHRINK |
Виджет должен сжаться насколько и когда это возможно. |
GTK_FILL |
Виджет должен заполнить всё распределённое пространство. |
typedef enum
{
GTK_BUTTONBOX_DEFAULT_STYLE,
GTK_BUTTONBOX_SPREAD,
GTK_BUTTONBOX_EDGE,
GTK_BUTTONBOX_START,
GTK_BUTTONBOX_END
} GtkButtonBoxStyle;
Используется для установки стиля который используют кнопки находящиеся в GtkButtonBox. (Смотрите также: GtkVButtonBox и GtkHButtonBox).
GTK_BUTTONBOX_DEFAULT_STYLE |
Упаковка по умолчанию. |
GTK_BUTTONBOX_SPREAD |
Кнопки равномерно распределяются поперек ButtonBox. |
GTK_BUTTONBOX_EDGE |
Кнопки размещаются на краях ButtonBox. |
GTK_BUTTONBOX_START |
Кнопки группируются в начале контейнера, (слева для HBox, или вверху для VBox). |
GTK_BUTTONBOX_END |
Кнопки группируются в конце контейнера, (справа для HBox, или снизу для VBox). |
typedef enum
{
GTK_CORNER_TOP_LEFT,
GTK_CORNER_BOTTOM_LEFT,
GTK_CORNER_TOP_RIGHT,
GTK_CORNER_BOTTOM_RIGHT
} GtkCornerType;
Определяет в кокой угол должен размещаться дочерний виджет при упаковке в GtkScrolledWindow. Это фактически противоположность того, куда размещаются полосы прокрутки.
GTK_CORNER_TOP_LEFT |
Размещает полосу прокрутки справа и в основании виджета (по умолчанию). |
GTK_CORNER_BOTTOM_LEFT |
Размещает полосу прокрутки вверху и справа виджета. |
GTK_CORNER_TOP_RIGHT |
Размещает полосу прокрутки слева и в основании виджета |
GTK_CORNER_BOTTOM_RIGHT |
Размещает полосу прокрутки вверху и слева виджета. |
typedef enum
{
GTK_CURVE_TYPE_LINEAR, /* линейная интерполяция */
GTK_CURVE_TYPE_SPLINE, /* сплайн интерполяция */
GTK_CURVE_TYPE_FREE /* свободная форма кривой */
} GtkCurveType;
typedef enum {
GTK_DELETE_CHARS,
GTK_DELETE_WORD_ENDS, /* удаляет только часть слова
* слева/справа от курсора, если он находится
* в середине слова */
GTK_DELETE_WORDS,
GTK_DELETE_DISPLAY_LINES,
GTK_DELETE_DISPLAY_LINE_ENDS,
GTK_DELETE_PARAGRAPH_ENDS, /* Как C-k в Emacs (или обратно) */
GTK_DELETE_PARAGRAPHS, /* C-k как в pico, уничтожает целую линию */
GTK_DELETE_WHITESPACE /* M-\ как в Emacs */
} GtkDeleteType;
typedef enum
{
GTK_DIR_TAB_FORWARD,
GTK_DIR_TAB_BACKWARD,
GTK_DIR_UP,
GTK_DIR_DOWN,
GTK_DIR_LEFT,
GTK_DIR_RIGHT
} GtkDirectionType;
typedef enum
{
GTK_EXPANDER_COLLAPSED,
GTK_EXPANDER_SEMI_COLLAPSED,
GTK_EXPANDER_SEMI_EXPANDED,
GTK_EXPANDER_EXPANDED
} GtkExpanderStyle;
Используется для определения стиля расширяющего отрисовку GtkTreeView.
GTK_EXPANDER_COLLAPSED |
Стиль используемый для сокращенного поддерева. |
GTK_EXPANDER_SEMI_COLLAPSED |
Промежуточный стиль, используемый во время анимации. |
GTK_EXPANDER_SEMI_EXPANDED |
Промежуточный стиль, используемый во время анимации. |
GTK_EXPANDER_EXPANDED |
Стиль используемый для расширенного поддерева. |
typedef enum
{
GTK_IM_PREEDIT_NOTHING,
GTK_IM_PREEDIT_CALLBACK,
GTK_IM_PREEDIT_NONE
} GtkIMPreeditStyle;
typedef enum
{
GTK_IM_STATUS_NOTHING,
GTK_IM_STATUS_CALLBACK,
GTK_IM_STATUS_NONE
} GtkIMStatusStyle;
typedef enum
{
GTK_JUSTIFY_LEFT,
GTK_JUSTIFY_RIGHT,
GTK_JUSTIFY_CENTER,
GTK_JUSTIFY_FILL
} GtkJustification;
Используется для выравнивания текста в виджете GtkLabel. (См. также GtkAlignment).
GTK_JUSTIFY_LEFT |
Текст размещается на левом краю ярлыка. |
GTK_JUSTIFY_RIGHT |
Текст размещается на правом краю ярлыка. |
GTK_JUSTIFY_CENTER |
Текст размещается по центру ярлыка. |
GTK_JUSTIFY_FILL |
Текст размещается поперёк ярлыка. |
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;
GtkMatchType устарел и не должен использоваться во вновь создаваемом коде.
typedef enum
{
GTK_PIXELS,
GTK_INCHES,
GTK_CENTIMETERS
} GtkMetricType;
Используется для индикации меры используемой GtkRuler.
GTK_PIXELS |
Пикселы. |
GTK_INCHES |
Дюймы. |
GTK_CENTIMETERS |
Сантимеетры. |
typedef enum
{
GTK_MOVEMENT_LOGICAL_POSITIONS, /* перемещение вперёд/назад графемами */
GTK_MOVEMENT_VISUAL_POSITIONS, /* перемещение влево/вправо графемами */
GTK_MOVEMENT_WORDS, /* перемещение вперёд/назад словами */
GTK_MOVEMENT_DISPLAY_LINES, /* перемещение вверх/вниз линиями (окантованные линии) */
GTK_MOVEMENT_DISPLAY_LINE_ENDS, /* перемещение вверх/вниз линиями (окантованные линии) */
GTK_MOVEMENT_PARAGRAPHS, /* перемещение вверх/вниз параграфами (Заканчивающихся линией с новой строкой)*/
GTK_MOVEMENT_PARAGRAPH_ENDS, /* перемещение в любой конец параграфа */
GTK_MOVEMENT_PAGES, /* постраничное перемещение */
GTK_MOVEMENT_BUFFER_ENDS, /* перемещение в конец буфера */
GTK_MOVEMENT_HORIZONTAL_PAGES /* перемещение горизонтальными страницами */
} GtkMovementStep;
typedef enum
{
GTK_ORIENTATION_HORIZONTAL,
GTK_ORIENTATION_VERTICAL
} GtkOrientation;
Представляет ориентацию виджетов, которая может переключаться на лету между горизонтальной и вертикальной, как GtkToolbar.
GTK_ORIENTATION_HORIZONTAL |
Виджет в горизонтальной ориентации. |
GTK_ORIENTATION_VERTICAL |
Виджет в вертикальной ориентации. |
typedef enum
{
GTK_PACK_START,
GTK_PACK_END
} GtkPackType;
Представляет размещение упаковки дочерних виджетов GtkBox. (См.: GtkVBox, GtkHBox и GtkButtonBox).
GTK_PACK_START |
Упаковывается в начало контейнера |
GTK_PACK_END |
Упаковывается в конец контейнера |
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;
typedef enum
{
GTK_PATH_WIDGET,
GTK_PATH_WIDGET_CLASS,
GTK_PATH_CLASS
} GtkPathType;
typedef enum
{
GTK_POLICY_ALWAYS,
GTK_POLICY_AUTOMATIC,
GTK_POLICY_NEVER
} GtkPolicyType;
Определяет когда полоса прокрутки отображается.
GTK_POLICY_ALWAYS |
Полоса прокрутки отображается всегда. |
GTK_POLICY_AUTOMATIC |
Полоса прокрутки отображается и скрывается при необходимости. Например, когда все объекты GtkCList не могут быть видимы. |
GTK_POLICY_NEVER |
Полоса прокрутки никогда не отображается. |
typedef enum
{
GTK_POS_LEFT,
GTK_POS_RIGHT,
GTK_POS_TOP,
GTK_POS_BOTTOM
} GtkPositionType;
Определяет особенность расположения края виджета, например вкладки у GtkNotebook, маркеры у GtkHandleBox или ярлык у GtkScale.
GTK_POS_LEFT |
Левый край. |
GTK_POS_RIGHT |
Правый край. |
GTK_POS_TOP |
Верхний край. |
GTK_POS_BOTTOM |
Нижний край. |
typedef enum
{
GTK_PREVIEW_COLOR,
GTK_PREVIEW_GRAYSCALE
} GtkPreviewType;
GtkPreviewType устарел и не должен использоваться во вновь создаваемом коде.
Перечисление описывающее содержит ли предварительный просмотр полутона или red-green-blue данные.
GTK_PREVIEW_COLOR |
Предварительный просмотр содержит red-green-blue данные. |
GTK_PREVIEW_GRAYSCALE |
Предварительный просмотр содержит полутона. |
typedef enum
{
GTK_RELIEF_NORMAL,
GTK_RELIEF_HALF,
GTK_RELIEF_NONE
} GtkReliefStyle;
Индикация отрисовываемого рельефа вокруг GtkButton.
GTK_RELIEF_NORMAL |
Отрисовывается нормальный рельеф. |
GTK_RELIEF_HALF |
Половина рельефа. |
GTK_RELIEF_NONE |
Нет рельефа. |
typedef enum
{
GTK_RESIZE_PARENT, /* Проход изменения размера запроса к родителю */
GTK_RESIZE_QUEUE, /* Очередь изменения размера на этом виджете */
GTK_RESIZE_IMMEDIATE /* Выполняет изменение размера немедленно */
} GtkResizeMode;
GTK_RESIZE_PARENT |
|
GTK_RESIZE_QUEUE |
|
GTK_RESIZE_IMMEDIATE |
Устарел. |
typedef enum
{
GTK_SCROLL_STEPS,
GTK_SCROLL_PAGES,
GTK_SCROLL_ENDS,
GTK_SCROLL_HORIZONTAL_STEPS,
GTK_SCROLL_HORIZONTAL_PAGES,
GTK_SCROLL_HORIZONTAL_ENDS
} GtkScrollStep;
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;
typedef enum
{
GTK_SELECTION_NONE, /* Не выделяется */
GTK_SELECTION_SINGLE,
GTK_SELECTION_BROWSE,
GTK_SELECTION_MULTIPLE,
GTK_SELECTION_EXTENDED = GTK_SELECTION_MULTIPLE /* Не используется */
} GtkSelectionMode;
Используется для контроля создаваемых пользователем выделенных областей.
GTK_SELECTION_NONE |
Нет возможности выделить область. |
GTK_SELECTION_SINGLE |
Ноль или один элемент может быть выделен. |
GTK_SELECTION_BROWSE |
Точно один элемент выделяется. При некоторых обстоятельствах, таких как инициализированная или текущая операция поиска, ни какой элемент не может быть выделен с помощью GTK_SELECTION_BROWSE. В действительности предписывается, что пользователь может изменять выделение только выбрав другой элемент. |
GTK_SELECTION_MULTIPLE |
Любое количество элементов может быть выделено. Клики переключают состояние элементов. Клавиша Ctrl может использоваться для увеличения выделения, а Shift для выделения между точками находящимся в одном фокусе. Некоторые виджеты могут также позволить перемещающемся щелчком (Click-drag) выделить диапазон элементов. |
GTK_SELECTION_EXTENDED |
Устарел, аналог GTK_SELECTION_MULTIPLE. |
typedef enum
{
GTK_SHADOW_NONE,
GTK_SHADOW_IN,
GTK_SHADOW_OUT,
GTK_SHADOW_ETCHED_IN,
GTK_SHADOW_ETCHED_OUT
} GtkShadowType;
Используется для изменения вида контура типично обеспечиваемого GtkFrame.
GTK_SHADOW_NONE |
Нет контура. |
GTK_SHADOW_IN |
Контур скошен внутрь. |
GTK_SHADOW_OUT |
Контур скошен наружу как у кнопок. |
GTK_SHADOW_ETCHED_IN |
Контур внутренне скошен сам, но рамку делает |
GTK_SHADOW_ETCHED_OUT |
typedef enum
{
GTK_SIDE_TOP,
GTK_SIDE_BOTTOM,
GTK_SIDE_LEFT,
GTK_SIDE_RIGHT
} GtkSideType;
GtkSideType устарел и не должен использоваться во вновь создаваемом коде.
typedef enum
{
GTK_STATE_NORMAL,
GTK_STATE_ACTIVE,
GTK_STATE_PRELIGHT,
GTK_STATE_SELECTED,
GTK_STATE_INSENSITIVE
} GtkStateType;
Этот тип указывает текущеме состояние виджета; состояние определяет как отрисовывать виджет. GtkStateType перечисление используется также для идентификации разных цветов в GtkStyle для отрисовки, таким образом состояние может использоваться для подразделов виджета также как всех виджетов.
GTK_STATE_NORMAL |
Состояние в течении нормальной опрации. |
GTK_STATE_ACTIVE |
Состояние текущемго активного виджета, такого как нажатая кнопка. |
GTK_STATE_PRELIGHT |
Состояние указывающее на то, что указатель мыши находится на виджете и он отреагирует на щелчок мыши. |
GTK_STATE_SELECTED |
Состояние выделенного элемента, например выбранная строка в списке. |
GTK_STATE_INSENSITIVE |
Состояние указывающее на игнорирование действий пользователя виджетом. |
typedef enum
{
GTK_DIRECTION_LEFT,
GTK_DIRECTION_RIGHT
} GtkSubmenuDirection;
GtkSubmenuDirection устарел и не должен использоваться во вновь создаваемом коде.
Указывает направление появления подменю.
GTK_DIRECTION_LEFT |
Подменю появляется слева. |
GTK_DIRECTION_RIGHT |
Подменю появляется справа. |
typedef enum
{
GTK_TOP_BOTTOM,
GTK_LEFT_RIGHT
} GtkSubmenuPlacement;
GtkSubmenuPlacement устарел и не должен использоваться во вновь создаваемом коде.
typedef enum
{
GTK_TOOLBAR_ICONS,
GTK_TOOLBAR_TEXT,
GTK_TOOLBAR_BOTH,
GTK_TOOLBAR_BOTH_HORIZ
} GtkToolbarStyle;
Используется для настройки внешнего вида GtkToolbar. Заметьте, что настройка стиля панели инструментов отменяет пользовательские настройки для стиля панели инструментов по умолчанию. Если кнопка имеет только установленный ярлык и используется GTK_TOOLBAR_ICONS, ярлык будет отображён, и наобарот.
GTK_TOOLBAR_ICONS |
В панели инструментов на кнопках отображаются только значки. |
GTK_TOOLBAR_TEXT |
На кнопках отображается только текст. |
GTK_TOOLBAR_BOTH |
На кнопках отображается текст и значки. |
GTK_TOOLBAR_BOTH_HORIZ |
На кнопках отображается текст рядом со значками, а не вертикально в стеке. |
typedef enum
{
GTK_UPDATE_CONTINUOUS,
GTK_UPDATE_DISCONTINUOUS,
GTK_UPDATE_DELAYED
} GtkUpdateType;
typedef enum
{
GTK_VISIBILITY_NONE,
GTK_VISIBILITY_PARTIAL,
GTK_VISIBILITY_FULL
} GtkVisibility;
Используется виджетами GtkCList и GtkCTree для указания видны ли строки.
GTK_VISIBILITY_NONE |
Строки невидимы. |
GTK_VISIBILITY_PARTIAL |
Строки частично видимы. |
GTK_VISIBILITY_FULL |
Строки полностью видимы. |
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;
Используя это перечисление можно влиять на размещение окна.
GTK_WIN_POS_NONE |
Нет влияния на размещение. |
GTK_WIN_POS_CENTER |
Окно должно быть расположено в центре экрана. |
GTK_WIN_POS_MOUSE |
Окно должно расположиться в текущемй позиции курсора мышки. |
GTK_WIN_POS_CENTER_ALWAYS |
Отцентрировать окно изменяя размер, и т.п. |
GTK_WIN_POS_CENTER_ON_PARENT |
Центровать окно на его переходном родителе (см. gtk_window_set_transient_for()). |
typedef enum
{
GTK_WINDOW_TOPLEVEL,
GTK_WINDOW_POPUP
} GtkWindowType;
GtkWindow может быть одним из этих типов. Большинство вещей рассматриваемых вами как "window" должны иметь тип GTK_WINDOW_TOPLEVEL; окна этого типа управляются менеджером окон и имеют фрейм по умолчанию (вызовите gtk_window_set_decorated() чтобы переключить фрейм). Окна с типом GTK_WINDOW_POPUP игнорируют менеджера окон;привязки клавиш менеджера окон не будут работать на них, рамка не будет декорироваться менеджером окон, многие GTK+ особенности менеджера не будут работать (например изменяемый размер захватом и минимизация/максимизация). GTK_WINDOW_POPUP используется для таких виджетов как GtkMenu или подсказки, которые не являются окнами в нормальном понимании этого термина. Почти все окна должны быть GTK_WINDOW_TOPLEVEL. В частности не используйте GTK_WINDOW_POPUP только, чтобы выключить границы окна; используйте gtk_window_set_decorated() для этого.
GTK_WINDOW_TOPLEVEL |
Обычное окно, такое как диалог. |
GTK_WINDOW_POPUP |
Специальное окно, такое как подсказка. |
typedef enum
{
GTK_SORT_ASCENDING,
GTK_SORT_DESCENDING
} GtkSortType;
Определяет направление сортировки.
GTK_SORT_ASCENDING |
Сортировать в порядке возрастания. |
GTK_SORT_DESCENDING |
Сортировать в порядке убывания. |