MateDruidPageStandard

MateDruidPageStandard — A widget used to implement the middle pages in a druid's sequence.

Synopsis

#include <libmateui/libmateui.h>

struct              MateDruidPageStandard;
#define             mate_druid_page_standard_set_bg_color
#define             mate_druid_page_standard_set_logo_bg_color
#define             mate_druid_page_standard_set_title_color
GtkWidget *         mate_druid_page_standard_new       (void);
GtkWidget *         mate_druid_page_standard_new_with_vals
                                                        (const gchar *title,
                                                         GdkPixbuf *logo,
                                                         GdkPixbuf *top_watermark);
void                mate_druid_page_standard_set_title (MateDruidPageStandard *druid_page_standard,
                                                         const gchar *title);
void                mate_druid_page_standard_set_logo  (MateDruidPageStandard *druid_page_standard,
                                                         GdkPixbuf *logo_image);
void                mate_druid_page_standard_set_top_watermark
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkPixbuf *top_watermark_image);
void                mate_druid_page_standard_set_title_foreground
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);
void                mate_druid_page_standard_set_background
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);
void                mate_druid_page_standard_set_logo_background
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);
void                mate_druid_page_standard_set_contents_background
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);
void                mate_druid_page_standard_append_item
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         const gchar *question,
                                                         GtkWidget *item,
                                                         const gchar *additional_info);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----MateDruidPage
                                       +----MateDruidPageStandard

Implemented Interfaces

MateDruidPageStandard implements AtkImplementorIface and GtkBuildable.

Properties

  "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

Description

This widget provides similar functionality to that in MateDruidPageEdge. 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).

Note

There are some differences in the programming API between MateDruidEdgePage and MateDruidStandardPage in MATE 2 because the latter has been heavily redesigned internally, whereas the former has not been. Later versions of MATE (2.2 and beyond) may contain further refinements to edge pages).

Details

struct MateDruidPageStandard

struct MateDruidPageStandard {
	GtkWidget *vbox;
	gchar *title;
	GdkPixbuf *logo;
	GdkPixbuf *top_watermark;
	GdkColor title_foreground;
	GdkColor background;
	GdkColor logo_background;
	GdkColor contents_background;
};

Warning

MateDruidPageStandard 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 *vbox;

A packing widget that holds the contents of the page.

gchar *title;

The title of the displayed page.

GdkPixbuf *logo;

The logo of the displayed page.

GdkPixbuf *top_watermark;

The watermark at the top of the displated page.

GdkColor title_foreground;

The color of the title text.

GdkColor background;

The color of the background of the top section and title.

GdkColor logo_background;

The background color of the logo.

GdkColor contents_background;

The background color of the contents section.

mate_druid_page_standard_set_bg_color

#define             mate_druid_page_standard_set_bg_color

Warning

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

This just calls mate_druid_page_standard_set_background() and new code should use that function directly.


mate_druid_page_standard_set_logo_bg_color

#define             mate_druid_page_standard_set_logo_bg_color

Warning

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

This just calls mate_druid_page_standard_set_logo_background() and new code should use that function directly.


mate_druid_page_standard_set_title_color

#define             mate_druid_page_standard_set_title_color

Warning

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

This just calls mate_druid_page_standard_set_title_foregournd() and new code should use that function directly.


mate_druid_page_standard_new ()

GtkWidget *         mate_druid_page_standard_new       (void);

Warning

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

Construct a new MateDruidPageStandard.

Returns :

A new MateDruidPageStandard as a GtkWidget pointer.

mate_druid_page_standard_new_with_vals ()

GtkWidget *         mate_druid_page_standard_new_with_vals
                                                        (const gchar *title,
                                                         GdkPixbuf *logo,
                                                         GdkPixbuf *top_watermark);

Warning

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

Like mate_druid_page_standard_new(), but allows the caller to fill in some of the values at the same time.

title :

The title of the druid page.

logo :

The logo to put on the druid page.

top_watermark :

The watermark to put at the top of the druid page.

Returns :

A new MateDruidPageStandard as a GtkWidget pointer.

