MatePropertyBox

## MatePropertyBox MatePropertyBox — Create a tabbed dialog for setting properties and preferences. |

## Synopsis

    #include <libmateui/libmateui.h>

    struct              MatePropertyBox;
    GtkWidget *         mate_property_box_new              (void);
    void                mate_property_box_changed          (MatePropertyBox *property_box);
    void                mate_property_box_set_modified     (MatePropertyBox *property_box,
                                                             gboolean state);
    gint                mate_property_box_append_page      (MatePropertyBox *property_box,
                                                             GtkWidget *child,
                                                             GtkWidget *tab_label);
    void                mate_property_box_set_state        (MatePropertyBox *property_box,
                                                             gboolean state);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----MateDialog
                                                 +----MatePropertyBox

## Implemented Interfaces

MatePropertyBox implements AtkImplementorIface and GtkBuildable.

## Signals

      "apply"                                          : Run Last
      "help"                                           : Run Last

## Description

## Details

### struct MatePropertyBox

    struct MatePropertyBox;

### Warning

`MatePropertyBox` is deprecated and should not be used in newly-written code.

An opaque widget representing a property box. Items should be added to this widget using mate_property_box_append_page.

### mate_property_box_new ()

    GtkWidget *         mate_property_box_new              (void);

### Warning

`mate_property_box_new` is deprecated and should not be used in newly-written code.

Returns : |

### mate_property_box_changed ()

    void                mate_property_box_changed          (MatePropertyBox *property_box);

### Warning

`mate_property_box_changed` is deprecated and should not be used in newly-written code.

When a setting has changed, the code needs to invoke this routine to make the Ok/Apply buttons sensitive.

`property_box` : | The MatePropertyBox that contains the changed data

### mate_property_box_set_modified ()

    void                mate_property_box_set_modified     (MatePropertyBox *property_box,
                                                             gboolean state);

### Warning

`mate_property_box_set_modified` is deprecated and should not be used in newly-written code.

This sets the modified flag of the MatePropertyBox to the value in `state`. Affects whether the OK/Apply buttons are sensitive.

`property_box` : | The MatePropertyBox that contains the changed data
`state` : | The state. `TRUE` means modified, `FALSE` means unmodified.

### mate_property_box_append_page ()

    gint                mate_property_box_append_page      (MatePropertyBox *property_box,
                                                             GtkWidget *child,
                                                             GtkWidget *tab_label);

### Warning

`mate_property_box_append_page` is deprecated and should not be used in newly-written code.

Appends a new page to the MatePropertyBox.

`property_box` : | The property box where we are inserting a new page
`child` : | The widget that is being inserted
`tab_label` : | The widget used as the label for this confiugration page
Returns : | the assigned index of the page inside the MatePropertyBox or -1 if one of the arguments is invalid.

### mate_property_box_set_state ()

    void                mate_property_box_set_state        (MatePropertyBox *property_box,
                                                             gboolean state);

### Warning

`mate_property_box_set_state` is deprecated and should not be used in newly-written code.

An alias for `mate_property_box_set_modified()`.

`property_box` : | The MatePropertyBox that contains the changed data
`state` : | The state. `TRUE` means modified, `FALSE` means unmodified.

## Signal Details

### The `"apply"` signal

    void                user_function                      (MatePropertyBox *propertybox,
                                                            gint              arg1,
                                                            gpointer          user_data)        : Run Last

`propertybox` : | the object which received the signal.
`arg1` : | the notebook page number which emitted the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"help"` signal

    void                user_function                      (MatePropertyBox *propertybox,
                                                            gint              arg1,
                                                            gpointer          user_data)        : Run Last

`propertybox` : | the object which received the signal.
`arg1` : | the notebook page number which emitted the signal.
`user_data` : | user data set when the signal handler was connected.