atkaction.xml

linux下图形库开发包atk-1.4.0.tar.gz

<refentry id="AtkAction">
<refmeta>
<refentrytitle>AtkAction</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>ATK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>AtkAction</refname><refpurpose>The ATK interface provided by UI components which the user can
activate/interact with,</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="AtkAction-struct">AtkAction</link>;
<link linkend="gboolean">gboolean</link>    <link linkend="atk-action-do-action">atk_action_do_action</link>            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);
<link linkend="gint">gint</link>        <link linkend="atk-action-get-n-actions">atk_action_get_n_actions</link>        (<link linkend="AtkAction">AtkAction</link> *action);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="atk-action-get-description">atk_action_get_description</link>
                                            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="atk-action-get-name">atk_action_get_name</link>   (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="atk-action-get-localized-name">atk_action_get_localized_name</link>
                                            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="atk-action-get-keybinding">atk_action_get_keybinding</link>
                                            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);
<link linkend="gboolean">gboolean</link>    <link linkend="atk-action-set-description">atk_action_set_description</link>      (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i,
                                             const <link linkend="gchar">gchar</link> *desc);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GInterface">GInterface</link>
   +----AtkAction
</synopsis>

</refsect1>




<refsect1>
<title>Known Implementations</title>
<para>
AtkAction is implemented by
 <link linkend="AtkNoOpObject">AtkNoOpObject</link> and  <link linkend="AtkHyperlink">AtkHyperlink</link>.</para>

</refsect1>




<refsect1>
<title>Description</title>
<para>
<link linkend="AtkAction"><type>AtkAction</type></link> should be implemented by instances of <link linkend="AtkObject"><type>AtkObject</type></link> classes with
which the user can interact directly, i.e. buttons, checkboxes,
scrollbars,  e.g. components which are not "passive"
providers of UI information.
</para>
<para>
Exceptions: when the user interaction is already covered by
another appropriate interface such as <link linkend="AtkEditableText"><type>AtkEditableText</type></link> (insert/delete
test, etc.) or <link linkend="AtkValue"><type>AtkValue</type></link> (set value) then these actions should not be
exposed by <link linkend="AtkAction"><type>AtkAction</type></link> as well.  
</para>
<para>
Also note that the <link linkend="AtkAction"><type>AtkAction</type></link> API is limited in that parameters may not
be passed to the object being activated; thus the action must be
self-contained and specifiable via only a single "verb".  Concrete
examples include "press", "release", "click" for buttons, "drag"
(meaning initiate drag) and "drop" for drag sources and drop targets,
etc.  
</para>
<para>
Though most UI interactions on components should be invocable via
keyboard as well as mouse, there will generally be a close mapping
between "mouse actions" that are possible on a component and the
AtkActions.  Where mouse and keyboard actions are redundant in effect,
<link linkend="AtkAction"><type>AtkAction</type></link> should expose only one action rather than exposing redundant
actions if possible.  By convention we have been using "mouse centric"
terminology for <link linkend="AtkAction"><type>AtkAction</type></link> names.
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="AtkAction-struct"/>struct AtkAction</title>
<indexterm><primary>AtkAction</primary></indexterm><programlisting>struct AtkAction;</programlisting>
<para>
The AtkAction structure does not contain any fields.
</para></refsect2>
<refsect2>
<title><anchor id="atk-action-do-action"/>atk_action_do_action ()</title>
<indexterm><primary>atk_action_do_action</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    atk_action_do_action            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);</programlisting>
<para>
Perform the specified action on the object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> the action index corresponding to the action to be performed 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <literal>TRUE</literal> if success, <literal>FALSE</literal> otherwise

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-action-get-n-actions"/>atk_action_get_n_actions ()</title>
<indexterm><primary>atk_action_get_n_actions</primary></indexterm><programlisting><link linkend="gint">gint</link>        atk_action_get_n_actions        (<link linkend="AtkAction">AtkAction</link> *action);</programlisting>
<para>
Gets the number of accessible actions available on the object.
If there are more than one, the first one is considered the
"default" action of the object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a the number of actions, or 0 if <parameter>action</parameter> does not
implement this interface.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-action-get-description"/>atk_action_get_description ()</title>
<indexterm><primary>atk_action_get_description</primary></indexterm><programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* atk_action_get_description
                                            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);</programlisting>
<para>
Returns a description of the specified action of the object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> the action index corresponding to the action to be performed 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>a description string, or <literal>NULL</literal>
if <parameter>action</parameter> does not implement this interface.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-action-get-name"/>atk_action_get_name ()</title>
<indexterm><primary>atk_action_get_name</primary></indexterm><programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* atk_action_get_name   (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);</programlisting>
<para>
Returns the name of the specified action of the object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> the action index corresponding to the action to be performed 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>a name string, or <literal>NULL</literal>
if <parameter>action</parameter> does not implement this interface.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-action-get-localized-name"/>atk_action_get_localized_name ()</title>
<indexterm><primary>atk_action_get_localized_name</primary></indexterm><programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* atk_action_get_localized_name
                                            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);</programlisting>
<para>
Returns the localized name of the specified action of the object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> the action index corresponding to the action to be performed 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>a name string, or <literal>NULL</literal>
if <parameter>action</parameter> does not implement this interface.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-action-get-keybinding"/>atk_action_get_keybinding ()</title>
<indexterm><primary>atk_action_get_keybinding</primary></indexterm><programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* atk_action_get_keybinding
                                            (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i);</programlisting>
<para>
Returns a keybinding associated with this action, if one exists.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> the action index corresponding to the action to be performed 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>a string representing the keybinding, or <literal>NULL</literal>
if there is no keybinding for this action.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-action-set-description"/>atk_action_set_description ()</title>
<indexterm><primary>atk_action_set_description</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    atk_action_set_description      (<link linkend="AtkAction">AtkAction</link> *action,
                                             <link linkend="gint">gint</link> i,
                                             const <link linkend="gchar">gchar</link> *desc);</programlisting>
<para>
Sets a description of the specified action of the object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> instance that implements AtkActionIface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> the action index corresponding to the action to be performed 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> the description to be assigned to this action
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a gboolean representing if the description was successfully set;
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>