📄 gtktogglebutton.html
字号:
<HTML><HEAD><TITLE>GtkToggleButton</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="GtkTipsQuery"HREF="gtktipsquery.html"><LINKREL="NEXT"TITLE="GtkToolbar"HREF="gtktoolbar.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="gtktipsquery.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="gtktoolbar.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKTOGGLEBUTTON">GtkToggleButton</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN41407"></A><H2>Name</H2>GtkToggleButton -- create buttons which retain their state.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN41410"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtktogglebutton.html#GTKTOGGLEBUTTON-STRUCT">GtkToggleButton</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-NEW">gtk_toggle_button_new</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-NEW-WITH-LABEL">gtk_toggle_button_new_with_label</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);void <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-SET-MODE">gtk_toggle_button_set_mode</A> (<AHREF="gtktogglebutton.html">GtkToggleButton</A> *toggle_button, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> draw_indicator);#define <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-SET-STATE">gtk_toggle_button_set_state</A>void <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-TOGGLED">gtk_toggle_button_toggled</A> (<AHREF="gtktogglebutton.html">GtkToggleButton</A> *toggle_button);<AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-GET-ACTIVE">gtk_toggle_button_get_active</A> (<AHREF="gtktogglebutton.html">GtkToggleButton</A> *toggle_button);void <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-SET-ACTIVE">gtk_toggle_button_set_active</A> (<AHREF="gtktogglebutton.html">GtkToggleButton</A> *toggle_button, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> is_active); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41431"></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> +----<AHREF="gtkbutton.html">GtkButton</A> +----GtkToggleButton</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41439"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtktogglebutton.html#GTKTOGGLEBUTTON--ACTIVE">active</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> : Read / Write "<AHREF="gtktogglebutton.html#GTKTOGGLEBUTTON--DRAW-INDICATOR">draw-indicator</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41446"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtktogglebutton.html#GTKTOGGLEBUTTON-TOGGLED">toggled</A>" void user_function (<AHREF="gtktogglebutton.html">GtkToggleButton</A> *togglebutton, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41452"></A><H2>Description</H2><P>A <AHREF="gtktogglebutton.html">GtkToggleButton</A> is a <AHREF="gtkbutton.html">GtkButton</A> which will remain 'pressed-in' whenclicked. Clicking again will cause the toggle button to return to it'snormal state.</P><P>A toggle button is created by calling either <AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-NEW">gtk_toggle_button_new</A>() or<AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-NEW-WITH-LABEL">gtk_toggle_button_new_with_label</A>(). If using the former, it is advisable topack a widget, (such as a <AHREF="gtklabel.html">GtkLabel</A> and/or a <AHREF="gtkpixmap.html">GtkPixmap</A>), into the togglebutton's container. (See <AHREF="gtkbutton.html">GtkButton</A> for more information).</P><P>The state of a <AHREF="gtktogglebutton.html">GtkToggleButton</A> can be set specifically using<AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-SET-ACTIVE">gtk_toggle_button_set_active</A>(), and retrieved using<AHREF="gtktogglebutton.html#GTK-TOGGLE-BUTTON-GET-ACTIVE">gtk_toggle_button_get_active</A>().</P><P>To simply switch the state of a toggle button, use gtk_toggle_button_toggled.</P><DIVCLASS="EXAMPLE"><ANAME="AEN41468"></A><P><B>Example 1. Creating two <AHREF="gtktogglebutton.html">GtkToggleButton</A> widgets.</B></P><TABLEBORDER="0"BGCOLOR="#D8F8D8"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"> void make_toggles(void) { GtkWidget *dialog, *toggle1, *toggle2; dialog = <AHREF="gtkdialog.html#GTK-DIALOG-NEW">gtk_dialog_new</A>(); toggle1 = gtk_toggle_button_new_with_label("Hi, i'm a toggle button."); /* Makes this toggle button invisible */ gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle1), TRUE); gtk_signal_connect (GTK_OBJECT (toggle1), "toggled", GTK_SIGNAL_FUNC (output_state), NULL); gtk_box_pack_start (GTK_BOX (GTK_DIALOG(dialog)->action_area), toggle1, FALSE, FALSE, 2); toggle2 = gtk_toggle_button_new_with_label("Hi, i'm another toggle button."); gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2), FALSE); gtk_signal_connect (GTK_OBJECT (toggle2), "toggled", GTK_SIGNAL_FUNC (output_state), NULL); gtk_box_pack_start (GTK_BOX (GTK_DIALOG(dialog)->action_area), toggle2, FALSE, FALSE, 2); gtk_widget_show_all (dialog);} </PRE></TD></TR></TABLE></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41473"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN41475"></A><H3><ANAME="GTKTOGGLEBUTTON-STRUCT"></A>struct GtkToggleButton</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkToggleButton;</PRE></TD></TR></TABLE><P>The <AHREF="gtktogglebutton.html">GtkToggleButton</A> struct contains private data only, and should be manipulated using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41481"></A><H3><ANAME="GTK-TOGGLE-BUTTON-NEW"></A>gtk_toggle_button_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_toggle_button_new (void);</PRE></TD></TR></TABLE><P>Creates a new toggle button. A widget should be packed into the button, as in <AHREF="gtkbutton.html#GTK-BUTTON-NEW">gtk_button_new</A>().</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41488"></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">a new toggle button. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41497"></A><H3><ANAME="GTK-TOGGLE-BUTTON-NEW-WITH-LABEL"></A>gtk_toggle_button_new_with_label ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_toggle_button_new_with_label (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *label);</PRE></TD></TR></TABLE><P>Creates a new toggle button with a text label.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41504"></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">a string containing the message to be placed in the toggle button.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new toggle button. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41517"></A><H3><ANAME="GTK-TOGGLE-BUTTON-SET-MODE"></A>gtk_toggle_button_set_mode ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_toggle_button_set_mode (<AHREF="gtktogglebutton.html">GtkToggleButton</A> *toggle_button, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> draw_indicator);</PRE></TD></TR></TABLE><P>Determines whether or not the toggle button is drawn on screen. The default mode is FALSE, which results in the button being displayed. To make the button invisible, set <TT⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -