GtkCheckButton

Name

GtkCheckButton -- create widgets with a discrete toggle button.

Synopsis


#include <gtk/gtk.h>


struct      GtkCheckButton;
GtkWidget*  gtk_check_button_new            (void);
GtkWidget*  gtk_check_button_new_with_label (const gchar *label);
GtkWidget*  gtk_check_button_new_with_mnemonic
                                            (const gchar *label);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkButton
                                 +----GtkToggleButton
                                       +----GtkCheckButton

Description

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.

The important signal ('toggled') is also inherited from GtkToggleButton.

Details

struct GtkCheckButton

struct GtkCheckButton;

toggle_button is a GtkToggleButton representing the actual toggle button that composes the check button.


gtk_check_button_new ()

GtkWidget*  gtk_check_button_new            (void);

Creates a new GtkCheckButton.

Returns :a GtkWidget.


gtk_check_button_new_with_label ()

GtkWidget*  gtk_check_button_new_with_label (const gchar *label);

Creates a new GtkCheckButton with a GtkLabel to the right of it.

label :the text for the check button.
Returns :a GtkWidget.


gtk_check_button_new_with_mnemonic ()

GtkWidget*  gtk_check_button_new_with_mnemonic
                                            (const gchar *label);

Creates a new GtkCheckButton containing a label. If characters in label are preceded by an underscore, they are underlined indicating that they represent a keyboard accelerator called a mnemonic. Pressing Alt and that key activates the checkbutton.

label : The text of the button, with an underscore in front of the mnemonic character
Returns : a new GtkCheckButton

See Also

GtkCheckMenuItem

add check buttons to your menus.

GtkButton

a more general button.

GtkToggleButton

GtkCheckButton's parent.

GtkRadioButton

group check buttons together.