Spec-Zone.ru › GTK 3.20

Настройки

Настройки — Общие настройки между приложениями

Функции

GtkSettings * gtk_settings_get_default ()
GtkSettings * gtk_settings_get_for_screen ()
void gtk_settings_install_property ()
void gtk_settings_install_property_parser ()
gboolean gtk_rc_property_parse_color ()
gboolean gtk_rc_property_parse_enum ()
gboolean gtk_rc_property_parse_flags ()
gboolean gtk_rc_property_parse_requisition ()
gboolean gtk_rc_property_parse_border ()
void gtk_settings_set_property_value ()
void gtk_settings_set_string_property ()
void gtk_settings_set_long_property ()
void gtk_settings_set_double_property ()
void gtk_settings_reset_property ()

Свойства

GHashTable * color-hash Чтение
gboolean gtk-alternative-button-order Чтение / Запись
gboolean gtk-alternative-sort-arrows Чтение / Запись
gboolean gtk-application-prefer-dark-theme Чтение / Запись
gboolean gtk-auto-mnemonics Чтение / Запись
gboolean gtk-button-images Чтение / Запись
gboolean gtk-can-change-accels Чтение / Запись
gchar * gtk-color-palette Чтение / Запись
gchar * gtk-color-scheme Чтение / Запись
gboolean gtk-cursor-blink Чтение / Запись
gint gtk-cursor-blink-time Чтение / Запись
gint gtk-cursor-blink-timeout Чтение / Запись
gchar * gtk-cursor-theme-name Чтение / Запись
gint gtk-cursor-theme-size Чтение / Запись
gchar * gtk-decoration-layout Чтение / Запись
gboolean gtk-dialogs-use-header Чтение / Запись
gint gtk-dnd-drag-threshold Чтение / Запись
gint gtk-double-click-distance Чтение / Запись
gint gtk-double-click-time Чтение / Запись
gboolean gtk-enable-accels Чтение / Запись
gboolean gtk-enable-animations Чтение / Запись
gboolean gtk-enable-event-sounds Чтение / Запись
gboolean gtk-enable-input-feedback-sounds Чтение / Запись
gboolean gtk-enable-mnemonics Чтение / Запись
gboolean gtk-enable-primary-paste Чтение / Запись
gboolean gtk-enable-tooltips Чтение / Запись
guint gtk-entry-password-hint-timeout Чтение / Запись
gboolean gtk-entry-select-on-focus Чтение / Запись
gboolean gtk-error-bell Чтение / Запись
gchar * gtk-fallback-icon-theme Чтение / Запись
gchar * gtk-file-chooser-backend Чтение / Запись
gchar * gtk-font-name Чтение / Запись
guint gtk-fontconfig-timestamp Чтение / Запись
gchar * gtk-icon-sizes Чтение / Запись
gchar * gtk-icon-theme-name Чтение / Запись
gchar * gtk-im-module Чтение / Запись
GtkIMPreeditStyle gtk-im-preedit-style Чтение / Запись
GtkIMStatusStyle gtk-im-status-style Чтение / Запись
gchar * gtk-key-theme-name Чтение / Запись
gboolean gtk-keynav-cursor-only Чтение / Запись
gboolean gtk-keynav-use-caret Чтение / Запись
gboolean gtk-keynav-wrap-around Чтение / Запись
gboolean gtk-label-select-on-focus Чтение / Запись
guint gtk-long-press-time Чтение / Запись
gchar * gtk-menu-bar-accel Чтение / Запись
gint gtk-menu-bar-popup-delay Чтение / Запись
gboolean gtk-menu-images Чтение / Запись
gint gtk-menu-popdown-delay Чтение / Запись
gint gtk-menu-popup-delay Чтение / Запись
gchar * gtk-modules Чтение / Запись
gboolean gtk-primary-button-warps-slider Чтение / Запись
gchar * gtk-print-backends Чтение / Запись
gchar * gtk-print-preview-command Чтение / Запись
gboolean gtk-recent-files-enabled Чтение / Запись
gint gtk-recent-files-limit Чтение / Запись
gint gtk-recent-files-max-age Чтение / Запись
GtkCornerType gtk-scrolled-window-placement Чтение / Запись
gboolean gtk-shell-shows-app-menu Чтение / Запись
gboolean gtk-shell-shows-desktop Чтение / Запись
gboolean gtk-shell-shows-menubar Чтение / Запись
gboolean gtk-show-input-method-menu Чтение / Запись
gboolean gtk-show-unicode-menu Чтение / Запись
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
struct GtkSettingsValue
перечисление GtkIMPreeditStyle
перечисление GtkIMStatusStyle

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

    GObject
    ╰── GtkSettings

Реализованные интерфейсы

GtkSettings реализует GtkStyleProvider и GtkStyleProviderPrivate.

Включаемые файлы

#include <gtk/gtk.h>

Описание

GtkSettings обеспечивает механизм совместного использования глобальных настроек между приложениями.

В системе X Windows это совместное использование осуществляется менеджером 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

a GdkScreen.

Возвращает

объект GtkSettings.

[transfer none]

С: 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

a GParamSpec

gstring

the GString to be parsed

property_value

a 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

a GParamSpec

gstring

the GString to be parsed

property_value

a 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

a GParamSpec

gstring

the GString to be parsed

property_value

a 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 для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser(), который парсит запрос в форме "{ width, height }" для целых чисел width и height.

Параметры

pspec

a GParamSpec

gstring

the GString для разбора

property_value

a 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);

A GtkRcPropertyParser для использования с gtk_settings_install_property_parser() или gtk_widget_class_install_style_property_parser(), который парсит границы в формате "{ left, right, top, bottom }" для целых чисел слева, справа, сверху и снизу.

Параметры

pspec

a GParamSpec

gstring

the GString для разбора

property_value

a 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);

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 объект

name

имя настройки для сброса

С: 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;
};

Члены

gchar *origin;

Исходное значение должно быть чем-то вроде «имя_файла:номер_строки» для rc-файлов или, например, «XProperty» для других источников.

GValue value;

Допустимые типы — LONG, DOUBLE и STRING, соответствующие разобранному токену, или GSTRING, содержащий необработанную инструкцию.

перечисление 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,cups,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 *

Это настройка определяет действие, которое выполняется при двойном щелчке на заголовке окна с клиентской отделкой.

Поддерживаемые действия: minimize, toggle-maximize, menu, lower или none.

Флаги: Чтение / Запись

Значение по умолчанию: "toggle-maximize"

С: 3.14

Свойство “gtk-titlebar-middle-click”

  “gtk-titlebar-middle-click” gchar *

Эта настройка определяет действие при среднем щелчке по заголовку окна с клиентской отделкой.

Поддерживаемые действия: minimize, toggle-maximize, menu, lower или none.

Флаги: Чтение / Запись

Значение по умолчанию: "none"

С: 3.14

Свойство “gtk-titlebar-right-click”

  “gtk-titlebar-right-click” gchar *

Эта настройка определяет действие при правом щелчке по заголовку окна с клиентской отделкой.

Поддерживаемые действия: minimize, toggle-maximize, menu, lower или none.

Флаги: Чтение / Запись

Значение по умолчанию: "menu"

С: 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.20/GtkSettings.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API