gtkobject.html

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

><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to examine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN33919"
></A
><H3
><A
NAME="GTK-OBJECT-CONNECTED-CAPS"
></A
>GTK_OBJECT_CONNECTED()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_OBJECT_CONNECTED(obj)	  ((GTK_OBJECT_FLAGS (obj) &amp; GTK_CONNECTED) != 0)</PRE
></TD
></TR
></TABLE
><P
>Test whether a GtkObject has had a signal connected to it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN33924"
></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
>obj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to examine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN33933"
></A
><H3
><A
NAME="GTK-OBJECT-CONSTRUCTED-CAPS"
></A
>GTK_OBJECT_CONSTRUCTED()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_OBJECT_CONSTRUCTED(obj)	  ((GTK_OBJECT_FLAGS (obj) &amp; GTK_CONSTRUCTED) != 0)</PRE
></TD
></TR
></TABLE
><P
>Test whether a GtkObject's arguments have been prepared.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN33938"
></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
>obj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to examine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN33947"
></A
><H3
><A
NAME="GTK-OBJECT-SET-FLAGS-CAPS"
></A
>GTK_OBJECT_SET_FLAGS()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_OBJECT_SET_FLAGS(obj,flag)	  G_STMT_START{ (GTK_OBJECT_FLAGS (obj) |= (flag)); }G_STMT_END</PRE
></TD
></TR
></TABLE
><P
>Turn on certain object flags.  (Private)</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN33952"
></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
>obj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flag</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the flags to set.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN33965"
></A
><H3
><A
NAME="GTK-OBJECT-UNSET-FLAGS-CAPS"
></A
>GTK_OBJECT_UNSET_FLAGS()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_OBJECT_UNSET_FLAGS(obj,flag)  G_STMT_START{ (GTK_OBJECT_FLAGS (obj) &amp;= ~(flag)); }G_STMT_END</PRE
></TD
></TR
></TABLE
><P
>Turn off certain object flags.  (Private)</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN33970"
></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
>obj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flag</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the flags to unset.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN33983"
></A
><H3
><A
NAME="GTKARGFLAGS"
></A
>enum GtkArgFlags</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GTK_ARG_READABLE	 = 1 &lt;&lt; 0,
  GTK_ARG_WRITABLE	 = 1 &lt;&lt; 1,
  GTK_ARG_CONSTRUCT	 = 1 &lt;&lt; 2,
  GTK_ARG_CONSTRUCT_ONLY = 1 &lt;&lt; 3,
  GTK_ARG_CHILD_ARG	 = 1 &lt;&lt; 4,
  GTK_ARG_MASK		 = 0x1f,
  
  /* aliases
   */
  GTK_ARG_READWRITE	 = GTK_ARG_READABLE | GTK_ARG_WRITABLE
} GtkArgFlags;</PRE
></TD
></TR
></TABLE
><P
>Possible flags indicating how an argument should be treated.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN33988"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#F0F0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_READABLE</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument is readable. (i.e. can be queried)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_WRITABLE</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument is writable. (i.e. settable)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_CONSTRUCT</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument needs construction.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_CONSTRUCT_ONLY</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument needs construction (and will
be set once during object creation), but is otherwise cannot be
set.  Hence this flag is not allowed with GTK_ARG_WRITABLE,
and is redundant with GTK_ARG_CONSTRUCT.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_CHILD_ARG</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an argument type that applies to (and may be different for)
each child.  Used by <A
HREF="gtkcontainer.html"
>GtkContainer</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_MASK</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the bitwise-OR of all the flags.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GTK_ARG_READWRITE</TT
></TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the argument is readable and writable.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN34024"
></A
><H3
><A
NAME="GTK-OBJECT-CLASS-USER-SIGNAL-NEW"
></A
>gtk_object_class_user_signal_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gtk_object_class_user_signal_new
                                            (GtkObjectClass *klass,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-signals.html#GTKSIGNALRUNTYPE"
>GtkSignalRunType</A
> signal_flags,
                                             <A
HREF="gtk-types.html#GTKSIGNALMARSHALLER"
>GtkSignalMarshaller</A
> marshaller,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> return_val,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nparams,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Define a signal-handler for a new signal on an already defined
object.</P
><P
>See the signal documentation for more general information.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34037"
></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
>klass</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object class to define the signal for.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>signal_flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
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"
>a function that will take an array of GtkArgs
and invoke the appropriate handler with the normal calling
conventions.</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
(or GTK_TYPE_NONE for no return-value).</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
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>list of nparams GtkTypes to pass to the signal handlers.</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="AEN34078"
></A
><H3
><A
NAME="GTK-OBJECT-CLASS-USER-SIGNAL-NEWV"
></A
>gtk_object_class_user_signal_newv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gtk_object_class_user_signal_newv
                                            (GtkObjectClass *klass,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-signals.html#GTKSIGNALRUNTYPE"
>GtkSignalRunType</A
> signal_flags,
                                             <A
HREF="gtk-types.html#GTKSIGNALMARSHALLER"
>GtkSignalMarshaller</A
> marshaller,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> return_val,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nparams,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> *params);</PRE
></TD
></TR
></TABLE
><P
>Define a signal-handler for a new signal on an already defined
object.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN34091"
></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
>klass</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object class to define the signal for.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>signal_flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"