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 <!-- ##### SECTION Stability_Level ##### -->
  38
  39
  40 <!-- ##### SECTION Image ##### -->
  41
  42
  43 <!-- ##### STRUCT GtkCheckButton ##### -->
  44 <para>
  45 <structfield>toggle_button</structfield> is a #GtkToggleButton representing the actual toggle button that composes the check button.
  46 </para>
  47
  48
  49 <!-- ##### ARG GtkCheckButton:indicator-size ##### -->
  50 <para>
  51
  52 </para>
  53
  54 <!-- ##### ARG GtkCheckButton:indicator-spacing ##### -->
  55 <para>
  56
  57 </para>
  58
  59 <!-- ##### FUNCTION gtk_check_button_new ##### -->
  60 <para>
  61 Creates a new #GtkCheckButton.
  62 </para>
  63
  64 @void:
  65 @Returns: a #GtkWidget.
  66
  67
  68 <!-- ##### FUNCTION gtk_check_button_new_with_label ##### -->
  69 <para>
  70 Creates a new #GtkCheckButton with a #GtkLabel to the right of it.
  71 </para>
  72
  73 @label: the text for the check button.
  74 @Returns: a #GtkWidget.
  75
  76
  77 <!-- ##### FUNCTION gtk_check_button_new_with_mnemonic ##### -->
  78 <para>
  79
  80 </para>
  81
  82 @label:
  83 @Returns:
  84
  85