Settings

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

			GTK+ Reference Manual
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

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2025 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

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

Краткое описание

Иерархия объектов

Свойства

Описание

Детали

GtkSettings

GtkSettingsValue

gtk_settings_get_default ()

gtk_settings_get_for_screen ()

gtk_settings_install_property ()

gtk_settings_install_property_parser ()

gtk_rc_property_parse_color ()

gtk_rc_property_parse_enum ()

gtk_rc_property_parse_flags ()

gtk_rc_property_parse_requisition ()

gtk_rc_property_parse_border ()

gtk_settings_set_property_value ()

gtk_settings_set_string_property ()

gtk_settings_set_long_property ()

gtk_settings_set_double_property ()

Детали свойств

Свойство "gtk-alternative-button-order"

Свойство "gtk-button-images"

Свойство "gtk-can-change-accels"

Свойство "gtk-color-palette"

Свойство "gtk-cursor-blink"

Свойство "gtk-cursor-blink-time"

Свойство "gtk-cursor-theme-name"

Свойство "gtk-cursor-theme-size"

Свойство "gtk-dnd-drag-threshold"

Свойство "gtk-double-click-distance"

Свойство "gtk-double-click-time"

Свойство "gtk-entry-select-on-focus"

Свойство "gtk-fallback-icon-theme"

Свойство "gtk-font-name"

Свойство "gtk-icon-sizes"

Свойство "gtk-icon-theme-name"

Свойство "gtk-key-theme-name"

Свойство "gtk-menu-bar-accel"

Свойство "gtk-menu-bar-popup-delay"

Свойство "gtk-menu-images"

Свойство "gtk-menu-popdown-delay"

Свойство "gtk-menu-popup-delay"

Свойство "gtk-modules"

Свойство "gtk-split-cursor"

Свойство "gtk-theme-name"

Свойство "gtk-toolbar-icon-size"

Свойство "gtk-toolbar-style"

Свойство "gtk-xft-antialias"

Свойство "gtk-xft-dpi"

Свойство "gtk-xft-hinting"

Свойство "gtk-xft-hintstyle"

Свойство "gtk-xft-rgba"

Свойство "`gtk-alternative-button-order`"

Свойство "`gtk-button-images`"

Свойство "`gtk-can-change-accels`"

Свойство "`gtk-color-palette`"

Свойство "`gtk-cursor-blink`"

Свойство "`gtk-cursor-blink-time`"

Свойство "`gtk-cursor-theme-name`"

Свойство "`gtk-cursor-theme-size`"

Свойство "`gtk-dnd-drag-threshold`"

Свойство "`gtk-double-click-distance`"

Свойство "`gtk-double-click-time`"

Свойство "`gtk-entry-select-on-focus`"

Свойство "`gtk-fallback-icon-theme`"

Свойство "`gtk-font-name`"

Свойство "`gtk-icon-sizes`"

Свойство "`gtk-icon-theme-name`"

Свойство "`gtk-key-theme-name`"

Свойство "`gtk-menu-bar-accel`"

Свойство "`gtk-menu-bar-popup-delay`"

Свойство "`gtk-menu-images`"

Свойство "`gtk-menu-popdown-delay`"

Свойство "`gtk-menu-popup-delay`"

Свойство "`gtk-modules`"

Свойство "`gtk-split-cursor`"

Свойство "`gtk-theme-name`"

Свойство "`gtk-toolbar-icon-size`"

Свойство "`gtk-toolbar-style`"

Свойство "`gtk-xft-antialias`"

Свойство "`gtk-xft-dpi`"

Свойство "`gtk-xft-hinting`"

Свойство "`gtk-xft-hintstyle`"

Свойство "`gtk-xft-rgba`"