![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkSettings; GtkSettingsValue; GtkSettings* gtk_settings_get_default (void); GtkSettings* gtk_settings_get_for_screen (GdkScreen *screen); void gtk_settings_install_property (GParamSpec *pspec); void gtk_settings_install_property_parser (GParamSpec *pspec, GtkRcPropertyParser parser); gboolean gtk_rc_property_parse_color (const GParamSpec *pspec, const GString *gstring, GValue *property_value); gboolean gtk_rc_property_parse_enum (const GParamSpec *pspec, const GString *gstring, GValue *property_value); gboolean gtk_rc_property_parse_flags (const GParamSpec *pspec, const GString *gstring, GValue *property_value); gboolean gtk_rc_property_parse_requisition (const GParamSpec *pspec, const GString *gstring, GValue *property_value); gboolean gtk_rc_property_parse_border (const GParamSpec *pspec, const GString *gstring, GValue *property_value); void gtk_settings_set_property_value (GtkSettings *settings, const gchar *name, const GtkSettingsValue *svalue); void gtk_settings_set_string_property (GtkSettings *settings, const gchar *name, const gchar *v_string, const gchar *origin); void gtk_settings_set_long_property (GtkSettings *settings, const gchar *name, glong v_long, const gchar *origin); void gtk_settings_set_double_property (GtkSettings *settings, const gchar *name, gdouble v_double, const gchar *origin);
typedef struct { GObject parent_instance; GData *queued_settings; /* of type GtkSettingsValue* */ GtkSettingsPropertyValue *property_values; GtkRcContext *rc_context; GdkScreen *screen; } GtkSettings;
typedef struct { /* origin should be something like "filename:linenumber" for rc files, * or e.g. "XProperty" for other sources */ gchar *origin; /* valid types are LONG, DOUBLE and STRING corresponding to the token parsed, * or a GSTRING holding an unparsed statement */ GValue value; } GtkSettingsValue;
GtkSettings* gtk_settings_get_default (void);
Gets the GtkSettings object for the default GDK screen, creating
it if necessary. See gtk_settings_get_for_screen()
.
Returns : |
a GtkSettings object. If there is no default
screen, then returns NULL .
|
GtkSettings* gtk_settings_get_for_screen (GdkScreen *screen);
Gets the GtkSettings object for screen
, creating it if necessary.
|
a GdkScreen. |
Returns : |
a GtkSettings object. |
Since 2.2
void gtk_settings_install_property_parser (GParamSpec *pspec, GtkRcPropertyParser parser);
|
|
|
gboolean gtk_rc_property_parse_color (const GParamSpec *pspec, const GString *gstring, GValue *property_value);
A GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser()
which parses a
color given either by its name or in the form
{ red, green, blue }
where red
, green
and
blue
are integers between 0 and 65535 or floating-point numbers
between 0 and 1.
gboolean gtk_rc_property_parse_enum (const GParamSpec *pspec, const GString *gstring, GValue *property_value);
A GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser()
which parses a single
enumeration value.
The enumeration value can be specified by its name, its nickname or its numeric value. For consistency with flags parsing, the value may be surrounded by parentheses.
|
a GParamSpec |
|
the GString to be parsed |
|
a GValue which must hold enum values. |
Returns : |
TRUE if gstring could be parsed and property_value
has been set to the resulting GEnumValue.
|
gboolean gtk_rc_property_parse_flags (const GParamSpec *pspec, const GString *gstring, GValue *property_value);
A GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser()
which parses flags.
Flags can be specified by their name, their nickname or
numerically. Multiple flags can be specified in the form
"( flag1 | flag2 | ... )"
.
|
a GParamSpec |
|
the GString to be parsed |
|
a GValue which must hold flags values. |
Returns : |
TRUE if gstring could be parsed and property_value
has been set to the resulting flags value.
|
gboolean gtk_rc_property_parse_requisition (const GParamSpec *pspec, const GString *gstring, GValue *property_value);
A GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser()
which parses a
requisition in the form
"{ width, height }"
for integers width
and height
.
|
a GParamSpec |
|
the GString to be parsed |
|
a GValue which must hold boxed values. |
Returns : |
TRUE if gstring could be parsed and property_value
has been set to the resulting GtkRequisition.
|
gboolean gtk_rc_property_parse_border (const GParamSpec *pspec, const GString *gstring, GValue *property_value);
A GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser()
which parses
borders in the form
"{ left, right, top, bottom }"
for integers
left
, right
, top
and bottom
.
|
a GParamSpec |
|
the GString to be parsed |
|
a GValue which must hold boxed values. |
Returns : |
TRUE if gstring could be parsed and property_value
has been set to the resulting GtkBorder.
|
void gtk_settings_set_property_value (GtkSettings *settings, const gchar *name, const GtkSettingsValue *svalue);
|
|
|
|
|
void gtk_settings_set_string_property (GtkSettings *settings, const gchar *name, const gchar *v_string, const gchar *origin);
|
|
|
|
|
|
|
void gtk_settings_set_long_property (GtkSettings *settings, const gchar *name, glong v_long, const gchar *origin);
|
|
|
|
|
|
|
void gtk_settings_set_double_property (GtkSettings *settings, const gchar *name, gdouble v_double, const gchar *origin);
|
|
|
|
|
|
|