GTK+ Reference Manual |
||||
---|---|---|---|---|
Параметры настройкиSettings Совместное использование параметров настройки между приложениями |
#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);
GObject
+----GtkSettings
"gtk-alternative-button-order" gboolean : Чтение / Запись
"gtk-button-images" gboolean : Чтение / Запись
"gtk-can-change-accels" gboolean : Чтение / Запись
"gtk-color-palette" gchararray : Чтение / Запись
"gtk-cursor-blink" gboolean : Чтение / Запись
"gtk-cursor-blink-time" gint : Чтение / Запись
"gtk-cursor-theme-name" gchararray : Чтение / Запись
"gtk-cursor-theme-size" gint : Чтение / Запись
"gtk-dnd-drag-threshold" gint : Чтение / Запись
"gtk-double-click-distance" gint : Чтение / Запись
"gtk-double-click-time" gint : Чтение / Запись
"gtk-entry-select-on-focus" gboolean : Чтение / Запись
"gtk-fallback-icon-theme" gchararray : Чтение / Запись
"gtk-font-name" gchararray : Чтение / Запись
"gtk-icon-sizes" gchararray : Чтение / Запись
"gtk-icon-theme-name" gchararray : Чтение / Запись
"gtk-key-theme-name" gchararray : Чтение / Запись
"gtk-menu-bar-accel" gchararray : Чтение / Запись
"gtk-menu-bar-popup-delay" gint : Чтение / Запись
"gtk-menu-images" gboolean : Чтение / Запись
"gtk-menu-popdown-delay" gint : Чтение / Запись
"gtk-menu-popup-delay" gint : Чтение / Запись
"gtk-modules" gchararray : Чтение / Запись
"gtk-split-cursor" gboolean : Чтение / Запись
"gtk-theme-name" gchararray : Чтение / Запись
"gtk-toolbar-icon-size" GtkIconSize : Чтение / Запись
"gtk-toolbar-style" GtkToolbarStyle : Чтение / Запись
"gtk-xft-antialias" gint : Чтение / Запись
"gtk-xft-dpi" gint : Чтение / Запись
"gtk-xft-hinting" gint : Чтение / Запись
"gtk-xft-hintstyle" gchararray : Чтение / Запись
"gtk-xft-rgba" gchararray : Чтение / Запись
typedef struct _GtkSettings GtkSettings;
GtkSettingsValue
typedef struct {
/* начало должно быть нечто вроде "filename:linenumber" для rc файлов,
* или например "XProperty" для других источников
*/
gchar *origin;
/* допустимы типы LONG, DOUBLE и STRING соответствующий анализируемому символу,
* или GSTRING содержащий не анализируемый элемент
*/
GValue value;
} GtkSettingsValue;
gtk_settings_get_default ()
GtkSettings* gtk_settings_get_default (void);
Выдаёт объект GtkSettings
для экрана по умолчанию GDK, создавая при
необходимости. Смотрите
gtk_settings_get_for_screen().
Возвращает : |
Объект GtkSettings . Если нет экрана по умолчанию, то возвращает NULL. |
GtkSettings* gtk_settings_get_for_screen (GdkScreen *screen);Выдаёт объект GtkSettings для screen, создавая при необходимости.
screen : |
|
Возвращает : |
Объект GtkSettings. |
Начиная с версии 2.2
void gtk_settings_install_property (GParamSpec *pspec);
pspec : |
void gtk_settings_install_property_parser
(GParamSpec *pspec,
GtkRcPropertyParser parser);
pspec : |
|
parser : |
gboolean gtk_rc_property_parse_color (const GParamSpec *pspec,
const GString *gstring,
GValue *property_value);
GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser() которая анализирует полученный цвет по имени или форме { red, green, blue } где red, green и blue целые значения между 0 and 65535 или десятичные между 0 and 1.
pspec : |
|
gstring : |
Анализируемый GString |
property_value : |
|
Возвращает : |
TRUE если gstring может анализироваться и property_value было установлено результирующим GdkColor. |
gboolean gtk_rc_property_parse_enum (const GParamSpec *pspec,
const GString *gstring,
GValue *property_value);
GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser() которая анализирует единственное значение перечисления.
Значение перечисления может быть определено его именем, его псевдонимом (nickname) или его числовым значением. Для последовательности с анализируемыми флагами, значение может быть окружено скобками.
pspec : |
|
gstring : |
Анализируемый GString |
property_value : |
GValue который должен содержать значения перечисления. |
Возвращает : |
TRUE если gstring может анализироваться и property_value было установлено результирующим GEnumValue. |
gboolean gtk_rc_property_parse_flags (const GParamSpec *pspec,
const GString *gstring,
GValue *property_value);
GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser() которая анализирует флаги.
Флаги могут быть определены по имени, псевдониму (nickname) или ноеру. Множество флагов может быть определено в форме "( flag1 | flag2 | ... )".
pspec : |
|
gstring : |
Анализируемый GString |
property_value : |
GValue который должен содержать значения флагов. |
Возвращает : |
TRUE если gstring может анализироваться и property_value было установлено результирующим значением флагов. |
gboolean gtk_rc_property_parse_requisition
(const GParamSpec *pspec,
const GString *gstring,
GValue *property_value);
GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser() которая анализирует запрос в форме "{ width, height }" для целых width и height.
pspec : |
|
gstring : |
Анализируемый GString |
property_value : |
GValue который должен содержать ограниченные значения. |
Возвращает : |
TRUE если gstring может анализироваться и property_value было установлено результирующим GtkRequisition. |
gboolean gtk_rc_property_parse_border (const GParamSpec *pspec,
const GString *gstring,
GValue *property_value);
GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser() которая анализирует границы в форме "{ left, right, top, bottom }" для целых left, right, top и bottom.
pspec : |
|
gstring : |
Анализируемый GString |
property_value : |
GValue который должен содержать ограниченные значения. |
Возвращает : |
TRUE если gstring может анализироваться и property_value был установлен результирующим GtkBorder. |
void gtk_settings_set_property_value (GtkSettings *settings,
const gchar *name,
const GtkSettingsValue *svalue);
settings : |
|
name : |
|
svalue : |
void gtk_settings_set_string_property
(GtkSettings *settings,
const gchar *name,
const gchar *v_string,
const gchar *origin);
settings : |
|
name : |
|
v_string : |
|
origin : |
void gtk_settings_set_long_property (GtkSettings *settings,
const gchar *name,
glong v_long,
const gchar *origin);
settings : |
|
name : |
|
v_long : |
|
origin : |
void gtk_settings_set_double_property
(GtkSettings *settings,
const gchar *name,
gdouble v_double,
const gchar *origin);
settings : |
|
name : |
|
v_double : |
|
origin : |
"gtk-alternative-button-order" gboolean : Чтение / ЗаписьДолжны ли кнопки в диалогах использовать альтернативный порядок.
Значение по умолчанию: FALSE
Свойство "gtk-button-images"
"gtk-button-images" gboolean : Чтение / ЗаписьДолжны ли значки показываться на кнопках.
Значение по умолчанию: TRUE
Свойство "gtk-can-change-accels"
"gtk-can-change-accels" gboolean : Чтение / ЗаписьДолжны ли акселераторы меню изменяться нажатием клавиши на пункте меню.
Значение по умолчанию: FALSE
Свойство "gtk-color-palette"
"gtk-color-palette" gchararray : Чтение / ЗаписьПалитра используемая в диалоге выбора цвета.
Значение по умолчанию: "black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90"
Свойство "gtk-cursor-blink"
"gtk-cursor-blink" gboolean : Чтение / ЗаписьДолжен ли курсор мерцать.
Значение по умолчанию: TRUE
Свойство "gtk-cursor-blink-time"
"gtk-cursor-blink-time" gint : Чтение / ЗаписьПродолжительность мерцания курсора в милесекундах.
Допустимые значения: >= 100
Значение по умолчанию: 1200
Свойство "gtk-cursor-theme-name"
"gtk-cursor-theme-name" gchararray : Чтение / ЗаписьИмя используемой темы курсора.
Значение по умолчанию: NULL
Свойство "gtk-cursor-theme-size"
"gtk-cursor-theme-size" gint : Чтение / ЗаписьРазмер используемый для курсоров.
Допустимые значения: [0,128]
Значение по умолчанию: 24
Свойство "gtk-dnd-drag-threshold"
"gtk-dnd-drag-threshold" gint : Чтение / ЗаписьЧисло пикселей на которое может двигаться курсор перед перемещением.
Допустимые значения: >= 1
Значение по умолчанию: 8
Свойство "gtk-double-click-distance"
"gtk-double-click-distance" gint : Чтение / ЗаписьМаксимальный допустимый интервал расстояния между двумя кликами, рассматриваемый как двойной щелчок (double click), в пикселах (in pixels).
Допустимые значения: >= 0
Значение по умолчанию: 5
Свойство "gtk-double-click-time"
"gtk-double-click-time" gint : Чтение / ЗаписьМаксимальный допустимый временной интервал между двумя кликами рассматриваемых как двойной щелчок (in milliseconds).
Допустимые значения: >= 0
Значение по умолчанию: 250
Свойство "gtk-entry-select-on-focus"
"gtk-entry-select-on-focus" gboolean : Чтение / ЗаписьВыбрано ли содержимое ввода когда находится в фокусе.
Значение по умолчанию: TRUE
Свойство "gtk-fallback-icon-theme"
"gtk-fallback-icon-theme" gchararray : Чтение / ЗаписьИмя темы значка для резерва.
Значение по умолчанию: NULL
Свойство "gtk-font-name"
"gtk-font-name" gchararray : Чтение / ЗаписьИмя используемого по умолчанию шрифта.
Значение по умолчанию: "Sans 10"
Свойство "gtk-icon-sizes"
"gtk-icon-sizes" gchararray : Чтение / ЗаписьСписок размеров значков (gtk-menu=16,16:gtk-button=20,20...
Значение по умолчанию: NULL
Свойство "gtk-icon-theme-name"
"gtk-icon-theme-name" gchararray : Чтение / ЗаписьИмя используемой темы значков.
Значение по умолчанию: "hicolor"
Свойство "gtk-key-theme-name"
"gtk-key-theme-name" gchararray : Чтение / ЗаписьИмя ключевой темы RC файла для загрузки.
Значение по умолчанию: NULL
Свойство "gtk-menu-bar-accel"
"gtk-menu-bar-accel" gchararray : Чтение / ЗаписьКлавиша для активации панели меню.
Значение по умолчанию: "F10"
Свойство "gtk-menu-bar-popup-delay"
"gtk-menu-bar-popup-delay" gint : Чтение / ЗаписьЗадержка перед появлением подменю после панели меню.
Допустимые значения: >= 0
Значение по умолчанию: 0
Свойство "gtk-menu-images"
"gtk-menu-images" gboolean : Чтение / ЗаписьДолжны ли изображения показываться в меню.
Значение по умолчанию: TRUE
Свойство "gtk-menu-popdown-delay"
"gtk-menu-popdown-delay" gint : Чтение / ЗаписьВремя перед скрытием подменю когда указатель перемещается на подменю.
Допустимые значения: >= 0
Значение по умолчанию: 1000
Свойство "gtk-menu-popup-delay"
"gtk-menu-popup-delay" gint : Чтение / ЗаписьМинимальное время которое указатель должен оставаться на пункте меню перед появлением подменю.
Допустимые значения: >= 0
Значение по умолчанию: 225
Свойство "gtk-modules"
"gtk-modules" gchararray : Чтение / ЗаписьСписок активных GTK модулей.
Значение по умолчанию: NULL
Свойство "gtk-split-cursor"
"gtk-split-cursor" gboolean : Чтение / ЗаписьДолжны ли отображаться два курсора для смешанного слева на право и справа на лево (left-to-right and right-to-left) текста.
Значение по умолчанию: TRUE
Свойство "gtk-theme-name"
"gtk-theme-name" gchararray : Чтение / ЗаписьИмя темы загружаемой из RC файла.
Значение по умолчанию: "Raleigh"
Свойство "gtk-toolbar-icon-size"
"gtk-toolbar-icon-size" GtkIconSize : Чтение / ЗаписьРазмер значков в панели инструментов по умолчанию.
Значение по умолчанию: GTK_ICON_SIZE_LARGE_TOOLBAR
Свойство "gtk-toolbar-style"
"gtk-toolbar-style" GtkToolbarStyle : Чтение / ЗаписьЗначение панели инструментов по умолчанию - только текст, текст и значки, только значки и т.д..
Значение по умолчанию: GTK_TOOLBAR_BOTH
Свойство "gtk-xft-antialias"
"gtk-xft-antialias" gint : Чтение / ЗаписьДолжны ли сглаживаться Xft шрифты; 0=no, 1=yes, -1=default.
Допустимые значения: [-1,1]
Значение по умолчанию: -1
Свойство "gtk-xft-dpi"
"gtk-xft-dpi" gint : Чтение / ЗаписьРазрешение для Xft, в 1024 * dots/inch. -1 используется значение по умолчанию.
Допустимые значения: [-1,1048576]
Значение по умолчанию: -1
Свойство "gtk-xft-hinting"
"gtk-xft-hinting" gint : Чтение / ЗаписьИспользование во всплывающих подсказках Xft шрифтов; 0=no, 1=yes, -1=default.
Допустимые значения: [-1,1]
Значение по умолчанию: -1
Свойство "gtk-xft-hintstyle"
"gtk-xft-hintstyle" gchararray : Чтение / ЗаписьКакую степень подсказки использовать; hintnone, hintslight, hintmedium, или hintfull.
Значение по умолчанию: NULL
Свойство "gtk-xft-rgba"
"gtk-xft-rgba" gchararray : Чтение / ЗаписьТип субпиксельного сглаживания; none, rgb, bgr, vrgb, vbgr.
Значение по умолчанию: NULL