gtk-general.html

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

><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gtk_true                        (void);</PRE
></TD
></TR
></TABLE
><P
>All this function does it to return TRUE. This can be useful for example
if you want to inhibit the deletion of a window. Of course you should 
not do this as the user expects a reaction from clicking the close 
icon of the window...</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN413"
></A
><P
><B
>Example 3.  A persistent window</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#include &lt;gtk/gtk.h&gt;

int
main (int argc, char **argv)
{
  GtkWidget     *win, *but;

  gtk_init( &amp;argc, &amp;argv );

  win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
  gtk_signal_connect (GTK_OBJECT(win), "delete-event", 
                      (GtkSignalFunc) gtk_true, NULL);
  gtk_signal_connect (GTK_OBJECT(win), "destroy", 
		      (GtkSignalFunc) gtk_main_quit, NULL);

  but = gtk_button_new_with_label ("Close yourself. I mean it!");
  gtk_signal_connect_object (
		  GTK_OBJECT (but), "clicked", 
		  (GtkSignalFunc) gtk_object_destroy, (gpointer) win );
  gtk_container_add (GTK_CONTAINER (win), but);

  gtk_widget_show_all (win);
  <A
HREF="gtk-general.html#GTK-MAIN"
>gtk_main</A
>();
  return 0;
}</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN418"
></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"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
>
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN428"
></A
><H3
><A
NAME="GTK-FALSE"
></A
>gtk_false ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gtk_false                       (void);</PRE
></TD
></TR
></TABLE
><P
>Analogical to <TT
CLASS="FUNCTION"
>gtk_true</TT
> this function does nothing 
but always returns <TT
CLASS="LITERAL"
>FALSE</TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN436"
></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"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>FALSE</TT
>
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN446"
></A
><H3
><A
NAME="GTK-GRAB-ADD"
></A
>gtk_grab_add ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_grab_add                    (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Makes <TT
CLASS="LITERAL"
>widget</TT
> the current grabbed widget. This means that interaction with 
other widgets in the same application is blocked and mouse as well as 
keyboard events are delivered to this <TT
CLASS="LITERAL"
>widget</TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN454"
></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
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The widget that grabs keyboard and pointer events.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN463"
></A
><H3
><A
NAME="GTK-GRAB-GET-CURRENT"
></A
>gtk_grab_get_current ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtkwidget.html"
>GtkWidget</A
>*  gtk_grab_get_current            (void);</PRE
></TD
></TR
></TABLE
><P
>Queries the current grab. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN469"
></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"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The widget which currently has the grab or <TT
CLASS="LITERAL"
>NULL</TT
> if no grab is active.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN479"
></A
><H3
><A
NAME="GTK-GRAB-REMOVE"
></A
>gtk_grab_remove ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_grab_remove                 (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Remove the grab from the given widget. You have to pair calls to gtk_grab_add
and gtk_grab_remove.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN485"
></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
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The widget which gives up the grab.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN494"
></A
><H3
><A
NAME="GTK-INIT-ADD"
></A
>gtk_init_add ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_init_add                    (<A
HREF="gtk-types.html#GTKFUNCTION"
>GtkFunction</A
> function,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Register a function to be called when the mainloop is started.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN501"
></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
>function</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Function to invoke when gtk_main is called next.</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 pass to that function.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN514"
></A
><H3
><A
NAME="GTK-QUIT-ADD-DESTROY"
></A
>gtk_quit_add_destroy ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_quit_add_destroy            (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> main_level,
                                             <A
HREF="gtkobject.html"
>GtkObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
>Trigger destruction of <TT
CLASS="LITERAL"
>object</TT
> in case the mainloop at level <TT
CLASS="LITERAL"
>main_level</TT
>
is quit.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN523"
></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
>main_level</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Level of the mainloop which shall trigger the destruction.</TD
></TR
><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 be destroyed.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN536"
></A
><H3
><A
NAME="GTK-QUIT-ADD"
></A
>gtk_quit_add ()</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_quit_add                    (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> main_level,
                                             <A
HREF="gtk-types.html#GTKFUNCTION"
>GtkFunction</A
> function,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Registers a function to be called when an instance of the mainloop is left.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN545"
></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
>main_level</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Level at which termination the function shall be called. You
 can pass 0 here to have the function run at the termination of the current
 mainloop.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>function</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The function to call. This should return 0 to be removed from the 
 list of quit handlers. Otherwise the function might be called again.</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"
>Pointer to pass when calling <TT
CLASS="LITERAL"
>function</TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A handle for this quit handler (you need this for <A
HREF="gtk-general.html#GTK-QUIT-REMOVE"
>gtk_quit_remove</A
>())
  or 0 if you passed a NULL pointer in <TT
CLASS="LITERAL"
>function</TT
>.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN569"
></A
><H3
><A
NAME="GTK-QUIT-ADD-FULL"
></A
>gtk_quit_add_full ()</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_quit_add_full               (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> main_level,
                                             <A
HREF="gtk-types.html#GTKFUNCTION"
>GtkFunction</A
> function,
                                             <A
HREF="gtk-types.html#GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</A
> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF="gtk-types.html#GTKDESTROYNOTIFY"
>GtkDestroyNotify</A
> destroy);</PRE
></TD
></TR
></TABLE
><P
>Registers a function to be called when an instance of the mainloop is left.
In comparison to <A
HREF="gtk-general.html#GTK-QUIT-ADD"
>gtk_quit_add</A
>() this function adds the possibility to 
pass a marshaller and a function to be called when the quit handler is freed.</P
><P
>The former can be used to run interpreted code instead of a compiled function
while the latter can be used to free the information stored in <TT
CLASS="LITERAL"
>data</TT
> (while
you can do this in <TT
CLASS="LITERAL"
>function</TT
> as well)... So this function will mostly be
used by GTK+ wrappers for languages other than C.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN584"
></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
>main_level</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Level at which termination the function shall be called. You
 can pass 0 here to have the function run at the termination of the current
 mainloop.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>function</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The function to call. This should return 0 to be removed from the 
 list of quit handlers. Otherwise the function might be called again.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The marshaller to be used. If this is non-NULL, <TT
CLASS="LITERAL"
>function</TT
> is 
 ignored.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT