Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

Параметры настройки

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 : Чтение / Запись

Описание

Детали

GtkSettings

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.


gtk_settings_get_for_screen ()

GtkSettings* gtk_settings_get_for_screen    (GdkScreen *screen);

Выдаёт объект GtkSettings для screen, создавая при необходимости.

screen :

GdkScreen.

Возвращает :

Объект GtkSettings.

Начиная с версии 2.2


gtk_settings_install_property ()

void        gtk_settings_install_property   (GParamSpec *pspec);

pspec :


gtk_settings_install_property_parser ()

void gtk_settings_install_property_parser (GParamSpec *pspec, GtkRcPropertyParser parser);

pspec :

parser :


gtk_rc_property_parse_color ()

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 :

GParamSpec

gstring :

Анализируемый GString

property_value :

GValue который должен содержать значение GdkColor.

Возвращает :

TRUE если gstring может анализироваться и property_value было установлено результирующим GdkColor.


gtk_rc_property_parse_enum ()

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 :

GParamSpec

gstring :

Анализируемый GString

property_value :

GValue который должен содержать значения перечисления.

Возвращает :

TRUE если gstring может анализироваться и property_value было установлено результирующим GEnumValue.


gtk_rc_property_parse_flags ()

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 :

GParamSpec

gstring :

Анализируемый GString

property_value :

GValue который должен содержать значения флагов.

Возвращает :

TRUE если gstring может анализироваться и property_value было установлено результирующим значением флагов.


gtk_rc_property_parse_requisition ()

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 :

GParamSpec

gstring :

Анализируемый GString

property_value :

GValue который должен содержать ограниченные значения.

Возвращает :

TRUE если gstring может анализироваться и property_value было установлено результирующим GtkRequisition.


gtk_rc_property_parse_border ()

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 :

GParamSpec

gstring :

Анализируемый GString

property_value :

GValue который должен содержать ограниченные значения.

Возвращает :

TRUE если gstring может анализироваться и property_value был установлен результирующим GtkBorder.


gtk_settings_set_property_value ()

void gtk_settings_set_property_value (GtkSettings *settings, const gchar *name, const GtkSettingsValue *svalue);

settings :

name :

svalue :


gtk_settings_set_string_property ()

void gtk_settings_set_string_property (GtkSettings *settings, const gchar *name, const gchar *v_string, const gchar *origin);

settings :

name :

v_string :

origin :


gtk_settings_set_long_property ()

void gtk_settings_set_long_property (GtkSettings *settings, const gchar *name, glong v_long, const gchar *origin);

settings :

name :

v_long :

origin :


gtk_settings_set_double_property ()

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"

  "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