Spacing

Spacing — Application GUI spacings

Synopsis




extern      guint GPE_GNOME_SCALING;
#define     SCALING_SIZE
void        init_spacing                    (void);
guint       gpe_get_catspacing              (void);
gchar*      gpe_get_catindent               (void);
guint       gpe_get_border                  (void);
guint       gpe_get_boxspacing              (void);

Description

For creating graphical user interfaces with an unified look and feel it is important to have a set of functions to provide spacing information. The GPE spacing functions provide a basic set of functions for determining the most frquently used sizes for GUI development.

Details

GPE_GNOME_SCALING

extern guint GPE_GNOME_SCALING;

How much to scale down the spacings defined in the Gnome 2 HIG (http://developer.gnome.org/projects/gup/hig/1.0/layout.htmllayout-window) For GPE this value depends on the screen size. For screens with less than SCALING_SIZE pixels wide this factor is 2, above this it is 1 (that means to use the same sizes like in Gnome.


SCALING_SIZE

#define SCALING_SIZE	400

For screen sizes above this we use the same sizes like in Gnome.


init_spacing ()

void        init_spacing                    (void);

Determines scaling by querying display size. This function is usually used by libgpewidget internally.


gpe_get_catspacing ()

guint       gpe_get_catspacing              (void);

Returns spacing between categories.

Returns :Size in pixels.

gpe_get_catindent ()

gchar*      gpe_get_catindent               (void);

Returns size for identing of GUI categories.

Returns :Size in pixels.

gpe_get_border ()

guint       gpe_get_border                  (void);

Get the size of borders around widgets. This is used for borders around windows and dialogs mostly.

Returns :Border size in pixels.

gpe_get_boxspacing ()

guint       gpe_get_boxspacing              (void);

Returns spacings used to separate contents of boxes and tables.

Returns :Spacing in pixels.