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.