GNOME.org

GnomePropertyBox

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

Synopsis

#include <libgnomeui/libgnomeui.h>

struct              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 AtkImplementorIface and GtkBuildable.

Signals

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

Description

Details

struct GnomePropertyBox

struct 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.

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.
Generated by GTK-Doc V1.16