forked from AuroraMiddleware/gtk
85c05a86c0
Mon Dec 8 10:54:44 2003 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.1 ===
* NEWS: Updates for 2.3.1
* configure.in: Version 2.3.1, interface age 0, binary age 301.
* gtk/gtkmenuitem.c (gtk_menu_item_can_activate_accel):
Rename from gtk_menu_item_real_can_activate_accel() to
match GTK+ convention, improve comment.
* gtk/gtkwidget.c: Document gtk_widget_can_activate_accel(),
can ::can-activate-accel signal.
* gtk/gtkwidget.c (closure_accel_activate): Fix spelling
in comment.
* gtk/gtkmenu.c (gtk_menu_real_can_activate_accel): Clean
up comment.
* gtk/gtkcellview{,menuitem}.[ch]: Move GET_PRIVATE() macros
into the .c file.
Mon Dec 8 12:09:21 2003 Owen Taylor <otaylor@redhat.com>
* gtk/gtkicontheme.c (find_builtin_icon): Fix a
missing 'else'. (#128816, Jorn Baayen)
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>
|
|
|
|
|
|
<!-- ##### 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>
|
|
|
|
<!-- ##### 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:
|
|
|
|
|