gtk-object-properties.html

该压缩包包含了GTK+的大量API函数

>GtkArg</A
> *src_arg,
                                             <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> *dest_arg);</PRE
></TD
></TR
></TABLE
><P
>It will either copy data into an existing argument or allocate a new argument
and copy the data.  Strings are duplicated.  All other pointers and
values are copied (shallowly-- that is the pointers themselves are
copied, not the data they point to.)</P
><P
>You should call gtk_arg_reset() on dest_arg before calling this
if the argument may contain string data that you want freed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9333"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>src_arg</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument to duplicate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dest_arg</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument to copy over (or NULL to create a new <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
>).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the new <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> (or dest_arg, if it was not NULL).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9352"
></A
><H3
><A
NAME="GTK-ARG-FREE"
></A
>gtk_arg_free ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_arg_free                    (<A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> *arg,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> free_contents);</PRE
></TD
></TR
></TABLE
><P
>Frees the argument, and optionally its contents.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9359"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument to free.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>free_contents</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>whether to free the string, if it is a string.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9372"
></A
><H3
><A
NAME="GTK-ARGS-COLLECT"
></A
>gtk_args_collect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gtk_args_collect                (<A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> object_type,
                                             <A
HREF=../glib/glib-hash-tables.html#GHASHTABLE
>GHashTable</A> *arg_info_hash_table,
                                             <A
HREF=../glib/glib-singly-linked-lists.html#GSLIST
>GSList</A> **arg_list_p,
                                             <A
HREF=../glib/glib-singly-linked-lists.html#GSLIST
>GSList</A> **info_list_p,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             va_list var_args);</PRE
></TD
></TR
></TABLE
><P
>Private:  given a hashtable of argument information it takes a vararg
list and parses it into arguments (in the form of lists of GtkArgs
and lists of GtkArgInfos.</P
><P
>The list of arguments starts with first_arg_name then the first argument's
value.  Followed by any number of additional name/argument pairs,
terminated with NULL.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9386"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type of object we are collecting arguments for.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg_info_hash_table</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a hashtable mapping from names of arguments
to their GtkArgInfos.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg_list_p</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a returned list of arguments obtained from parsing the
varargs.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>info_list_p</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a returned list of the GtkArgInfos.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>first_arg_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the first argument.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>var_args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a va_list containing the value of the first argument,
followed by name/value pairs, followed by NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an error message on failure, or NULL otherwise.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9421"
></A
><H3
><A
NAME="GTK-ARGS-COLLECT-CLEANUP"
></A
>gtk_args_collect_cleanup ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_args_collect_cleanup        (<A
HREF=../glib/glib-singly-linked-lists.html#GSLIST
>GSList</A> *arg_list,
                                             <A
HREF=../glib/glib-singly-linked-lists.html#GSLIST
>GSList</A> *info_list);</PRE
></TD
></TR
></TABLE
><P
>Private: erase lists of arguments returned from <A
HREF="gtk-object-properties.html#GTK-ARGS-COLLECT"
>gtk_args_collect</A
>().</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9429"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg_list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>arg_list_p returned from <A
HREF="gtk-object-properties.html#GTK-ARGS-COLLECT"
>gtk_args_collect</A
>().</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>info_list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>info_list_p returned from <A
HREF="gtk-object-properties.html#GTK-ARGS-COLLECT"
>gtk_args_collect</A
>().
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9444"
></A
><H3
><A
NAME="GTK-ARG-GET-INFO"
></A
>gtk_arg_get_info ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gtk_arg_get_info                (<A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> object_type,
                                             <A
HREF=../glib/glib-hash-tables.html#GHASHTABLE
>GHashTable</A> *arg_info_hash_table,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *arg_name,
                                             <A
HREF="gtk-object-properties.html#GTKARGINFO"
>GtkArgInfo</A
> **info_p);</PRE
></TD
></TR
></TABLE
><P
>Private: get information about an argument.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9454"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type of object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg_info_hash_table</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the hashtable of GtkArgInfos.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the argument to lookup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>info_p</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument info.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an error message on failure, or NULL otherwise.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9480"
></A
><H3
><A
NAME="GTK-ARG-TYPE-NEW-STATIC"
></A
>gtk_arg_type_new_static ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtk-object-properties.html#GTKARGINFO"
>GtkArgInfo</A
>* gtk_arg_type_new_static         (<A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> base_class_type,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *arg_name,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> class_n_args_offset,
                                             <A
HREF=../glib/glib-hash-tables.html#GHASHTABLE
>GHashTable</A> *arg_info_hash_table,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> arg_type,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg_flags,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg_id);</PRE
></TD
></TR
></TABLE
><P
>Create a new argument registered with a class.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9493"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>base_class_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"