atkobjectfactory.xml

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

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

<refnamediv>
<refname>AtkObjectFactory</refname><refpurpose>The base object class for a factory used to create accessible objects for 
objects of a specific GType.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="AtkObjectFactory-struct">AtkObjectFactory</link>;
<link linkend="AtkObject">AtkObject</link>*  <link linkend="atk-object-factory-create-accessible">atk_object_factory_create_accessible</link>
                                            (<link linkend="AtkObjectFactory">AtkObjectFactory</link> *factory,
                                             <link linkend="GObject">GObject</link> *obj);
<link linkend="GType">GType</link>       <link linkend="atk-object-factory-get-accessible-type">atk_object_factory_get_accessible_type</link>
                                            (<link linkend="AtkObjectFactory">AtkObjectFactory</link> *factory);
<link linkend="void">void</link>        <link linkend="atk-object-factory-invalidate">atk_object_factory_invalidate</link>   (<link linkend="AtkObjectFactory">AtkObjectFactory</link> *factory);

</synopsis>
</refsynopsisdiv>

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

  <link linkend="GObject">GObject</link>
   +----AtkObjectFactory
         +----<link linkend="AtkNoOpObjectFactory">AtkNoOpObjectFactory</link>
</synopsis>

</refsect1>








<refsect1>
<title>Description</title>
<para>
This class is the base object class for a factory used to create an 
accessible object for a specific GType. The function 
<link linkend="atk-registry-set-factory-type"><function>atk_registry_set_factory_type()</function></link> is normally called to store 
in the registry the factory type to be used to create an accessible of a
particular GType.
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="AtkObjectFactory-struct"/>struct AtkObjectFactory</title>
<indexterm><primary>AtkObjectFactory</primary></indexterm><programlisting>struct AtkObjectFactory;</programlisting>
<para>
The AtkObjectFactory structure should not be accessed directly.

</para></refsect2>
<refsect2>
<title><anchor id="atk-object-factory-create-accessible"/>atk_object_factory_create_accessible ()</title>
<indexterm><primary>atk_object_factory_create_accessible</primary></indexterm><programlisting><link linkend="AtkObject">AtkObject</link>*  atk_object_factory_create_accessible
                                            (<link linkend="AtkObjectFactory">AtkObjectFactory</link> *factory,
                                             <link linkend="GObject">GObject</link> *obj);</programlisting>
<para>
Provides an <link linkend="AtkObject"><type>AtkObject</type></link> that implements an accessibility interface 
on behalf of <parameter>obj</parameter></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>factory</parameter>&nbsp;:</term>
<listitem><simpara> The <link linkend="AtkObjectFactory"><type>AtkObjectFactory</type></link> associated with <parameter>obj</parameter>'s
object type
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>obj</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link> 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> an <link linkend="AtkObject"><type>AtkObject</type></link> that implements an accessibility interface
on behalf of <parameter>obj</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-object-factory-get-accessible-type"/>atk_object_factory_get_accessible_type ()</title>
<indexterm><primary>atk_object_factory_get_accessible_type</primary></indexterm><programlisting><link linkend="GType">GType</link>       atk_object_factory_get_accessible_type
                                            (<link linkend="AtkObjectFactory">AtkObjectFactory</link> *factory);</programlisting>
<para>
Gets the GType of the accessible which is created by the factory. 
The value G_TYPE_INVALID is returned if no type if found.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>factory</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="AtkObjectFactory"><type>AtkObjectFactory</type></link> 
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the type of the accessible which is created by the <parameter>factory</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="atk-object-factory-invalidate"/>atk_object_factory_invalidate ()</title>
<indexterm><primary>atk_object_factory_invalidate</primary></indexterm><programlisting><link linkend="void">void</link>        atk_object_factory_invalidate   (<link linkend="AtkObjectFactory">AtkObjectFactory</link> *factory);</programlisting>
<para>
Inform <parameter>factory</parameter> that it is no longer being used to create
accessibles. When called, <parameter>factory</parameter> may need to inform
<link linkend="AtkObjects"><type>AtkObjects</type></link> which it has created that they need to be re-instantiated.
Note: primarily used for runtime replacement of <link linkend="AtkObjectFactorys"><type>AtkObjectFactorys</type></link>
in object registries.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>factory</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="AtkObjectFactory"><type>AtkObjectFactory</type></link> to invalidate
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>



<refsect1>
<title>See Also</title>
<para>
AtkRegistry

</para>
</refsect1>

</refentry>