📄 gtkbutton.html
字号:
<HTML><HEAD><TITLE>GtkButton</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkBox"HREF="gtkbox.html"><LINKREL="NEXT"TITLE="GtkCalendar"HREF="gtkcalendar.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkbox.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkcalendar.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKBUTTON">GtkButton</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN14729"></A><H2>Name</H2>GtkButton -- A widget that creates a signal when clicked on.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN14732"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkbutton.html#GTKBUTTON-STRUCT">GtkButton</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkbutton.html#GTK-BUTTON-NEW">gtk_button_new</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkbutton.html#GTK-BUTTON-NEW-WITH-LABEL">gtk_button_new_with_label</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);void <AHREF="gtkbutton.html#GTK-BUTTON-PRESSED">gtk_button_pressed</A> (<AHREF="gtkbutton.html">GtkButton</A> *button);void <AHREF="gtkbutton.html#GTK-BUTTON-RELEASED">gtk_button_released</A> (<AHREF="gtkbutton.html">GtkButton</A> *button);void <AHREF="gtkbutton.html#GTK-BUTTON-CLICKED">gtk_button_clicked</A> (<AHREF="gtkbutton.html">GtkButton</A> *button);void <AHREF="gtkbutton.html#GTK-BUTTON-ENTER">gtk_button_enter</A> (<AHREF="gtkbutton.html">GtkButton</A> *button);void <AHREF="gtkbutton.html#GTK-BUTTON-LEAVE">gtk_button_leave</A> (<AHREF="gtkbutton.html">GtkButton</A> *button);void <AHREF="gtkbutton.html#GTK-BUTTON-SET-RELIEF">gtk_button_set_relief</A> (<AHREF="gtkbutton.html">GtkButton</A> *button, <AHREF="gtk-standard-enumerations.html#GTKRELIEFSTYLE">GtkReliefStyle</A> newstyle);<AHREF="gtk-standard-enumerations.html#GTKRELIEFSTYLE">GtkReliefStyle</A> <AHREF="gtkbutton.html#GTK-BUTTON-GET-RELIEF">gtk_button_get_relief</A> (<AHREF="gtkbutton.html">GtkButton</A> *button); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN14757"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkcontainer.html">GtkContainer</A> +----<AHREF="gtkbin.html">GtkBin</A> +----GtkButton</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN14764"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkbutton.html#GTKBUTTON--LABEL">label</A>" <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* : Read / Write "<AHREF="gtkbutton.html#GTKBUTTON--RELIEF">relief</A>" <AHREF="gtk-standard-enumerations.html#GTKRELIEFSTYLE">GtkReliefStyle</A> : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN14771"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkbutton.html#GTKBUTTON-PRESSED">pressed</A>" void user_function (<AHREF="gtkbutton.html">GtkButton</A> *button, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkbutton.html#GTKBUTTON-RELEASED">released</A>" void user_function (<AHREF="gtkbutton.html">GtkButton</A> *button, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkbutton.html#GTKBUTTON-CLICKED">clicked</A>" void user_function (<AHREF="gtkbutton.html">GtkButton</A> *button, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkbutton.html#GTKBUTTON-ENTER">enter</A>" void user_function (<AHREF="gtkbutton.html">GtkButton</A> *button, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkbutton.html#GTKBUTTON-LEAVE">leave</A>" void user_function (<AHREF="gtkbutton.html">GtkButton</A> *button, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN14789"></A><H2>Description</H2><P> The <AHREF="gtkbutton.html">GtkButton</A> widget is generally used to attach a function to thatis called when the button is pressed. The various signals and how to usethem are outlined below. </P><P> The <AHREF="gtkbutton.html">GtkButton</A> widget can hold any valid child widget. That is it canhold most any other standard <AHREF="gtkwidget.html">GtkWidget</A>. The most commonly used child isthe <AHREF="gtklabel.html">GtkLabel</A>. </P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN14797"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN14799"></A><H3><ANAME="GTKBUTTON-STRUCT"></A>struct GtkButton</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkButton;</PRE></TD></TR></TABLE><P> This should not be accessed directly. Use the accessor functions below. </P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN14804"></A><H3><ANAME="GTK-BUTTON-NEW"></A>gtk_button_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_button_new (void);</PRE></TD></TR></TABLE><P> Creates a new <AHREF="gtkbutton.html">GtkButton</A> widget. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN14811"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The newly created <AHREF="gtkbutton.html">GtkButton</A> widget. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN14821"></A><H3><ANAME="GTK-BUTTON-NEW-WITH-LABEL"></A>gtk_button_new_with_label ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_button_new_with_label (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);</PRE></TD></TR></TABLE><P> Creates a <AHREF="gtkbutton.html">GtkButton</A> widget with a <AHREF="gtklabel.html">GtkLabel</A> child containing the giventext. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN14830"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>label</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The text you want the <AHREF="gtklabel.html">GtkLabel</A> to hold.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The newly created <AHREF="gtkbutton.html">GtkButton</A> widget. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN14845"></A><H3><ANAME="GTK-BUTTON-PRESSED"></A>gtk_button_pressed ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_button_pressed (<AHREF="gtkbutton.html">GtkButton</A> *button);</PRE></TD></TR></TABLE><P> Emits a <AHREF="gtkbutton.html">GtkButton</A>::pressed signal to the given <AHREF="gtkbutton.html">GtkButton</A>. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN14853"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>button</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkbutton.html">GtkButton</A> you want to send the signal to. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN14863"></A><H3><ANAME="GTK-BUTTON-RELEASED"></A>gtk_button_released ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_button_released (<AHREF="gtkbutton.html">GtkButton</A> *button);</PRE></TD></TR></TABLE><P> Emits a <AHREF="gtkbutton.html">GtkButton</A>::released signal to the given <AHREF="gtkbutton.html">GtkButton</A>. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN14871"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>button</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkbutton.html">GtkButton</A> you want to send the signal to. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN14881"></A><H3><ANAME="GTK-BUTTON-CLICKED"></A>gtk_button_clicked ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_button_clicked (<AHREF="gtkbutton.html">GtkButton</A> *button);</PRE></TD></TR></TABLE><P> Emits a <AHREF="gtkbutton.html">GtkButton</A>::clicked signal to the given <AHREF="gtkbutton.html">GtkButton</A>. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN14889"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>button</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkbutton.html">GtkButton</A> you want to send the signal to. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN14899"></A><H3><ANAME="GTK-BUTTON-ENTER"></A>gtk_button_enter ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_button_enter (<AHREF="gtkbutton.html">GtkButton</A> *button);</PRE></TD></TR></TABLE><P> Emits a <AHREF="gtkbutton.html">GtkButton</A>::enter signal to the given <AHREF="gtkbutton.html">GtkButton</A>. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN14907"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>button</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The <AHREF="gtkbutton.html">GtkButton</A⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -