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

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

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

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

свойства

описание

детали

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`"