Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkcheckbutton.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkCheckButton
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 create widgets with a discrete toggle button.
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 A #GtkCheckButton places a discrete #GtkToggleButton next to a widget, (usually a #GtkLabel). See the section on #GtkToggleButton widgets for more information about toggle/check buttons.
  10 </para>
  11 <para>
  12 The important signal ('toggled') is also inherited from #GtkToggleButton.
  13 </para>
  14
  15 <!-- ##### SECTION See_Also ##### -->
  16 <para>
  17 <variablelist>
  18 <varlistentry>
  19 <term>#GtkCheckMenuItem</term>
  20 <listitem><para>add check buttons to your menus.</para></listitem>
  21 </varlistentry>
  22 <varlistentry>
  23 <term>#GtkButton</term>
  24 <listitem><para>a more general button.</para></listitem>
  25 </varlistentry>
  26 <varlistentry>
  27 <term>#GtkToggleButton</term>
  28 <listitem><para>#GtkCheckButton's parent.</para></listitem>
  29 </varlistentry>
  30 <varlistentry>
  31 <term>#GtkRadioButton</term>
  32 <listitem><para>group check buttons together.</para></listitem>
  33 </varlistentry>
  34 </variablelist>
  35 </para>
  36
  37 <!-- ##### STRUCT GtkCheckButton ##### -->
  38 <para>
  39 <structfield>toggle_button</structfield> is a #GtkToggleButton representing the actual toggle button that composes the check button.
  40 </para>
  41
  42
  43 <!-- ##### FUNCTION gtk_check_button_new ##### -->
  44 <para>
  45 Creates a new #GtkCheckButton.
  46 </para>
  47
  48 @Returns: a #GtkWidget.
  49
  50
  51 <!-- ##### FUNCTION gtk_check_button_new_with_label ##### -->
  52 <para>
  53 Creates a new #GtkCheckButton with a #GtkLabel to the right of it.
  54 </para>
  55
  56 @label: the text for the check button.
  57 @Returns: a #GtkWidget.
  58
  59
  60 <!-- ##### FUNCTION gtk_check_button_new_with_mnemonic ##### -->
  61 <para>
  62
  63 </para>
  64
  65 @label:
  66 @Returns:
  67
  68
  69 <!-- ##### ARG GtkCheckButton:indicator-spacing ##### -->
  70 <para>
  71
  72 </para>
  73
  74 <!-- ##### ARG GtkCheckButton:indicator-size ##### -->
  75 <para>
  76
  77 </para>
  78