forked from AuroraMiddleware/gtk
320bba9f37
2003-08-31 Matthias Clasen <maclas@gmx.de> * gtk/tmpl/gtkuimanager.sgml: * gtk/tmpl/gtkactiongroup.sgml: * gtk/tmpl/gtkaction.sgml: * gtk/tmpl/gtktoggleaction.sgml: * gtk/tmpl/gtkradioaction.sgml: Additions. * gtk/gtk-sections.txt: Updates. * gtk/gtk.types: Add GtkAction, GtkActionGroup, GtkToggleAction, GtkRadioAction and GtkUIManager. * gtk/gtkaction.c: * gtk/gtkactiongroup.c: Some doc tweaks. * gtk/gtkuimanager.[hc]: Get rid of the remove_widget signal. It wasn't emitted anyway. Some doc tweaks.
199 lines
3.6 KiB
Plaintext
199 lines
3.6 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, #GtkMenuMerge
|
|
</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_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:
|
|
|
|
|
|
<!-- ##### SIGNAL GtkAction::activate ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@action: the object which received the signal.
|
|
|
|
<!-- ##### 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>
|
|
|