gtkobject.html

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

HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Adds a weak reference callback to an object.</P
><P
>Weak references are a mechanism to safely keep a pointer to
an object without using the reference counting
mechansim.  They use a callback function to receive
notice that the object is about to be freed (aka finalized).
This happens <I
CLASS="EMPHASIS"
>after</I
> the destroy
callback has been run.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34301"
></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</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>object to weakly reference.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>callback to invoke before the object is freed.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>extra data to pass to notify.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34319"
></A
><H3
><A
NAME="GTK-OBJECT-WEAKUNREF"
></A
>gtk_object_weakunref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_weakunref            (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF="gtk-types.html#GTKDESTROYNOTIFY"
>GtkDestroyNotify</A
> notify,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Removes a weak reference callback to an object.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34327"
></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</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>object stop weakly referencing.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>callback to search for.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>data to search for.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34344"
></A
><H3
><A
NAME="GTK-OBJECT-DESTROY"
></A
>gtk_object_destroy ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_destroy              (<A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>Calls the object's shutdown handler.</P
><P
>The memory for the object itself won't be deleted until
its reference count drops to 0, though.
See <A
HREF="gtkobject.html#GTK-OBJECT-UNREF"
>gtk_object_unref</A
>().</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34352"
></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</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to destroy.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34361"
></A
><H3
><A
NAME="GTK-OBJECT-GETV"
></A
>gtk_object_getv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_getv                 (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> n_args,
                                             <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> *args);</PRE
></TD
></TR
></TABLE
><P
>Gets an array of argument values from an object.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34369"
></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</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to get arguments from.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n_args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of arguments to query.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the arguments to fill in.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34386"
></A
><H3
><A
NAME="GTK-OBJECT-SET"
></A
>gtk_object_set ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_set                  (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>This function sets multiple arguments of an object.</P
><P
>It takes an object, then a list of name/value pairs
in a list, followed by NULL.</P
><P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN34395"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void set_box_properties(GtkBox* box)
{
  gtk_object_set(GTK_OBJECT(box), "homogeneous", TRUE,
                                  "spacing", 8,
				  NULL);
}</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34397"
></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</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object whose arguments should be set.</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 to set.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the value of the first argument, followed optionally
by more name/value pairs, followed by NULL.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34414"
></A
><H3
><A
NAME="GTK-OBJECT-SETV"
></A
>gtk_object_setv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_setv                 (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> n_args,
                                             <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> *args);</PRE
></TD
></TR
></TABLE
><P
>Set an array of arguments.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34422"
></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</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object whose arguments should be set.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n_args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of arguments to set.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the desired values, as an array of GtkArgs (which contain 
the names, types, and values of the arguments).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34440"
></A
><H3
><A
NAME="GTK-OBJECT-QUERY-ARGS"
></A
>gtk_object_query_args ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
>*     gtk_object_query_args           (<A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> class_type,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> **arg_flags,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *n_args);</PRE
></TD
></TR
></TABLE
><P
>Get all the arguments that may be used for a given type.</P
><P
>In Java, this type of mechanism is called 
<I
CLASS="WORDASWORD"
>introspection</I
>.  It is used by applications
like Glade, that have to determine what can be done to an object
at run-time.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34451"
></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
>class_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the GtkType of the ObjectClass
(returned from GTK_OBJECT_CLASS(class)-&gt;type for example).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg_flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>if non-NULL, obtains the <A
HREF="gtkobject.html#GTKARGFLAGS"
>GtkArgFlags</A
> that apply to
each argument.  You must <A
HREF=../glib/glib-memory-allocation.html#G-FREE
>g_free</A>() this if you request it.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n_args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of arguments is returned in this field.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an array of arguments, that you must deallocate with <A
HREF=../glib/glib-memory-allocation.html#G-FREE
>g_free</A>().
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34475"
></A
><H3
><A
NAME="GTK-OBJECT-SET-DATA"
></A
>gtk_object_set_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_set_data             (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *key,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Each object carries around a table of associations from
strings to pointers.  This function lets you set