forked from AuroraMiddleware/gtk
356df7f650
Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk> * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make this function take an index and a GtkToolItem. * tests/testtoolbar.c (main): Make "Show Arrow" default to true. Make one of the separators !draw and expand. Update for new highlight_drop_location() API. * gtk/gtktoolitem.[ch]: Remove "pack_end" property * gtk/gtktoolbar.h: Formatting fixes. * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow separator tool items to expand. (logical_to_physical, physical_to_logical): Fix off-by-one errors (Fix #125472, Marco Pesenti Gritti) * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property. (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also return FALSE, not TRUE. (gtk_separator_too_item_{set|get}_property, (gtk_separator_tool_item_{set|get}_draw): new functions
250 lines
4.3 KiB
Plaintext
250 lines
4.3 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkAction
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
an action which can be triggered by a menu or toolbar item
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
Actions represent operations that the user can be perform, along with
|
|
some information how it should be presented in the interface. Each action
|
|
provides methods to create icons, menu items and toolbar items representing
|
|
itself.
|
|
</para>
|
|
<para>
|
|
As well as the callback that is called when the action gets activated, the
|
|
following also gets associated with the action:
|
|
<itemizedlist>
|
|
<listitem><para>a name (not translated, for path lookup)</para></listitem>
|
|
<listitem><para>a label (translated, for display)</para></listitem>
|
|
<listitem><para>an accelerator</para></listitem>
|
|
<listitem><para>whether label indicates a stock id</para></listitem>
|
|
<listitem><para>a tooltip (optional, translated)</para></listitem>
|
|
<listitem><para>a toolbar label (optional, shorter than label)</para></listitem>
|
|
</itemizedlist>
|
|
The action will also have some state information:
|
|
<itemizedlist>
|
|
<listitem><para>visible (shown/hidden)</para></listitem>
|
|
<listitem><para>sensitive (enabled/disabled)</para></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
<para>
|
|
Apart from regular actions, there are <link linkend="GtkToggleAction">toggle
|
|
actions</link>, which can be toggled between two states and <link
|
|
linkend="GtkRadioAction">radio actions</link>, of which only one in a group
|
|
can be in the "active" state. Other actions can be implemented as #GtkAction
|
|
subclasses.
|
|
</para>
|
|
<para>
|
|
Each action can have one or more proxy menu item, toolbar button or
|
|
other proxy widgets. Proxies mirror the state of the action (text
|
|
label, tooltip, icon, visible, sensitive, etc), and should change when
|
|
the action's state changes. When the proxy is activated, it should
|
|
activate its action.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkActionGroup, #GtkUIManager
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkAction ##### -->
|
|
<para>
|
|
The <structname>GtkAction</structname> struct contains only private members
|
|
and should not be accessed directly.
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_get_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_activate ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_create_icon ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@icon_size:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_create_menu_item ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_create_tool_item ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_connect_proxy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@proxy:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_disconnect_proxy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@proxy:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_get_proxies ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_connect_accelerator ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_disconnect_accelerator ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_block_activate_from ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@proxy:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_unblock_activate_from ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@proxy:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_set_accel_path ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@accel_path:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_action_set_accel_group ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action:
|
|
@accel_group:
|
|
|
|
|
|
<!-- ##### SIGNAL GtkAction::activate ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkAction::connect-proxy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action: the object which received the signal.
|
|
@widget:
|
|
|
|
<!-- ##### SIGNAL GtkAction::disconnect-proxy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action: the object which received the signal.
|
|
@widget:
|
|
|
|
<!-- ##### ARG GtkAction:hide-if-empty ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:is-important ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:label ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:sensitive ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:short-label ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:stock-id ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:tooltip ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkAction:visible ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|