## GtkToggleCombo

GtkToggleCombo — A toggle combo widget for GTK.

## Synopsis

    #include <gtkextra.h>

                        GtkToggleCombo;
    GtkWidget*          gtk_toggle_combo_new                (gint nrows,
                                                             gint ncols);
    void                gtk_toggle_combo_construct          (GtkToggleCombo *toggle_combo,
                                                             gint nrows,
                                                             gint ncols);
    gint                gtk_toggle_combo_get_nrows          (GtkToggleCombo *combo);
    gint                gtk_toggle_combo_get_ncols          (GtkToggleCombo *combo);
    void                gtk_toggle_combo_select             (GtkToggleCombo *toggle_combo,
                                                             gint new_row,
                                                             gint new_col);
    void                gtk_toggle_combo_get_selection      (GtkToggleCombo *combo,
                                                             gint *row,
                                                             gint *col);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkHBox
                                           +----GtkComboButton
                                                 +----GtkToggleCombo

## Implemented Interfaces

GtkToggleCombo implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Signals

      "changed"                                        : Run First

## Description

A GtkToggleCombo is a GtkCombo which will remain 'pressed-in' when clicked. Clicking it again will cause the toggle combo to return to it's normal state. A toggle combo is created by calling `gtk_toggle_combo_new()`. The number of rows/columns may be find out by calling `gtk_toggle_combo_get_nrows()` or `gtk_toggle_combo_get_ncols()`. A combo row may be selected with `gtk_toggle_combo_select()`.The current selection is returned by `gtk_toggle_combo_get_selection()`.

## Details

### GtkToggleCombo

    typedef struct _GtkToggleCombo GtkToggleCombo;

The GtkToggleCombo struct contains only private data. It should only be accessed through the functions described below.

### gtk_toggle_combo_new ()

    GtkWidget*          gtk_toggle_combo_new                (gint nrows,
                                                             gint ncols);

Creates a new GtkToggleCombo widget with `nrows` rows and `ncols` columns.

`nrows` : | number of rows
`ncols` : | number of columns
Returns : | the newly-created GtkToggleCombo widget.

### gtk_toggle_combo_construct ()

    void                gtk_toggle_combo_construct          (GtkToggleCombo *toggle_combo,
                                                             gint nrows,
                                                             gint ncols);

Initializes the GtkToggleCombo with `nrows` rows and `ncols` columns.

`toggle_combo` : | a GtkToggleCombo
`nrows` : | number of rows
`ncols` : | number of columns

### gtk_toggle_combo_get_nrows ()

    gint                gtk_toggle_combo_get_nrows          (GtkToggleCombo *combo);

Get the number of rows in GtkToggleCombo.

`combo` : | a GtkToggleCombo
Returns : | number of rows

### gtk_toggle_combo_get_ncols ()

    gint                gtk_toggle_combo_get_ncols          (GtkToggleCombo *combo);

Get the number of columns in GtkToggleCombo.

`combo` : | a GtkToggleCombo
Returns : | number of columns

### gtk_toggle_combo_select ()

    void                gtk_toggle_combo_select             (GtkToggleCombo *toggle_combo,
                                                             gint new_row,
                                                             gint new_col);

Select the cell(row,col) from GtkToggleCombo.

`toggle_combo` : | a GtkToggleCombo
`new_row` : | number of row
`new_col` : | number of column

### gtk_toggle_combo_get_selection ()

    void                gtk_toggle_combo_get_selection      (GtkToggleCombo *combo,
                                                             gint *row,
                                                             gint *col);

Get the current selection(row,col) in GtkToggleCombo.

`combo` : | a GtkToggleCombo
`row` : | number of row
`col` : | number of column

## Signal Details

### The `"changed"` signal

    void                user_function                      (GtkToggleCombo *toggle_combo,
                                                            gint            row,
                                                            gint            col,
                                                            gpointer        user_data)         : Run First

Emmited when the `row`,`col` are selected in GtkToggleCombo

`toggle_combo` : | the GtkToggleCombo object that received the signal
`row` : | row number
`col` : | column number
`user_data` : | user data set when the signal handler was connected.