mate_druid_page_standard_set_title ()

void                mate_druid_page_standard_set_title (MateDruidPageStandard *druid_page_standard,
                                                         const gchar *title);

Warning

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

Sets the title to the value of title.

druid_page_standard :

A MateDruidPageStandard instance.

title :

The string to use as the new title text.

mate_druid_page_standard_set_logo ()

void                mate_druid_page_standard_set_logo  (MateDruidPageStandard *druid_page_standard,
                                                         GdkPixbuf *logo_image);

Warning

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

druid_page_standard :

A MateDruidPageStandard instance.

logo_image :

The GdkPixbuf to use as a logo.

mate_druid_page_standard_set_top_watermark ()

void                mate_druid_page_standard_set_top_watermark
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkPixbuf *top_watermark_image);

Warning

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

druid_page_standard :

A MateDruidPageStandard instance.

top_watermark_image :

The GdkPixbuf to use as a top watermark.

mate_druid_page_standard_set_title_foreground ()

void                mate_druid_page_standard_set_title_foreground
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);

Warning

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

druid_page_standard :

A MateDruidPageStandard instance.

color :

The new color of the title text.

mate_druid_page_standard_set_background ()

void                mate_druid_page_standard_set_background
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);

Warning

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

druid_page_standard :

A MateDruidPageStandard instance.

color :

The new background color.

mate_druid_page_standard_set_logo_background ()

void                mate_druid_page_standard_set_logo_background
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);

Warning

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

druid_page_standard :

A MateDruidPageStandard instance.

color :

The new color for the logo background.

mate_druid_page_standard_set_contents_background ()

void                mate_druid_page_standard_set_contents_background
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         GdkColor *color);

Warning

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

druid_page_standard :

A MateDruidPageStandard instance.

color :

The new color for the main body's background.

mate_druid_page_standard_append_item ()

void                mate_druid_page_standard_append_item
                                                        (MateDruidPageStandard *druid_page_standard,
                                                         const gchar *question,
                                                         GtkWidget *item,
                                                         const gchar *additional_info);

Warning

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

Convenience function to add a GtkWidget to the MateDruidPageStandard 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.

druid_page_standard :

A MateDruidPageStandard instance.

question :

The text to place above the item.

item :

The GtkWidget to be included.

additional_info :

The text to be placed below the item in a smaller font.

Property Details

The "background" property

  "background"               gchar*                : Write

Background color.

Default value: NULL


The "background-gdk" property

  "background-gdk"           GdkColor*             : Read / Write

Background color as a GdkColor.


The "background-set" property

  "background-set"           gboolean              : Read / Write

Background color is set.

Default value: FALSE


The "contents-background" property

  "contents-background"      gchar*                : Write

Contents Background color.

Default value: NULL


The "contents-background-gdk" property

  "contents-background-gdk"  GdkColor*             : Read / Write

Contents Background color as a GdkColor.


The "contents-background-set" property

  "contents-background-set"  gboolean              : Read / Write

Contents Background color is set.

Default value: FALSE


The "logo" property

  "logo"                     GdkPixbuf*            : Read / Write

Logo image.


The "logo-background" property

  "logo-background"          gchar*                : Write

Logo Background color.

Default value: NULL


The "logo-background-gdk" property

  "logo-background-gdk"      GdkColor*             : Read / Write

Logo Background color as a GdkColor.


The "logo-background-set" property

  "logo-background-set"      gboolean              : Read / Write

Logo Background color is set.

Default value: FALSE


The "title" property

  "title"                    gchar*                : Read / Write

Title of the druid.

Default value: NULL


The "title-foreground" property

  "title-foreground"         gchar*                : Write

Foreground color of the title.

Default value: NULL


The "title-foreground-gdk" property

  "title-foreground-gdk"     GdkColor*             : Read / Write

Foreground color of the title as a GdkColor.


The "title-foreground-set" property

  "title-foreground-set"     gboolean              : Read / Write

Foreground color of the title is set.

Default value: FALSE


The "top-watermark" property

  "top-watermark"            GdkPixbuf*            : Read / Write

Watermark image for the top.