GnomePropertyBox: GNOME UI Library Reference Manual

GnomePropertyBox

Functions

GtkWidget *	gnome_property_box_new ()
void	gnome_property_box_changed ()
void	gnome_property_box_set_modified ()
gint	gnome_property_box_append_page ()
void	gnome_property_box_set_state ()

Signals

void	apply	Run Last
void	help	Run Last

Types and Values

struct

GnomePropertyBox

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkWindow
                            ╰── GnomeDialog
                                ╰── GnomePropertyBox

Implemented Interfaces

GnomePropertyBox implements AtkImplementorIface and GtkBuildable.

Includes

#include <libgnomeui/libgnomeui.h>

Description

Functions

gnome_property_box_new ()

GtkWidget *
gnome_property_box_new (void);

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

gnome_property_box_changed ()

void
gnome_property_box_changed (GnomePropertyBox *property_box);

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.

Parameters

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);

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.

Parameters

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);

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

Appends a new page to the GnomePropertyBox.

Returns the assigned index of the page inside the GnomePropertyBox or -1 if one of the arguments is invalid.

Parameters

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

gnome_property_box_set_state ()

void
gnome_property_box_set_state (GnomePropertyBox *property_box,
                              gboolean state);

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

An alias for gnome_property_box_set_modified().

Parameters

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

Types and Values

struct GnomePropertyBox

struct GnomePropertyBox;

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.

Signal Details

The `“apply”` signal

void
user_function (GnomePropertyBox *propertybox,
               gint              arg1,
               gpointer          user_data)

Flags: Run Last

The `“help”` signal

void
user_function (GnomePropertyBox *propertybox,
               gint              arg1,
               gpointer          user_data)

Flags: Run Last