![]() |
![]() |
![]() |
GNOME UI Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
GnomeDruidPageStandardGnomeDruidPageStandard — A widget used to implement the middle pages in a druid's sequence. |
#include <libgnomeui/libgnomeui.h> GnomeDruidPageStandard; #define gnome_druid_page_standard_set_bg_color #define gnome_druid_page_standard_set_logo_bg_color #define gnome_druid_page_standard_set_title_color GtkWidget * gnome_druid_page_standard_new (void); GtkWidget * gnome_druid_page_standard_new_with_vals (const gchar *title, GdkPixbuf *logo, GdkPixbuf *top_watermark); void gnome_druid_page_standard_set_title (GnomeDruidPageStandard *druid_page_standard, const gchar *title); void gnome_druid_page_standard_set_logo (GnomeDruidPageStandard *druid_page_standard, GdkPixbuf *logo_image); void gnome_druid_page_standard_set_top_watermark (GnomeDruidPageStandard *druid_page_standard, GdkPixbuf *top_watermark_image); void gnome_druid_page_standard_set_title_foreground (GnomeDruidPageStandard *druid_page_standard, GdkColor *color); void gnome_druid_page_standard_set_background (GnomeDruidPageStandard *druid_page_standard, GdkColor *color); void gnome_druid_page_standard_set_logo_background (GnomeDruidPageStandard *druid_page_standard, GdkColor *color); void gnome_druid_page_standard_set_contents_background (GnomeDruidPageStandard *druid_page_standard, GdkColor *color); void gnome_druid_page_standard_append_item (GnomeDruidPageStandard *druid_page_standard, const gchar *question, GtkWidget *item, const gchar *additional_info);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GnomeDruidPage +----GnomeDruidPageStandard
"background" gchar* : Write "background-gdk" GdkColor* : Read / Write "background-set" gboolean : Read / Write "contents-background" gchar* : Write "contents-background-gdk" GdkColor* : Read / Write "contents-background-set" gboolean : Read / Write "logo" GdkPixbuf* : Read / Write "logo-background" gchar* : Write "logo-background-gdk" GdkColor* : Read / Write "logo-background-set" gboolean : Read / Write "title" gchar* : Read / Write "title-foreground" gchar* : Write "title-foreground-gdk" GdkColor* : Read / Write "title-foreground-set" gboolean : Read / Write "top-watermark" GdkPixbuf* : Read / Write
This widget provides similar functionality to that in GnomeDruidPageEdge. It is used for pages that are not the initial or terminal pages of a druid.
The main difference between an edge and a standard druid page (in a display sense) is that standard pages do not have a left-side watermark and the body of the contents section is a bit more arbitrary (it is a GTK+ vbox widget), rather than just displaying text (which is the common case for edge pages).
There are some differences in the programming API between GnomeDruidEdgePage and GnomeDruidStandardPage in GNOME 2 because the latter has been heavily redesigned internally, whereas the former has not been. Later versions of GNOME (2.2 and beyond) may contain further refinements to edge pages).
typedef struct { GtkWidget *vbox; gchar *title; GdkPixbuf *logo; GdkPixbuf *top_watermark; GdkColor title_foreground; GdkColor background; GdkColor logo_background; GdkColor contents_background; } GnomeDruidPageStandard;
GnomeDruidPageStandard
is deprecated and should not be used in newly-written code.
A widget representing pages that are not initial or terminal pages of a druid.
GtkWidget * |
A packing widget that holds the contents of the page. |
gchar * |
The title of the displayed page. |
GdkPixbuf * |
The logo of the displayed page. |
GdkPixbuf * |
The watermark at the top of the displated page. |
GdkColor |
The color of the title text. |
GdkColor |
The color of the background of the top section and title. |
GdkColor |
The background color of the logo. |
GdkColor |
The background color of the contents section. |
#define gnome_druid_page_standard_set_bg_color
gnome_druid_page_standard_set_bg_color
is deprecated and should not be used in newly-written code.
This just calls gnome_druid_page_standard_set_background()
and new code should
use that function directly.
#define gnome_druid_page_standard_set_logo_bg_color
gnome_druid_page_standard_set_logo_bg_color
is deprecated and should not be used in newly-written code.
This just calls gnome_druid_page_standard_set_logo_background()
and new code
should use that function directly.
#define gnome_druid_page_standard_set_title_color
gnome_druid_page_standard_set_title_color
is deprecated and should not be used in newly-written code.
This just calls gnome_druid_page_standard_set_title_foregournd()
and new code
should use that function directly.
GtkWidget * gnome_druid_page_standard_new (void);
gnome_druid_page_standard_new
is deprecated and should not be used in newly-written code.
Construct a new GnomeDruidPageStandard.
Returns : |
A new GnomeDruidPageStandard as a GtkWidget pointer. |
GtkWidget * gnome_druid_page_standard_new_with_vals (const gchar *title, GdkPixbuf *logo, GdkPixbuf *top_watermark);
gnome_druid_page_standard_new_with_vals
is deprecated and should not be used in newly-written code.
Like gnome_druid_page_standard_new()
, but allows the caller to fill in some
of the values at the same time.
|
The title of the druid page. |
|
The logo to put on the druid page. |
|
The watermark to put at the top of the druid page. |
Returns : |
A new GnomeDruidPageStandard as a GtkWidget pointer. |
void gnome_druid_page_standard_set_title (GnomeDruidPageStandard *druid_page_standard, const gchar *title);
gnome_druid_page_standard_set_title
is deprecated and should not be used in newly-written code.
Sets the title to the value of title
.
|
A GnomeDruidPageStandard instance. |
|
The string to use as the new title text. |
void gnome_druid_page_standard_set_logo (GnomeDruidPageStandard *druid_page_standard, GdkPixbuf *logo_image);
gnome_druid_page_standard_set_logo
is deprecated and should not be used in newly-written code.
Sets a GdkPixbuf as the logo in the top right corner.
If NULL
, then no logo will be displayed.
|
A GnomeDruidPageStandard instance. |
|
The GdkPixbuf to use as a logo. |
void gnome_druid_page_standard_set_top_watermark (GnomeDruidPageStandard *druid_page_standard, GdkPixbuf *top_watermark_image);
gnome_druid_page_standard_set_top_watermark
is deprecated and should not be used in newly-written code.
Sets a GdkPixbuf as the watermark on top of the top
strip on the druid. If top_watermark_image is NULL
, it is reset
to the normal color.
|
A GnomeDruidPageStandard instance. |
|
The GdkPixbuf to use as a top watermark. |
void gnome_druid_page_standard_set_title_foreground (GnomeDruidPageStandard *druid_page_standard, GdkColor *color);
gnome_druid_page_standard_set_title_foreground
is deprecated and should not be used in newly-written code.
Sets the title text to the specified color.
|
A GnomeDruidPageStandard instance. |
|
The new color of the title text. |
void gnome_druid_page_standard_set_background (GnomeDruidPageStandard *druid_page_standard, GdkColor *color);
gnome_druid_page_standard_set_background
is deprecated and should not be used in newly-written code.
Sets the background color of the top section of the druid page to color
.
|
A GnomeDruidPageStandard instance. |
|
The new background color. |
void gnome_druid_page_standard_set_logo_background (GnomeDruidPageStandard *druid_page_standard, GdkColor *color);
gnome_druid_page_standard_set_logo_background
is deprecated and should not be used in newly-written code.
Sets the background of the logo to color
.
|
A GnomeDruidPageStandard instance. |
|
The new color for the logo background. |
void gnome_druid_page_standard_set_contents_background (GnomeDruidPageStandard *druid_page_standard, GdkColor *color);
gnome_druid_page_standard_set_contents_background
is deprecated and should not be used in newly-written code.
Sets the color of the main contents section's background to color
.
|
A GnomeDruidPageStandard instance. |
|
The new color for the main body's background. |
void gnome_druid_page_standard_append_item (GnomeDruidPageStandard *druid_page_standard, const gchar *question, GtkWidget *item, const gchar *additional_info);
gnome_druid_page_standard_append_item
is deprecated and should not be used in newly-written code.
Convenience function to add a GtkWidget to the
GnomeDruidPageStandard vbox. This function creates a new contents section
that has the question
text followed by the item
widget and then the
addition_info
text, all stacked vertically from top to bottom.
The item
widget could be something like a set of radio checkbuttons
requesting a choice from the user.
|
A GnomeDruidPageStandard instance. |
|
The text to place above the item. |
|
The GtkWidget to be included. |
|
The text to be placed below the item in a smaller font. |
"background-gdk"
property"background-gdk" GdkColor* : Read / Write
Background color as a GdkColor.
"background-set"
property"background-set" gboolean : Read / Write
Background color is set.
Default value: FALSE
"contents-background"
property"contents-background" gchar* : Write
Contents Background color.
Default value: NULL
"contents-background-gdk"
property"contents-background-gdk" GdkColor* : Read / Write
Contents Background color as a GdkColor.
"contents-background-set"
property"contents-background-set" gboolean : Read / Write
Contents Background color is set.
Default value: FALSE
"logo-background"
property"logo-background" gchar* : Write
Logo Background color.
Default value: NULL
"logo-background-gdk"
property"logo-background-gdk" GdkColor* : Read / Write
Logo Background color as a GdkColor.
"logo-background-set"
property"logo-background-set" gboolean : Read / Write
Logo Background color is set.
Default value: FALSE
"title-foreground"
property"title-foreground" gchar* : Write
Foreground color of the title.
Default value: NULL
"title-foreground-gdk"
property"title-foreground-gdk" GdkColor* : Read / Write
Foreground color of the title as a GdkColor.
"title-foreground-set"
property"title-foreground-set" gboolean : Read / Write
Foreground color of the title is set.
Default value: FALSE