Настройки
Настройки — Общие настройки между приложениями
Функции
Свойства
| gchar * | gtk-sound-theme-name | Чтение/Запись |
| gboolean | gtk-split-cursor | Чтение/Запись |
| gchar * | gtk-theme-name | Чтение/Запись |
| gint | gtk-timeout-expand | Чтение/Запись |
| gint | gtk-timeout-initial | Чтение/Запись |
| gint | gtk-timeout-repeat | Чтение/Запись |
| gchar * | gtk-titlebar-double-click | Чтение/Запись |
| gchar * | gtk-titlebar-middle-click | Чтение/Запись |
| gchar * | gtk-titlebar-right-click | Чтение/Запись |
| GtkIconSize | gtk-toolbar-icon-size | Чтение/Запись |
| GtkToolbarStyle | gtk-toolbar-style | Чтение/Запись |
| gint | gtk-tooltip-browse-mode-timeout | Чтение/Запись |
| gint | gtk-tooltip-browse-timeout | Чтение/Запись |
| gint | gtk-tooltip-timeout | Чтение/Запись |
| gboolean | gtk-touchscreen-mode | Чтение/Запись |
| GtkPolicyType | gtk-visible-focus | Чтение/Запись |
| gint | gtk-xft-antialias | Чтение/Запись |
| gint | gtk-xft-dpi | Чтение/Запись |
| gint | gtk-xft-hinting | Чтение/Запись |
| gchar * | gtk-xft-hintstyle | Чтение/Запись |
| gchar * | gtk-xft-rgba | Чтение/Запись |
Типы и значения
| GtkSettings | |
| структура | GtkSettingsValue |
| перечисление | GtkIMPreeditStyle |
| перечисление | GtkIMStatusStyle |
Иерархия объектов
GObject ╰── GtkSettings
Реализованные интерфейсы
GtkSettings реализует GtkStyleProvider и GtkStyleProviderPrivate.
Файлы включения
#include <gtk/gtk.h>
Описание
GtkSettings предоставляют механизм для совместного использования глобальных настроек между приложениями.
В системе X Window это совместное использование реализуется менеджером XSettings, обычно являющимся частью среды рабочего стола, наряду с утилитами, позволяющими пользователю изменять эти настройки. При отсутствии менеджера XSettings GTK+ считывает значения по умолчанию для настроек из файлов settings.ini в /etc/gtk-3.0, $XDG_CONFIG_DIRS/gtk-3.0 и $XDG_CONFIG_HOME/gtk-3.0. Эти файлы должны быть валидными файлами ключей (см. GKeyFile), и содержать раздел под названием Settings. Тематика также может предоставлять значения по умолчанию для настроек, установив файл settings.ini рядом со своим файлом gtk.css.
Приложения могут переопределять настройки системы, устанавливая свойство объекта GtkSettings с помощью g_object_set(). Однако это следует применять в особых случаях; GtkSettings не предназначены для конфигурации приложений. При этом необходимо учитывать, что настройки, специфичные для отдельных виджетов, могут быть недоступны до того, как тип виджета будет реализован хотя бы один раз. Следующий пример демонстрирует способ сделать это:
Для каждого экрана существует один экземпляр GtkSettings. Его можно получить с помощью gtk_settings_get_for_screen(), но во многих случаях удобнее использовать gtk_widget_get_settings(). gtk_settings_get_default() возвращает экземпляр GtkSettings для основного экрана.
Функции
gtk_settings_get_default ()
GtkSettings *
gtk_settings_get_default (void); Получает объект GtkSettings для стандартного экрана GDK, создавая его при необходимости. См. gtk_settings_get_for_screen().
Возвращает
объект GtkSettings. Если стандартного экрана нет, возвращает NULL.
[nullable][transfer none]
gtk_settings_get_for_screen ()
GtkSettings *
gtk_settings_get_for_screen (GdkScreen *screen); Получает объект GtkSettings для screen, создавая его при необходимости.
Параметры
screen | объект GdkScreen. |
С: 2.2
gtk_settings_install_property ()
void
gtk_settings_install_property (GParamSpec *pspec); gtk_settings_install_property устарела с версии 3.16 и не должна использоваться в новом коде.
Эта функция не полезна вне GTK+.
gtk_settings_install_property_parser ()
void gtk_settings_install_property_parser (GParamSpec *pspec,GtkRcPropertyParser parser);
gtk_settings_install_property_parser устарела с версии 3.16 и не должна использоваться в новом коде.
Эта функция не полезна вне GTK+.
Параметры
parser | . | [scope call] |
gtk_rc_property_parse_color ()
gboolean gtk_rc_property_parse_color (const GParamSpec *pspec,const GString *gstring,GValue *property_value);
A GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser(), которая анализирует цвет, заданный либо его именем, либо в формате { red, green, blue }, где красный, зелёный и синий — целые числа от 0 до 65535 или числа с плавающей точкой от 0 до 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);
A GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser(), которая анализирует единственное значение перечисления.
Значение перечисления может быть указано по его имени, псевдониму или численному значению. Для согласованности с анализом флагов, значение может быть окружено скобками.
Параметры
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);
A GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser(), которая анализирует флаги.
Флаги могут быть указаны по их имени, псевдониму или численному значению. Несколько флагов могут быть указаны в формате "( 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);
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.
Параметры
Возвращаемое значение
TRUE if gstring could be parsed and property_value has been set to the resulting GtkRequisition.
gtk_rc_property_parse_border ()
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.
gtk_settings_set_property_value ()
void gtk_settings_set_property_value (GtkSettings *settings,const gchar *name,const GtkSettingsValue *svalue);
gtk_settings_set_property_value устарел с версии 3.16 и не должен использоваться в новых кодах.
Используйте g_object_set() вместо этого.
gtk_settings_set_string_property ()
void gtk_settings_set_string_property (GtkSettings *settings,const gchar *name,const gchar *v_string,const gchar *origin);
gtk_settings_set_string_property устарел с версии 3.16 и не должен использоваться в новых кодах.
Используйте g_object_set() вместо этого.
gtk_settings_set_long_property ()
void gtk_settings_set_long_property (GtkSettings *settings,const gchar *name,glong v_long,const gchar *origin);
gtk_settings_set_long_property устарел с версии 3.16 и не должен использоваться в новых кодах.
Используйте g_object_set() вместо этого.
gtk_settings_set_double_property ()
void gtk_settings_set_double_property (GtkSettings *settings,const gchar *name,gdouble v_double,const gchar *origin);
gtk_settings_set_double_property устарел с версии 3.16 и не должен использоваться в новых кодах.
Используйте g_object_set() вместо этого.
gtk_settings_reset_property ()
void gtk_settings_reset_property (GtkSettings *settings,const gchar *name);
Отменяет действие вызова g_object_set() для установки значения, специфичного для приложения, для параметра. После этого вызова параметр снова будет следовать сеансовому значению для этого параметра.
Параметры
settings | a GtkSettings object | |
name | the name of the setting to reset |
Since: 3.20
Типы и Значения
GtkSettings
typedef struct _GtkSettings GtkSettings;
struct GtkSettingsValue
struct GtkSettingsValue {
/* 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;
};
перечисление GtkIMPreeditStyle
GtkIMPreeditStyle устарел с версии 3.10 и не должен использоваться в новых кодах.
Стиль предварительного редактирования метода ввода. См. также “gtk-im-preedit-style”
Члены
GTK_IM_PREEDIT_NOTHING | Устарел | |
GTK_IM_PREEDIT_CALLBACK | Устарел | |
GTK_IM_PREEDIT_NONE | Устарел |
перечисление GtkIMStatusStyle
GtkIMStatusStyle устарел с версии 3.10 и не должен использоваться в новых кодах.
Стиль состояния метода ввода. См. также “gtk-im-status-style”
Члены
GTK_IM_STATUS_NOTHING | Устарел | |
GTK_IM_STATUS_CALLBACK | Устарел | |
GTK_IM_STATUS_NONE | Устарел |
Подробное описание свойств
Свойство “color-hash”
“color-hash” GHashTable *
Хеш-таблица, представляющая цветовую схему.
Флаги: Чтение
Свойство “gtk-alternative-button-order”
“gtk-alternative-button-order” gboolean
Следует ли использовать альтернативный порядок кнопок в диалоговых окнах.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-alternative-sort-arrows”
“gtk-alternative-sort-arrows” gboolean
Управляет направлением индикаторов сортировки в отсортированных списках и представлениях дерева. По умолчанию стрелка, указывающая вниз, означает, что столбец отсортирован в порядке возрастания. При установке в TRUE, этот порядок будет инвертирован.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 2.12
Свойство “gtk-application-prefer-dark-theme”
“gtk-application-prefer-dark-theme” gboolean
Предпочитает ли приложение использовать темную тему. Если тема GTK+ включает темный вариант, он будет использоваться вместо настроенной темы.
Некоторые приложения выигрывают от минимизации количества светового загрязнения, которое мешает содержанию. Хорошими кандидатами для темных тем являются редакторы фотографий и видео, которые позволяют фактическому контенту привлекать все внимание и минимизировать отвлекающие факторы хрома.
Темные темы не следует использовать для документов, где большие пространства белые/светлые, а темный хром создает слишком большой контраст (веб-браузер, текстовый редактор...).
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.0
Свойство “gtk-auto-mnemonics”
“gtk-auto-mnemonics” gboolean
Следует ли автоматически показывать и скрывать мнемоники, когда пользователь нажимает активатор мнемоники.
GtkSettings:gtk-auto-mnemonics устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.20
Свойство “gtk-button-images”
“gtk-button-images” gboolean
Следует ли показывать изображения на кнопках
GtkSettings:gtk-button-images устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка устарела. Разработчики приложений контролируют, следует ли отображать значок на кнопке или нет, для каждой кнопки отдельно. Если GtkButton должен отображать значок, используйте свойство “always-show-image” GtkButton, и упакуйте GtkImage внутри GtkButton
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 2.4
Свойство “gtk-can-change-accels”
“gtk-can-change-accels” gboolean
Можно ли изменять ускорители меню, нажимая клавишу над элементом меню.
GtkSettings:gtk-can-change-accels устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-color-palette”
“gtk-color-palette” gchar *
Палитра, используемая в устаревшем селекторе цветов.
GtkSettings:gtk-color-palette устарело с версии 3.10 и не должно использоваться в новом коде.
Используется только устаревшим виджетом селектора цветов.
Флаги: Чтение / Запись
Значение по умолчанию: "black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90"
Свойство “gtk-color-scheme”
“gtk-color-scheme” gchar *
Палитра именованных цветов для использования в темах. Формат строки:
Имена цветов должны быть допустимы в качестве идентификаторов в синтаксисе gtkrc, а спецификации цветов должны быть в формате, принятом gdk_color_parse().
Обратите внимание, что из-за способа объединения таблиц цветов из разных источников спецификации цветов будут преобразованы в шестнадцатеричный формат при получении этого свойства.
Начиная с GTK+ 2.12, записи можно альтернативно разделять символом ';' вместо новых строк:
gtk_init (&argc, &argv); // make sure the type is realized g_type_class_unref (g_type_class_ref (GTK_TYPE_IMAGE_MENU_ITEM)); g_object_set (gtk_settings_get_default (), "gtk-enable-animations", FALSE, NULL);
GtkSettings:gtk-color-scheme устарело с версии 3.8 и не должно использоваться в новом коде.
Поддержка цветовой схемы была отменена и больше не поддерживается. Вы все еще можете установить это свойство, но оно будет игнорироваться.
Флаги: Чтение / Запись
Значение по умолчанию: ""
С версии: 2.10
Свойство “gtk-cursor-blink”
“gtk-cursor-blink” gboolean
Следует ли мигать курсору.
См. также настройку “gtk-cursor-blink-timeout”, которая позволяет более гибко управлять миганием курсора.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “gtk-cursor-blink-time”
“gtk-cursor-blink-time” gint
Длительность цикла мигания курсора в миллисекундах.
Флаги: Чтение / Запись
Допустимые значения: >= 100
Значение по умолчанию: 1200
Свойство “gtk-cursor-blink-timeout”
“gtk-cursor-blink-timeout” gint
Время, после которого курсор перестает мигать, в секундах. Таймер сбрасывается после каждого взаимодействия пользователя.
Установка этого значения в ноль имеет тот же эффект, что и установка “gtk-cursor-blink” в FALSE.
Флаги: Чтение / Запись
Допустимые значения: >= 1
Значение по умолчанию: 10
С версии: 2.12
Свойство “gtk-cursor-theme-name”
“gtk-cursor-theme-name” gchar *
Имя используемой темы курсора или NULL для использования темы по умолчанию.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-cursor-theme-size”
“gtk-cursor-theme-size” gint
Размер для курсоров или 0 для использования размера по умолчанию.
Флаги: Чтение / Запись
Допустимые значения: [0,128]
Значение по умолчанию: 0
Свойство “gtk-decoration-layout”
“gtk-decoration-layout” gchar *
Эта настройка определяет, какие кнопки следует помещать в строку заголовка окон с украшением на стороне клиента, и следует ли размещать их слева или справа.
Формат строки — имена кнопок, разделенные запятыми. Двоеточие разделяет кнопки, которые должны отображаться слева, от тех, которые находятся справа. Распознаваемые имена кнопок: minimize, maximize, close, icon (значок окна) и menu (кнопка меню для резервного меню приложения).
Например, "menu:minimize,maximize,close" указывает меню слева и кнопки сворачивания, развертывания и закрытия справа.
Обратите внимание, что кнопки будут отображаться только тогда, когда они имеют смысл. Например, кнопка меню появляется только тогда, когда оболочка рабочего стола не отображает меню приложения, а кнопка закрытия появляется только в окне, которое можно закрыть.
Обратите также внимание, что настройку можно переопределить с помощью свойства “decoration-layout”.
Флаги: Чтение / Запись
Значение по умолчанию: "menu:minimize,maximize,close"
С версии: 3.12
Свойство “gtk-dialogs-use-header”
“gtk-dialogs-use-header” gboolean
Будут ли встроенные диалоговые окна GTK+, такие как средство выбора файлов, средство выбора цветов или средство выбора шрифтов, использовать строку заголовка вверху для отображения виджетов действий или область действий внизу.
Эта настройка не влияет на пользовательские диалоговые окна, использующие GtkDialog напрямую, или диалоговые окна сообщений.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.12
Свойство “gtk-dnd-drag-threshold”
“gtk-dnd-drag-threshold” gint
Количество пикселей, на которое курсор может перемещаться перед перетаскиванием.
Флаги: Чтение / Запись
Допустимые значения: >= 1
Значение по умолчанию: 8
Свойство “gtk-double-click-distance”
“gtk-double-click-distance” gint
Максимальное расстояние (в пикселях), допустимое между двумя щелчками, чтобы они считались двойным щелчком.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 5
Свойство “gtk-double-click-time”
“gtk-double-click-time” gint
Максимальное время (в миллисекундах), допустимое между двумя щелчками, чтобы они считались двойным щелчком.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 400
Свойство “gtk-enable-accels”
“gtk-enable-accels” gboolean
Должны ли элементы меню иметь видимые ускорители, которые можно активировать.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.12
Свойство “gtk-enable-animations”
“gtk-enable-animations” gboolean
Следует ли включать анимацию по всему набору инструментов.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “gtk-enable-event-sounds”
“gtk-enable-event-sounds” gboolean
Включает или отключает воспроизведение звуков событий.
См. Спецификацию тем звуков для получения дополнительной информации о звуках событий и темах звуков.
Сам GTK+ не поддерживает звуки событий; необходимо использовать модуль, загружаемый по мере необходимости, такой как модуль из libcanberra.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.14
Свойство “gtk-enable-input-feedback-sounds”
“gtk-enable-input-feedback-sounds” gboolean
Включает или отключает воспроизведение звуков событий в качестве обратной связи на ввод пользователя.
См. Спецификацию тем звуков для получения дополнительной информации о звуках событий и темах звуков.
Сам GTK+ не поддерживает звуки событий; необходимо использовать модуль, загружаемый по мере необходимости, такой как модуль из libcanberra.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.14
Свойство “gtk-enable-mnemonics”
“gtk-enable-mnemonics” gboolean
Определяет, должны ли метки и пункты меню иметь видимые мнемоники, которые можно активировать.
GtkSettings:gtk-enable-mnemonics устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение всё ещё может использоваться для переопределения приложения, но в будущем будет игнорироваться.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.12
Свойство “gtk-enable-primary-paste”
“gtk-enable-primary-paste” gboolean
Определяет, должен ли средний клик мыши вставлять содержимое буфера обмена «PRIMARY» в место курсора.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 3.4
Свойство “gtk-enable-tooltips”
“gtk-enable-tooltips” gboolean
Включает или отключает отображение всплывающих подсказок на виджетах.
GtkSettings:gtk-enable-tooltips устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.14
Свойство “gtk-entry-password-hint-timeout”
“gtk-entry-password-hint-timeout” guint
Время отображения последнего введённого символа в скрытых полях ввода. Значение задаётся в миллисекундах. 0 — отключение отображения последнего символа. 600 — хорошее значение для включения отображения.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С версии: 2.10
Свойство “gtk-entry-select-on-focus”
“gtk-entry-select-on-focus” gboolean
Включает или отключает выделение содержимого поля ввода при получении им фокуса.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “gtk-error-bell”
“gtk-error-bell” gboolean
При значении TRUE нажатия клавиш и другие ошибки ввода приведут к звуковому сигналу. Так как звонок об ошибках реализован с помощью gdk_window_beep(), система окон может предложить способы конфигурирования звонка об ошибках, такие как мигание окна или аналогичные визуальные эффекты.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.12
Свойство “gtk-fallback-icon-theme”
“gtk-fallback-icon-theme” gchar *
Имя резервной темы значков.
GtkSettings:gtk-fallback-icon-theme устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-file-chooser-backend”
“gtk-file-chooser-backend” gchar *
Имя бэкенда GtkFileChooser, используемого по умолчанию.
GtkSettings:gtk-file-chooser-backend устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется. GtkFileChooser по умолчанию использует GIO.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-font-name”
“gtk-font-name” gchar *
Шрифт по умолчанию. GTK+ использует имя семейства и размер из этой строки.
Флаги: Чтение / Запись
Значение по умолчанию: "Sans 10"
Свойство “gtk-fontconfig-timestamp”
“gtk-fontconfig-timestamp” guint
Отметка времени текущей конфигурации fontconfig.
Флаги: Чтение / Запись
Значение по умолчанию: 0
Свойство “gtk-icon-sizes”
“gtk-icon-sizes” gchar *
Список размеров значков. Элементы списка разделяются двоеточиями, и каждый элемент имеет вид:
size-name = width , height
Например, "gtk-menu=16,16:gtk-button=20,20:gtk-dialog=48,48". Сам GTK+ использует следующие именованные размеры значков: gtk-menu, gtk-button, gtk-small-toolbar, gtk-large-toolbar, gtk-dnd, gtk-dialog. Приложения могут регистрировать собственные именованные размеры значков с помощью gtk_icon_size_register().
GtkSettings:gtk-icon-sizes устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-icon-theme-name”
“gtk-icon-theme-name” gchar *
Имя темы значков для использования.
Флаги: Чтение / Запись
Значение по умолчанию: "Adwaita"
Свойство “gtk-im-module”
“gtk-im-module” gchar *
Модуль IM (метода ввода), который следует использовать по умолчанию. Это метод ввода, который будет использоваться, если пользователь явно не выбрал другой метод ввода из контекстного меню IM. Также это может быть список методов ввода, разделённых двоеточиями, которые GTK+ будет пытаться использовать по очереди, пока не найдёт доступный в системе.
См. GtkIMContext.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-im-preedit-style”
“gtk-im-preedit-style” GtkIMPreeditStyle
Способ отображения строки предварительного редактирования метода ввода.
GtkSettings:gtk-im-preedit-style устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: GTK_IM_PREEDIT_CALLBACK
Свойство “gtk-im-status-style”
“gtk-im-status-style” GtkIMStatusStyle
Способ отображения строки состояния метода ввода.
GtkSettings:gtk-im-status-style устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: GTK_IM_STATUS_CALLBACK
Свойство “gtk-key-theme-name”
“gtk-key-theme-name” gchar *
Имя темы клавиш для загрузки.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-keynav-cursor-only”
“gtk-keynav-cursor-only” gboolean
При значении TRUE навигация клавиатурой должна быть доступна для всех виджетов только с помощью клавиш курсора. Клавиши Tab, Shift и т. д. не предполагаются на используемом устройстве ввода.
GtkSettings:gtk-keynav-cursor-only устарело с версии 3.10 и его не следует использовать в новом коде.
Обычно поведение для ввода с сенсорного экрана должно выполняться динамически на основе gdk_event_get_source_device().
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 2.12
Свойство “gtk-keynav-use-caret”
“gtk-keynav-use-caret” gboolean
Включает или отключает проверку GTK+, чтобы обеспечить навигацию по тексту с помощью курсора, даже если текст не редактируется. Это полезно при использовании программы чтения с экрана.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.20
Свойство “gtk-keynav-wrap-around”
“gtk-keynav-wrap-around” gboolean
При значении TRUE некоторые виджеты будут «переворачиваться» при навигации клавиатурой, такие как меню, строка меню и записные книжки.
GtkSettings:gtk-keynav-wrap-around устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 2.12
Свойство “gtk-label-select-on-focus”
“gtk-label-select-on-focus” gboolean
Включает или отключает выделение содержимого метки, доступной для выбора, при получении ею фокуса.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “gtk-long-press-time”
“gtk-long-press-time” guint
Время, в течение которого нажатие кнопки или сенсорного экрана считается «длительным нажатием».
Флаги: Чтение / Запись
Допустимые значения: <= G_MAXINT
Значение по умолчанию: 500
С версии: 3.14
Свойство “gtk-menu-bar-accel”
“gtk-menu-bar-accel” gchar *
Сочетание клавиш для активации строки меню.
GtkSettings:gtk-menu-bar-accel устарело с версии 3.10 и его не следует использовать в новом коде.
Это значение всё ещё может использоваться для переопределения приложения, но в будущем будет игнорироваться.
Флаги: Чтение / Запись
Значение по умолчанию: "F10"
Свойство “gtk-menu-bar-popup-delay”
“gtk-menu-bar-popup-delay” gint
Задержка перед отображением подменю панели меню.
GtkSettings:gtk-menu-bar-popup-delay устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 0
Свойство “gtk-menu-images”
“gtk-menu-images” gboolean
Показывать ли изображения в пунктах меню
GtkSettings:gtk-menu-images устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение устарело. Разработчики приложений контролируют, будет ли у GtkMenuItem значок или нет, на основе каждого виджета. Используйте GtkMenuItem с GtkBox, содержащим GtkImage и GtkAccelLabel, или описывайте меню с помощью XML-описания GMenu.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-menu-popdown-delay”
“gtk-menu-popdown-delay” gint
Время, в течение которого подменю скрывается, когда указатель перемещается к нему.
GtkSettings:gtk-menu-popdown-delay устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 1000
Свойство “gtk-menu-popup-delay”
“gtk-menu-popup-delay” gint
Минимальное время нахождения указателя над пунктом меню перед отображением подменю.
GtkSettings:gtk-menu-popup-delay устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 225
Свойство “gtk-modules”
“gtk-modules” gchar *
Список активных модулей GTK.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-primary-button-warps-slider”
“gtk-primary-button-warps-slider” gboolean
Перемещать ли полосу прокрутки GtkRange к позиции клика или на одну страницу в соответствующем направлении.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 3.6
Свойство “gtk-print-backends”
“gtk-print-backends” gchar *
Список печатающих бэкэндов, используемых в диалоге печати, разделённых запятыми. Доступные бэкэнды зависят от установки GTK+, и могут включать "file", "cups", "lpr" или "papi".
Флаги: Чтение / Запись
Значение по умолчанию: "file,lpr,cloudprint"
С версии: 2.10
Свойство “gtk-print-preview-command”
“gtk-print-preview-command” gchar *
Команда для отображения предварительного просмотра печати. Команда должна содержать заполнитель %f, который будет заменён путём к файлу pdf. Команда также может содержать заполнитель %s, который будет заменён путём к файлу, содержащему настройки печати в формате, созданном функцией gtk_print_settings_to_file().
Приложение предварительного просмотра должно удалить файл pdf и файл настроек печати по завершении.
Флаги: Чтение / Запись
Значение по умолчанию: "evince --unlink-tempfile --preview --print-settings %s %f"
С версии: 2.10
Свойство “gtk-recent-files-enabled”
“gtk-recent-files-enabled” gboolean
Следует ли GTK+ отслеживать элементы в списке недавно использованных ресурсов. Если установлено FALSE, список всегда будет пустым.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 3.8
Свойство “gtk-recent-files-limit”
“gtk-recent-files-limit” gint
Количество недавно использованных файлов, которое должно отображаться по умолчанию реализациями GtkRecentChooser и GtkFileChooser. Значение -1 означает, что сохраняется каждый недавно использованный файл.
GtkSettings:gtk-recent-files-limit устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется
Флаги: Чтение / Запись
Допустимые значения: >= -1
Значение по умолчанию: 50
С версии: 2.12
Свойство “gtk-recent-files-max-age”
“gtk-recent-files-max-age” gint
Максимальный срок хранения элементов в списке недавно использованных ресурсов в днях. Элементы, старше этого значения, будут удалены из списка. Если установлено 0, список всегда будет пустым; если -1, элементы не будут удаляться.
Флаги: Чтение / Запись
Допустимые значения: >= -1
Значение по умолчанию: 30
С версии: 2.14
Свойство “gtk-scrolled-window-placement”
“gtk-scrolled-window-placement” GtkCornerType
Положение содержимого окон прокрутки относительно полос прокрутки, если оно не переопределено собственными параметрами окна прокрутки.
GtkSettings:gtk-scrolled-window-placement устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: GTK_CORNER_TOP_LEFT
С версии: 2.10
Свойство “gtk-shell-shows-app-menu”
“gtk-shell-shows-app-menu” gboolean
Устанавливается в TRUE, если среда рабочего стола отображает меню приложения, и в FALSE, если приложение должно отображать его само.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-shell-shows-desktop”
“gtk-shell-shows-desktop” gboolean
Устанавливается в TRUE, если среда рабочего стола отображает папку рабочего стола, и в FALSE — в противном случае.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “gtk-shell-shows-menubar”
“gtk-shell-shows-menubar” gboolean
Устанавливается в TRUE, если среда рабочего стола отображает строку меню, и в FALSE — если приложение должно отображать её само.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-show-input-method-menu”
“gtk-show-input-method-menu” gboolean
Предлагать ли в контекстных меню элементов и текстовых представлений изменение метода ввода.
GtkSettings:gtk-show-input-method-menu устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-show-unicode-menu”
“gtk-show-unicode-menu” gboolean
Предлагать ли в контекстных меню элементов и текстовых представлений вставку управляющих символов.
GtkSettings:gtk-show-unicode-menu устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “gtk-sound-theme-name”
“gtk-sound-theme-name” gchar *
Тема звуков XDG, используемая для звуков событий.
См. Спецификацию темы звуков для получения дополнительной информации о звуках событий и темах звуков.
Сам GTK+ не поддерживает звуки событий, вам необходимо использовать загружаемый модуль, такой как тот, что поставляется с libcanberra.
Флаги: Чтение / Запись
Значение по умолчанию: "freedesktop"
С версии: 2.14
Свойство “gtk-split-cursor”
“gtk-split-cursor” gboolean
Отображать ли два курсора для смешанного текста слева направо и справа налево.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “gtk-theme-name”
“gtk-theme-name” gchar *
Имя темы для загрузки.
Флаги: Чтение / Запись
Значение по умолчанию: "Adwaita"
Свойство “gtk-timeout-expand”
“gtk-timeout-expand” gint
Значение расширения для таймаутов, когда виджет расширяет новую область.
GtkSettings:gtk-timeout-expand устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 500
Свойство “gtk-timeout-initial”
“gtk-timeout-initial” gint
Начальное значение для таймаутов, когда нажата кнопка.
GtkSettings:gtk-timeout-initial устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 500
Свойство “gtk-timeout-repeat”
“gtk-timeout-repeat” gint
Значение повтора для таймаутов, когда нажата кнопка.
GtkSettings:gtk-timeout-repeat устарело начиная с версии 3.10 и не должно использоваться в новом коде.
Это значение игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 50
Свойство “gtk-titlebar-double-click”
“gtk-titlebar-double-click” gchar *
Это настройка определяет действие, выполняемое при двойном щелчке по заголовку окна с клиентской отрисовкой.
Распознанные действия: сворачивание, переключение максимизации, меню, опускание или ничего.
Флаги: Чтение / Запись
Значение по умолчанию: «переключение максимизации»
С версии: 3.14
Свойство “gtk-titlebar-middle-click”
“gtk-titlebar-middle-click” gchar *
Эта настройка определяет действие при среднем щелчке по заголовку окна с клиентской отрисовкой.
Распознанные действия: сворачивание, переключение максимизации, меню, опускание или ничего.
Флаги: Чтение / Запись
Значение по умолчанию: «ничего»
С версии: 3.14
Свойство “gtk-titlebar-right-click”
“gtk-titlebar-right-click” gchar *
Эта настройка определяет действие при щелчке правой кнопкой мыши по заголовку окна с клиентской отрисовкой.
Распознанные действия: сворачивание, переключение максимизации, меню, опускание или ничего.
Флаги: Чтение / Запись
Значение по умолчанию: «меню»
С версии: 3.14
Свойство “gtk-toolbar-icon-size”
“gtk-toolbar-icon-size” GtkIconSize
Размер значков в стандартных панелях инструментов.
GtkSettings:gtk-toolbar-icon-size устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: GTK_ICON_SIZE_LARGE_TOOLBAR
Свойство “gtk-toolbar-style”
“gtk-toolbar-style” GtkToolbarStyle
Размер значков в стандартных панелях инструментов.
GtkSettings:gtk-toolbar-style устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется.
Флаги: Чтение / Запись
Значение по умолчанию: GTK_TOOLBAR_BOTH_HORIZ
Свойство “gtk-tooltip-browse-mode-timeout”
“gtk-tooltip-browse-mode-timeout” gint
Время в миллисекундах, после которого режим просмотра будет отключен.
См. «gtk-tooltip-browse-timeout» для получения дополнительной информации о режиме просмотра.
GtkSettings:gtk-tooltip-browse-mode-timeout устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 500
С версии: 2.12
Свойство “gtk-tooltip-browse-timeout”
“gtk-tooltip-browse-timeout” gint
Управляет временем появления всплывающих подсказок после активации режима просмотра в миллисекундах.
Режим просмотра активируется, когда указатель мыши перемещается с объекта, над которым отображалась всплывающая подсказка. Если указатель мыши попадает на другой объект до истечения времени ожидания режима просмотра (см. «gtk-tooltip-browse-mode-timeout»), всплывающая подсказка для нового объекта появится через указанное количество миллисекунд.
GtkSettings:gtk-tooltip-browse-timeout устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 60
С версии: 2.12
Свойство “gtk-tooltip-timeout”
“gtk-tooltip-timeout” gint
Время в миллисекундах, после которого всплывающая подсказка может появиться, если курсор находится над виджетом.
GtkSettings:gtk-tooltip-timeout устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 500
С версии: 2.12
Свойство “gtk-touchscreen-mode”
“gtk-touchscreen-mode” gboolean
Если TRUE, события движения на этом экране не передаются, и виджеты не могут использовать наведение указателя для каких-либо функциональных действий.
GtkSettings:gtk-touchscreen-mode устарело с версии 3.4. и не должно использоваться в новом коде.
В целом, поведение для ввода с сенсорного экрана должно выполняться динамически на основе gdk_event_get_source_device().
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 2.10
Свойство “gtk-visible-focus”
“gtk-visible-focus” GtkPolicyType
Определяет, должны ли «прямоугольники фокуса» быть всегда видимыми, никогда не видимыми или скрытыми до тех пор, пока пользователь не начнет использовать клавиатуру.
GtkSettings:gtk-visible-focus устарело с версии 3.10 и не должно использоваться в новом коде.
Эта настройка игнорируется
Флаги: Чтение / Запись
Значение по умолчанию: GTK_POLICY_AUTOMATIC
С версии: 3.2
Свойство “gtk-xft-antialias”
“gtk-xft-antialias” gint
Включить ли сглаживание шрифтов Xft; 0=нет, 1=да, -1=по умолчанию.
Флаги: Чтение / Запись
Допустимые значения: [-1,1]
Значение по умолчанию: -1
Свойство “gtk-xft-dpi”
“gtk-xft-dpi” gint
Разрешение для Xft, в 1024 * точках на дюйм. -1 для использования значения по умолчанию.
Флаги: Чтение / Запись
Допустимые значения: [-1,1048576]
Значение по умолчанию: -1
Свойство “gtk-xft-hinting”
“gtk-xft-hinting” gint
Включить ли подстановку шрифтов Xft; 0=нет, 1=да, -1=по умолчанию.
Флаги: Чтение / Запись
Допустимые значения: [-1,1]
Значение по умолчанию: -1
Свойство “gtk-xft-hintstyle”
“gtk-xft-hintstyle” gchar *
Степень подстановки; hintnone, hintslight, hintmedium или hintfull.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “gtk-xft-rgba”
“gtk-xft-rgba” gchar *
Тип субпиксельного сглаживания; none, rgb, bgr, vrgb, vbgr.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkSettings.html