## GnomePropertyBox

GnomePropertyBox — Create a tabbed dialog for setting properties and preferences.

## Synopsis

    #include <libgnomeui/libgnomeui.h>

                        GnomePropertyBox;
    GtkWidget *         gnome_property_box_new              (void);
    void                gnome_property_box_changed          (GnomePropertyBox *property_box);
    void                gnome_property_box_set_modified     (GnomePropertyBox *property_box,
                                                             gboolean state);
    gint                gnome_property_box_append_page      (GnomePropertyBox *property_box,
                                                             GtkWidget *child,
                                                             GtkWidget *tab_label);
    void                gnome_property_box_set_state        (GnomePropertyBox *property_box,
                                                             gboolean state);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----GnomeDialog
                                                 +----GnomePropertyBox

## Implemented Interfaces

GnomePropertyBox implements GtkBuildable and AtkImplementorIface.

## Signals

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

## Description

## Details

### GnomePropertyBox

    typedef struct _GnomePropertyBox GnomePropertyBox;

### Warning

`GnomePropertyBox` 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 gnome_property_box_append_page.

### gnome_property_box_new ()

    GtkWidget *         gnome_property_box_new              (void);

### Warning

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

Creates a new GnomePropertyBox widget. The PropertyBox widget is useful for making consistent configuration dialog boxes.

When a setting has been made to a property in the PropertyBox your program needs to invoke the gnome_property_box_changed to signal a change (this will enable the Ok/Apply buttons).

Returns : | a newly created GnomePropertyBox widget.

### gnome_property_box_changed ()

    void                gnome_property_box_changed          (GnomePropertyBox *property_box);

### Warning

`gnome_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 GnomePropertyBox that contains the changed data

### gnome_property_box_set_modified ()

    void                gnome_property_box_set_modified     (GnomePropertyBox *property_box,
                                                             gboolean state);

### Warning

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

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

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

### gnome_property_box_append_page ()

    gint                gnome_property_box_append_page      (GnomePropertyBox *property_box,
                                                             GtkWidget *child,
                                                             GtkWidget *tab_label);

### Warning

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

Appends a new page to the GnomePropertyBox.

`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 GnomePropertyBox or -1 if one of the arguments is invalid.

### gnome_property_box_set_state ()

    void                gnome_property_box_set_state        (GnomePropertyBox *property_box,
                                                             gboolean state);

### Warning

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

An alias for `gnome_property_box_set_modified()`.

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

## Signal Details

### The `"apply"` signal

    void                user_function                      (GnomePropertyBox *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                      (GnomePropertyBox *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.