forked from AuroraMiddleware/gtk
d07573c090
Mon Nov 12 23:06:38 2001 Tim Janik <timj@gtk.org>
* added gtkaccelmap.sgml. other updates.
Mon Nov 12 23:08:37 2001 Tim Janik <timj@gtk.org>
* gtk/maketypes.awk: fix type utils generation on unix.
* gtk/gtkaccelmap.[hc]: new files, implementing a global accelerator
registry.
* gtk/gtkaccelgroup.[hc]: major API/implementation revamp:
removed GTK_ACCEL_SIGNAL_VISIBLE, gtk_accel_group_get_default,
gtk_accel_group_get_entry, gtk_accel_group_(un)lock_entry,
gtk_accel_group_add/remove, gtk_accel_group_handle_add/remove,
gtk_accel_group_create_add/remove, gtk_accel_group_entries_from_object.
introduced ::accel_changed signal for change notification, and
gtk_accel_group_connect/disconnect to connect closures to accel groups.
made gtk_accel_group_attach/detach and gtk_accel_group_activate private
functions.
deprecated gtk_accel_group_ref/unref.
* gtk/gtkaccellabel.[hc]: changes to make accellabels pay attention
to accel group changed notification and basically operate on closures.
removed gtk_accel_label_get_accel_object and
gtk_accel_label_set_accel_object.
introduced gtk_accel_label_set_accel_closure, and for convenience,
gtk_accel_label_set_accel_widget.
* gtk/gtkitemfactory.[hc]: removed accelerator propagation code
which mostly moved into gtkaccelmap.[hc].
removed gtk_item_factory_parse_rc*, gtk_item_factory_dump_*
and gtk_item_factory_print_func.
* gtk/gtkmain.c: call _gtk_accel_map_init().
* gtk/gtkmenuitem.[hc]: introduced gtk_menu_item_set_accel_path(),
that associates an accelerator path with menu items, through which
persistent accelerator settings on menu items are enabled.
* gtk/gtkmenu.[hc]: added gtk_menu_set_accel_path() so accelerator
paths of menu item can be default constructed to allow installation
of accelerators on menu items that don't come with an accelerator
binding by default.
* gtk/gtksettings.c: fix STRING type rc settings by special casing
them appropriately in the parser.
* gtk/gtksignal.[hc]: allow a class function offset of 0 for
gtk_signal_newv().
* gtk/gtkwidget.[hc]: accelerator API revamp.
removed ::accelerator_add/remove signals, gtk_widget_accelerator_signal,
gtk_widget_accelerators_locked, gtk_widget_remove_accelerators and
gtk_widget_(un)lock_accelerators.
accelerators maintained through gtk_widget_add/remove_accelerator()
are not runtime changable now, the correct sequence to setup a
widget for runtime changable accelerators is now:
gtk_accel_map_add_entry(accel_path, key, mods);
_gtk_widget_set_accel_path(widget, accel_path, accel_group);
* gtk/gtkwindow.[hc]: accelerator changes, proxy and coalesce accel
group changes (as well as mnemonic changes) through the new signal
::accels_changed.
Sat Nov 10 12:08:56 2001 Tim Janik <timj@gtk.org>
* gtk/gtksettings.c (_gtk_settings_parse_convert): properly handle
GString->string conversions.
402 lines
10 KiB
Plaintext
402 lines
10 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
Standard Enumerations
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Public enumerated types used throughout GTK+.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ENUM GtkAccelFlags ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_ACCEL_VISIBLE:
|
|
@GTK_ACCEL_LOCKED:
|
|
@GTK_ACCEL_MASK:
|
|
|
|
<!-- ##### ENUM GtkArrowType ##### -->
|
|
<para>
|
|
Used to indicate the direction in which a #GtkArrow should point.
|
|
</para>
|
|
|
|
@GTK_ARROW_UP: Represents an upward pointing arrow.
|
|
@GTK_ARROW_DOWN: Represents a downward pointing arrow.
|
|
@GTK_ARROW_LEFT: Represents a left pointing arrow.
|
|
@GTK_ARROW_RIGHT: Represents a right pointing arrow.
|
|
|
|
<!-- ##### ENUM GtkAttachOptions ##### -->
|
|
<para>
|
|
Denotes the expansion properties that a widget will have when it (or it's
|
|
parent) is resized.
|
|
</para>
|
|
|
|
@GTK_EXPAND: the widget should expand to take up any extra space in its
|
|
container that has been allocated.
|
|
@GTK_SHRINK: the widget should shrink as and when possible.
|
|
@GTK_FILL: the widget should fill the space allocated to it.
|
|
|
|
<!-- ##### ENUM GtkButtonBoxStyle ##### -->
|
|
<para>
|
|
Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
|
|
contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
|
|
</para>
|
|
|
|
@GTK_BUTTONBOX_DEFAULT_STYLE: Default packing.
|
|
@GTK_BUTTONBOX_SPREAD: Buttons are evenly spread across the ButtonBox.
|
|
@GTK_BUTTONBOX_EDGE: Buttons are placed at the edges of the ButtonBox.
|
|
@GTK_BUTTONBOX_START: Buttons are grouped towards the start of box, (on the
|
|
left for a HBox, or the top for a VBox).
|
|
@GTK_BUTTONBOX_END: Buttons are grouped towards the end of a box, (on the
|
|
right for a HBox, or the bottom for a VBox).
|
|
|
|
<!-- ##### ENUM GtkCornerType ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@GTK_CORNER_TOP_LEFT: Place the scrollbars on the right and bottom of the
|
|
widget (default behaviour).
|
|
@GTK_CORNER_BOTTOM_LEFT: Place the scrollbars on the top and right of the
|
|
widget.
|
|
@GTK_CORNER_TOP_RIGHT: Place the scrollbars on the left and bottom of the
|
|
widget.
|
|
@GTK_CORNER_BOTTOM_RIGHT: Place the scrollbars on the top and left of the
|
|
widget.
|
|
|
|
<!-- ##### ENUM GtkCurveType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_CURVE_TYPE_LINEAR:
|
|
@GTK_CURVE_TYPE_SPLINE:
|
|
@GTK_CURVE_TYPE_FREE:
|
|
|
|
<!-- ##### ENUM GtkDeleteType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_DELETE_CHARS:
|
|
@GTK_DELETE_WORD_ENDS:
|
|
@GTK_DELETE_WORDS:
|
|
@GTK_DELETE_DISPLAY_LINES:
|
|
@GTK_DELETE_DISPLAY_LINE_ENDS:
|
|
@GTK_DELETE_PARAGRAPH_ENDS:
|
|
@GTK_DELETE_PARAGRAPHS:
|
|
@GTK_DELETE_WHITESPACE:
|
|
|
|
<!-- ##### ENUM GtkDirectionType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_DIR_TAB_FORWARD:
|
|
@GTK_DIR_TAB_BACKWARD:
|
|
@GTK_DIR_UP:
|
|
@GTK_DIR_DOWN:
|
|
@GTK_DIR_LEFT:
|
|
@GTK_DIR_RIGHT:
|
|
|
|
<!-- ##### ENUM GtkExpanderStyle ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_EXPANDER_COLLAPSED:
|
|
@GTK_EXPANDER_SEMI_COLLAPSED:
|
|
@GTK_EXPANDER_SEMI_EXPANDED:
|
|
@GTK_EXPANDER_EXPANDED:
|
|
|
|
<!-- ##### ENUM GtkJustification ##### -->
|
|
<para>
|
|
Used for justifying the text inside a #GtkLabel widget. (See also
|
|
#GtkAlignment).
|
|
</para>
|
|
|
|
@GTK_JUSTIFY_LEFT: The text is placed at the left edge of the label.
|
|
@GTK_JUSTIFY_RIGHT: The text is placed at the right edge of the label.
|
|
@GTK_JUSTIFY_CENTER: The text is placed in the center of the label.
|
|
@GTK_JUSTIFY_FILL: The text is placed is distributed across the label.
|
|
|
|
<!-- ##### ENUM GtkMatchType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_MATCH_ALL:
|
|
@GTK_MATCH_ALL_TAIL:
|
|
@GTK_MATCH_HEAD:
|
|
@GTK_MATCH_TAIL:
|
|
@GTK_MATCH_EXACT:
|
|
@GTK_MATCH_LAST:
|
|
|
|
<!-- ##### ENUM GtkMetricType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_PIXELS:
|
|
@GTK_INCHES:
|
|
@GTK_CENTIMETERS:
|
|
|
|
<!-- ##### ENUM GtkMovementStep ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@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:
|
|
|
|
<!-- ##### ENUM GtkOrientation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_ORIENTATION_HORIZONTAL:
|
|
@GTK_ORIENTATION_VERTICAL:
|
|
|
|
<!-- ##### ENUM GtkPackType ##### -->
|
|
<para>
|
|
Represents the packing location #GtkBox children. (See: #GtkVBox,
|
|
#GtkHBox, and #GtkButtonBox).
|
|
</para>
|
|
|
|
@GTK_PACK_START: The child is packed into the start of the box
|
|
@GTK_PACK_END: The child is packed into the end of the box
|
|
|
|
<!-- ##### ENUM GtkPathPriorityType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_PATH_PRIO_LOWEST:
|
|
@GTK_PATH_PRIO_GTK:
|
|
@GTK_PATH_PRIO_APPLICATION:
|
|
@GTK_PATH_PRIO_THEME:
|
|
@GTK_PATH_PRIO_RC:
|
|
@GTK_PATH_PRIO_HIGHEST:
|
|
|
|
<!-- ##### ENUM GtkPathType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_PATH_WIDGET:
|
|
@GTK_PATH_WIDGET_CLASS:
|
|
@GTK_PATH_CLASS:
|
|
|
|
<!-- ##### ENUM GtkPolicyType ##### -->
|
|
<para>
|
|
Determines when a scroll bar will be visible.
|
|
</para>
|
|
|
|
@GTK_POLICY_ALWAYS: The scrollbar is always visible.
|
|
@GTK_POLICY_AUTOMATIC: The scrollbar will appear and disappear as necessary. For example,
|
|
when all of a #GtkCList can not be seen.
|
|
@GTK_POLICY_NEVER: The scrollbar will never appear.
|
|
|
|
<!-- ##### ENUM GtkPositionType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_POS_LEFT:
|
|
@GTK_POS_RIGHT:
|
|
@GTK_POS_TOP:
|
|
@GTK_POS_BOTTOM:
|
|
|
|
<!-- ##### ENUM GtkPreviewType ##### -->
|
|
<para>
|
|
An enumeration which describes whether a preview
|
|
contains grayscale or red-green-blue data.
|
|
</para>
|
|
|
|
@GTK_PREVIEW_COLOR: the preview contains red-green-blue data.
|
|
@GTK_PREVIEW_GRAYSCALE: The preview contains grayscale data.
|
|
|
|
<!-- ##### ENUM GtkReliefStyle ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_RELIEF_NORMAL:
|
|
@GTK_RELIEF_HALF:
|
|
@GTK_RELIEF_NONE:
|
|
|
|
<!-- ##### ENUM GtkResizeMode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_RESIZE_PARENT:
|
|
@GTK_RESIZE_QUEUE:
|
|
@GTK_RESIZE_IMMEDIATE:
|
|
|
|
<!-- ##### ENUM GtkScrollType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@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:
|
|
|
|
<!-- ##### ENUM GtkSelectionMode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_SELECTION_NONE:
|
|
@GTK_SELECTION_SINGLE:
|
|
@GTK_SELECTION_BROWSE:
|
|
@GTK_SELECTION_MULTIPLE:
|
|
@GTK_SELECTION_EXTENDED:
|
|
|
|
<!-- ##### ENUM GtkShadowType ##### -->
|
|
<para>
|
|
Used to change the appearance of an outline typically provided by a #GtkFrame.
|
|
</para>
|
|
|
|
@GTK_SHADOW_NONE: No outline.
|
|
@GTK_SHADOW_IN: The outline is bevelled inwards.
|
|
@GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
|
|
@GTK_SHADOW_ETCHED_IN: The outline itself is an inward bevel, but the frame
|
|
does
|
|
@GTK_SHADOW_ETCHED_OUT:
|
|
|
|
<!-- ##### ENUM GtkStateType ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@GTK_STATE_NORMAL: State during normal operation.
|
|
@GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button.
|
|
@GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over
|
|
the widget and the widget will respond to mouse clicks.
|
|
@GTK_STATE_SELECTED: State of a selected item, such the selected row in a list.
|
|
@GTK_STATE_INSENSITIVE: State indicating that the widget is
|
|
unresponsive to user actions.
|
|
|
|
<!-- ##### ENUM GtkSubmenuDirection ##### -->
|
|
<para>
|
|
Indicates the direction a sub-menu will appear.
|
|
</para>
|
|
|
|
@GTK_DIRECTION_LEFT: A sub-menu will appear
|
|
@GTK_DIRECTION_RIGHT:
|
|
|
|
<!-- ##### ENUM GtkSubmenuPlacement ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_TOP_BOTTOM:
|
|
@GTK_LEFT_RIGHT:
|
|
|
|
<!-- ##### ENUM GtkToolbarStyle ##### -->
|
|
<para>
|
|
Used to customize the appearance of a #GtkToolbar. Note that
|
|
setting the toolbar style overrides the user's preferences
|
|
for the default toolbar style.
|
|
</para>
|
|
|
|
@GTK_TOOLBAR_ICONS: Buttons display only icons in the toolbar.
|
|
@GTK_TOOLBAR_TEXT: Buttons display only text labels in the toolbar.
|
|
@GTK_TOOLBAR_BOTH: Buttons display text and icons in the toolbar.
|
|
@GTK_TOOLBAR_BOTH_HORIZ: Buttons display icons and text alongside each
|
|
other, rather than vertically stacked
|
|
|
|
<!-- ##### ENUM GtkUpdateType ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_UPDATE_CONTINUOUS:
|
|
@GTK_UPDATE_DISCONTINUOUS:
|
|
@GTK_UPDATE_DELAYED:
|
|
|
|
<!-- ##### ENUM GtkVisibility ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GTK_VISIBILITY_NONE:
|
|
@GTK_VISIBILITY_PARTIAL:
|
|
@GTK_VISIBILITY_FULL:
|
|
|
|
<!-- ##### ENUM GtkWindowPosition ##### -->
|
|
<para>
|
|
Window placement can be influenced using this enumeration.
|
|
</para>
|
|
|
|
@GTK_WIN_POS_NONE: No influence is made on placement.
|
|
@GTK_WIN_POS_CENTER: Windows should be placed in the center of the screen.
|
|
@GTK_WIN_POS_MOUSE: Windows should be placed at the current mouse position.
|
|
@GTK_WIN_POS_CENTER_ALWAYS: Keep window centered as it changes size, etc.
|
|
@GTK_WIN_POS_CENTER_ON_PARENT: Center the window on its transient
|
|
parent (see gtk_window_set_transient_for()).
|
|
|
|
<!-- ##### ENUM GtkWindowType ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@GTK_WINDOW_TOPLEVEL: A regular window, such as a dialog.
|
|
@GTK_WINDOW_POPUP: A special window such as a tooltip.
|
|
|
|
<!-- ##### ENUM GtkSortType ##### -->
|
|
<para>
|
|
Determines the direction of a sort.
|
|
</para>
|
|
|
|
@GTK_SORT_ASCENDING: Sorting is in ascending order.
|
|
@GTK_SORT_DESCENDING: Sorting is in descending order.
|
|
|