gtkobject.html

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

VALIGN="TOP"
>the default emission behavior for the signal.
See <A
HREF="gtk-signals.html#GTK-SIGNAL-NEW"
>gtk_signal_new</A
>().</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshaller</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>takes a GtkObject, a <A
HREF="gtk-types.html#GTKSIGNALFUNC"
>GtkSignalFunc</A
>, and an array
of arguments, and invokes the function using the appropriate
calling conventions.  Usually just select a function
out of gtkmarshal.h.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>return_val</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>specify the return-value type for the signal (possibly
GTK_TYPE_NONE).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nparams</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>specify the number of parameters the signal
receives from the caller of <A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>().</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>params</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of GtkTypes the signal handlers for this signal
should have in their prototype (of length nparams).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal id.  (See GtkSignals)
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34134"
></A
><H3
><A
NAME="GTK-OBJECT-NEW"
></A
>gtk_object_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtkobject.html"
>GtkObject</A
>*  gtk_object_new                  (<A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> type,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Construct an object given its arguments, enumerated in the call to the
function.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34142"
></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
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type identifying this object.  Returned by <A
HREF="gtk-types.html#GTK-TYPE-UNIQUE"
>gtk_type_unique</A
>()
although (for a properly-written object it should be accessible through
GTK_TYPE_FOO.)</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"
>name of the first argument to set when constructing
the object.</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 first argument's value, followed by any number of
name/argument-value pairs, terminated with NULL.</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 GtkObject.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34165"
></A
><H3
><A
NAME="GTK-OBJECT-NEWV"
></A
>gtk_object_newv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtkobject.html"
>GtkObject</A
>*  gtk_object_newv                 (<A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> object_type,
                                             <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
>Construct an object with an array of arguments.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34174"
></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 the object to create.</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"
>an array of n_args arguments (which are name and value pairs).</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 GtkObject.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34195"
></A
><H3
><A
NAME="GTK-OBJECT-CONSTRUCTED"
></A
>gtk_object_constructed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_constructed          (<A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>Mark an allocated object as constructed.
This is used for situations
that require precise control of the construction process.</P
><P
>This is done when <A
HREF="gtkobject.html#GTK-OBJECT-DEFAULT-CONSTRUCT"
>gtk_object_default_construct</A
>() is inadequate.
In <A
HREF="gtkclist.html"
>GtkCList</A
> the need arises because <A
HREF="gtkclist.html"
>GtkCList</A
> does construction work that
must happen <I
CLASS="EMPHASIS"
>after</I
> its derivers.  This work
cannot be done in an initializer function, so an alternate
constructor is mandatory.  It calls <A
HREF="gtkobject.html#GTK-OBJECT-CONSTRUCTED"
>gtk_object_constructed</A
>() to
indicate it has done its job, so that no other constructor will
be invoked.</P
><P
>Normally this function is just automatically run from
<A
HREF="gtkobject.html#GTK-OBJECT-DEFAULT-CONSTRUCT"
>gtk_object_default_construct</A
>().</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34209"
></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 which has been constructed.  This is usually
done automatically by <A
HREF="gtkobject.html#GTK-OBJECT-NEW"
>gtk_object_new</A
>() and <A
HREF="gtkobject.html#GTK-OBJECT-NEWV"
>gtk_object_newv</A
>().
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34220"
></A
><H3
><A
NAME="GTK-OBJECT-DEFAULT-CONSTRUCT"
></A
>gtk_object_default_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_default_construct    (<A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>This function is called to construct arguments that haven't been initialized
but have the GTK_ARG_CONSTRUCT flag set.</P
><P
>All number arguments are set to 0.  All pointers and strings
are set to NULL.</P
><P
>Normally invoked by <A
HREF="gtkobject.html#GTK-OBJECT-NEW"
>gtk_object_new</A
>() automatically; <A
HREF="gtk-types.html#GTK-TYPE-NEW"
>gtk_type_new</A
>() can
be used to bypass it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34231"
></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 initialize.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34240"
></A
><H3
><A
NAME="GTK-OBJECT-SINK"
></A
>gtk_object_sink ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_sink                 (<A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>Decrement the initial count given to the object.
Additional invocations have no effect.</P
><P
>This is designed to free the user from worrying about
dereferencing an object that they have just created.
So long as the object is sunk at some point, the reference count
will be set properly.</P
><P
>furthermore it may be sunk multiple times.
Only the first time will actually dereference.</P
><P
>The basic outline is: when you create an object it is floating.
Setting its parent causes it to be sunk, however its parent
has obtained a reference, so its reference count is one.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34249"
></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 sink.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34258"
></A
><H3
><A
NAME="GTK-OBJECT-REF"
></A
>gtk_object_ref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_ref                  (<A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>Increase the reference count of the object.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34264"
></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 reference.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34273"
></A
><H3
><A
NAME="GTK-OBJECT-UNREF"
></A
>gtk_object_unref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_unref                (<A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>Decrease the reference count of an object.  When its reference
count drops to 0, the object is deleted.</P
><P
>If it was not already destroyed, it will be, with <A
HREF="gtkobject.html#GTK-OBJECT-DESTROY"
>gtk_object_destroy</A
>(),
then weak links are notified, then the object-data is freed
and the memory for the object itself is freed using <A
HREF="gtk-types.html#GTK-TYPE-FREE"
>gtk_type_free</A
>().</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34282"
></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 dereference.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34291"
></A
><H3
><A
NAME="GTK-OBJECT-WEAKREF"
></A
>gtk_object_weakref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_object_weakref              (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF="gtk-types.html#GTKDESTROYNOTIFY"
>GtkDestroyNotify</A
> notify,
                                             <A