Spec-Zone.ru › GTK 3.24

Справочник по GTK+ 3

Этот документ предназначен для библиотеки GTK+ 3, версия 3.24.24. Последние версии доступны онлайн по адресу https://developer.gnome.org/gtk3/. Если вы ищете более старые библиотеки GTK+ 2, см. https://developer.gnome.org/gtk2/.

I. Обзор GTK+
Начало работы с GTK+
Основы
Укладка элементов
Создание пользовательских интерфейсов
Создание приложений
Тривиальное приложение
Заполнение окна
Открытие файлов
Меню приложения
Диалог настроек
Добавление строки поиска
Добавление боковой панели
Свойства
Панель заголовка
Пользовательское рисование
Список рассылок и отчёты об ошибках — Получение помощи по GTK+
Частые вопросы — Найдите ответы на распространенные вопросы в руководстве GTK+
Модель рисования GTK+ — Детальное описание модели рисования GTK+
Модель обработки ввода и событий GTK+ — Детальное описание обработки ввода и событий в GTK+
II. Виджеты и объекты GTK+
Иерархия объектов
Галерея виджетов
Поддержка приложений
GtkApplication — Класс приложения
GtkApplicationWindow — Подкласс GtkWindow с поддержкой GtkApplication
GtkActionable — Интерфейс для виджетов, которые могут быть связаны с действиями
Построитель интерфейса
GtkBuilder — Построение интерфейса по определению пользовательского интерфейса в XML
GtkBuildable — Интерфейс для объектов, которые могут быть построены GtkBuilder
Окна
GtkWindow — Окно верхнего уровня, которое может содержать другие виджеты
GtkDialog — Создание всплывающих окон
GtkMessageDialog — Удобное окно сообщений
GtkAboutDialog — Отображение информации о приложении
GtkAssistant — Виджет для руководства пользователей по многоступенчатым операциям
GtkInvisible — Виджет, который не отображается
GtkOffscreenWindow — Окно верхнего уровня для управления рендерингом дочерних виджетов вне экрана
GtkWindowGroup — Ограничение эффекта захвата
Контейнеры макета
GtkBox — Контейнер для размещения виджетов в одной строке или столбце
GtkGrid — Размещение виджетов в строках и столбцах
GtkRevealer — Скрытие и отображение с анимацией
GtkListBox — Контейнер списка
GtkFlowBox — Контейнер, позволяющий перераспределять своих потомков
GtkStack — Контейнер для стекирования
GtkStackSwitcher — Контроллер для GtkStack
GtkStackSidebar — Автоматический виджет боковой панели
GtkActionBar — Панель полной ширины для представления контекстных действий
GtkHeaderBar — Блок с центральным дочерним элементом
GtkOverlay — Контейнер, который накладывает виджеты друг на друга
GtkButtonBox — Контейнер для размещения кнопок
GtkPaned — Виджет с двумя регулируемыми панелями
GtkLayout — Бесконечная область прокрутки, содержащая дочерние виджеты и/или пользовательское рисование
GtkNotebook — Контейнер закладок
GtkExpander — Контейнер, который может скрывать своего потомка
GtkOrientable — Интерфейс для виджетов, которые можно переворачивать
GtkAspectFrame — Рамка, которая ограничивает свой дочерний элемент определённым соотношением сторон
GtkFixed — Контейнер, который позволяет размещать виджеты в фиксированных координатах
Виджеты отображения
GtkLabel — Виджет, отображающий небольшое или среднее количество текста
GtkImage — Виджет для отображения изображения
GtkSpinner — Отображение анимации вращения
GtkInfoBar — Отправка важных сообщений пользователю
GtkProgressBar — Виджет, визуально отображающий прогресс
GtkLevelBar — Панель, которая может использоваться как индикатор уровня
GtkStatusbar — Отправка сообщений меньшей важности пользователю
GtkAccelLabel — Метка, отображающая сочетание клавиш справа от текста
Кнопки и переключатели
GtkButton — Виджет, который отправляет сигнал при нажатии
GtkCheckButton — Создание виджетов с дискретными переключателями
GtkRadioButton — Выбор из нескольких переключателей
GtkToggleButton — Создание кнопок, которые сохраняют своё состояние
GtkLinkButton — Создание кнопок, связанных с URL
GtkMenuButton — Виджет, который отображает всплывающее меню при нажатии
GtkSwitch — Переключатель типа «выключатель света»
GtkScaleButton — Кнопка, которая отображает шкалу
GtkVolumeButton — Кнопка, которая отображает регулятор громкости
GtkLockButton — Виджет для разблокировки или блокировки привилегированных операций
GtkModelButton — Кнопка, которая использует GAction в качестве модели
Числовые и текстовые поля ввода
GtkEntry — Однострочное поле ввода текста
GtkEntryBuffer — Буфер текста для GtkEntry
GtkEntryCompletion — Функциональность автодополнения для GtkEntry
GtkScale — Виджет ползунка для выбора значения из диапазона
GtkSpinButton — Получение целого или дробного числа от пользователя
GtkSearchEntry — Поле ввода со значком поиска
GtkSearchBar — Панель инструментов для интеграции поля поиска
GtkEditable — Интерфейс для виджетов редактирования текста
Многострочный редактор текста
Обзор виджетов текста — Обзор GtkTextBuffer, GtkTextView и сопутствующих элементов
GtkTextIter — Итератор буфера текста
GtkTextMark — Позиция в буфере, сохраняемая при изменениях буфера
GtkTextBuffer — Хранит атрибутированный текст для отображения в GtkTextView
GtkTextTag — Тег, который может быть применен к тексту в GtkTextBuffer
GtkTextTagTable — Коллекция тегов, которые можно использовать вместе
GtkTextView — Виджет, который отображает GtkTextBuffer
Виджеты деревьев, списков и таблиц иконок
Обзор виджетов дерева и списка — Обзор GtkTreeModel, GtkTreeView и родственных им
GtkTreeModel — Интерфейс дерева, используемый GtkTreeView
GtkTreeSelection — Объект выбора для GtkTreeView
GtkTreeViewColumn — Видимая колонка в виджете GtkTreeView
GtkTreeView — Виджет для отображения деревьев и списков
Перетаскивание в GtkTreeView — Интерфейсы поддержки перетаскивания в GtkTreeView
GtkCellView — Виджет, отображающий одну строку GtkTreeModel
GtkIconView — Виджет, отображающий список значков в сетке
GtkTreeSortable — Интерфейс сортируемых моделей, используемых GtkTreeView
GtkTreeModelSort — GtkTreeModel, который делает сортируемой базовую модель дерева
GtkTreeModelFilter — GtkTreeModel, который скрывает части базовой модели дерева
GtkCellLayout — Интерфейс для размещения ячеек
GtkCellArea — Абстрактный класс для компоновки GtkCellRenderers
GtkCellAreaBox — Область ячейки, которая отрисовывает GtkCellRenderers в строку или столбец
GtkCellAreaContext — Хранит геометрическую информацию для серии строк в GtkCellArea
GtkCellRenderer — Объект для отрисовки одной ячейки
GtkCellEditable — Интерфейс для виджетов, которые могут использоваться для редактирования ячеек
GtkCellRendererAccel — Отображает сочетание клавиш в ячейке
GtkCellRendererCombo — Отображает раскрывающийся список в ячейке
GtkCellRendererPixbuf — Отображает pixbuf в ячейке
GtkCellRendererProgress — Отображает числа в виде полос прогресса
GtkCellRendererSpin — Отображает спин-кнопку в ячейке
GtkCellRendererText — Отображает текст в ячейке
GtkCellRendererToggle — Отображает переключатель в ячейке
GtkCellRendererSpinner — Отображает анимацию вращения в ячейке
GtkListStore — Структура данных типа список, которая может использоваться с GtkTreeView
GtkTreeStore — Структура данных типа дерево, которая может использоваться с GtkTreeView
Меню, Комбобоксы, Панели инструментов
GtkComboBox — Виджет для выбора из списка элементов
GtkComboBoxText — Простой комбобокс только с текстом
GtkMenu — Виджет меню
GtkMenuBar — Подкласс GtkMenuShell, содержащий виджеты GtkMenuItem
GtkMenuItem — Виджет, используемый для элементов в меню
GtkRadioMenuItem — Выбор из нескольких галочных элементов меню
GtkCheckMenuItem — Элемент меню с флажком
GtkSeparatorMenuItem — Разделитель, используемый в меню
GtkToolShell — Интерфейс для контейнеров, содержащих виджеты GtkToolItem
GtkToolbar — Создание панелей с кнопками и другими виджетами
GtkToolItem — Базовый класс виджетов, которые можно добавить в GtkToolShell
GtkToolPalette — Панель инструментов с категориями
GtkToolItemGroup — Вложенный контейнер, используемый в панели инструментов
GtkSeparatorToolItem — Элемент панели инструментов, разделяющий группы других элементов панели инструментов
GtkToolButton — Подкласс GtkToolItem, отображающий кнопки
GtkMenuToolButton — GtkToolItem, содержащий кнопку с дополнительным выпадающим меню
GtkToggleToolButton — GtkToolItem, содержащий переключатель
GtkRadioToolButton — Элемент панели инструментов, содержащий радиокнопку
GtkPopover — Контекстные всплывающие окна
GtkPopoverMenu — Всплывающие окна для использования в качестве меню
Виджеты выбора и диалоги
GtkColorChooser — Интерфейс, реализованный виджетами для выбора цветов
GtkColorButton — Кнопка для запуска диалога выбора цвета
GtkColorChooserWidget — Виджет для выбора цвета
GtkColorChooserDialog — Диалог для выбора цвета
GtkFileChooser — Интерфейс выбора файла, используемый GtkFileChooserWidget и GtkFileChooserDialog
GtkFileChooserButton — Кнопка для запуска диалога выбора файла
GtkFileChooserNative — Диалог выбора файла в стиле ОС, подходящий для команд «Файл/Открыть» или «Файл/Сохранить»
GtkFileChooserDialog — Диалог выбора файла, подходящий для команд «Файл/Открыть» или «Файл/Сохранить»
GtkFileChooserWidget — Виджет выбора файла
GtkFileFilter — Фильтр для выбора подмножества файлов
GtkFontChooser — Интерфейс, реализованный виджетами, отображающими шрифты
GtkFontButton — Кнопка для запуска диалога выбора шрифта
GtkFontChooserWidget — Виджет для выбора шрифтов
GtkFontChooserDialog — Диалог для выбора шрифтов
GtkPlacesSidebar — Боковая панель, отображающая часто используемые места в файловой системе
Украшения
GtkFrame — Контейнер с декоративной рамкой и необязательной меткой
GtkSeparator — Виджет-разделитель
Прокрутка
GtkScrollbar — Ползунок прокрутки
GtkScrolledWindow — Добавляет полосы прокрутки к своему дочернему виджету
GtkScrollable — Интерфейс для прокручиваемых виджетов
Печать
GtkPrintOperation — Высокоуровневый API печати
GtkPrintContext — Оборачивает контекст для рисования страниц
GtkPrintSettings — Хранит настройки печати
GtkPageSetup — Хранит информацию о настройках страницы
GtkPaperSize — Поддержка именованных размеров бумаги
GtkPrinter — Представляет принтер
GtkPrintJob — Представляет задание печати
GtkPrintUnixDialog — Диалог печати
GtkPageSetupUnixDialog — Диалог настройки страницы
Обзор сочетаний клавиш
GtkShortcutsWindow — Главное окно, которое показывает подсказки для сочетаний клавиш
GtkShortcutsSection — Представляет режим приложения в GtkShortcutsWindow
GtkShortcutsGroup — Представляет группу сочетаний клавиш в GtkShortcutsWindow
GtkShortcutsShortcut — Представляет сочетание клавиш в GtkShortcutsWindow
Разное
GtkAdjustment — Представление настраиваемого ограниченного значения
GtkCalendar — Отображает календарь и позволяет пользователю выбирать дату
GtkDrawingArea — Виджет для пользовательских элементов интерфейса
GtkGLArea — Виджет для пользовательского рисования с OpenGL
GtkEventBox — Виджет, используемый для перехвата событий для виджетов, у которых нет собственного окна
GtkHandleBox — Виджет для отделяемых частей окна
GtkIMContextSimple — Контекст метода ввода, поддерживающий методы ввода на основе таблиц
GtkIMMulticontext — Контекст метода ввода, поддерживающий несколько загружаемых методов ввода
GtkSizeGroup — Группировка виджетов, чтобы они запрашивали одинаковый размер
GtkTooltip — Добавление подсказок к вашим виджетам
GtkViewport — Адаптер, который делает виджеты прокручиваемыми
GtkAccessible — Поддержка доступности для виджетов
Абстрактные базовые классы
GtkWidget — Базовый класс для всех виджетов
GtkContainer — Базовый класс для виджетов, содержащих другие виджеты
GtkBin — Контейнер с одним дочерним элементом
GtkMenuShell — Базовый класс для объектов меню
GtkRange — Базовый класс для виджетов, визуализирующих корректировку
GtkIMContext — Базовый класс для контекстов метода ввода
GtkNativeDialog — Интеграция с родными диалоговыми окнами
Встраивание между процессами
GtkPlug — Окно верхнего уровня для встраивания в другие процессы
GtkSocket — Контейнер для виджетов из других процессов
Недавно использовавшиеся документы
GtkRecentManager — Управление недавно использовавшимися файлами
GtkRecentChooser — Интерфейс, реализуемый виджетами для отображения недавно использовавшихся файлов
GtkRecentChooserDialog — Отображение недавно использовавшихся файлов в диалоговом окне
GtkRecentChooserMenu — Отображение недавно использовавшихся файлов в меню
GtkRecentChooserWidget — Отображение недавно использовавшихся файлов
GtkRecentFilter — Фильтр для выбора подмножества недавно использовавшихся файлов
Выбор из установленных приложений
GtkAppChooser — Интерфейс, реализуемый виджетами для выбора приложения
GtkAppChooserButton — Кнопка для запуска диалогового окна выбора приложения
GtkAppChooserDialog — Диалоговое окно выбора приложения
GtkAppChooserWidget — Виджет выбора приложения, который можно встроить в другие виджеты
Жесты и обработка событий
GtkEventController — Самодостаточный обработчик серии событий
GtkEventControllerKey — Контроллер событий для событий нажатия клавиш
GtkEventControllerScroll — Контроллер событий для событий прокрутки
GtkEventControllerMotion — Контроллер событий для событий перемещения
GtkGesture — Базовый класс для жестов
GtkGestureSingle — Базовый класс для жестов мыши/одного касания
GtkGestureDrag — Жест перетаскивания
GtkGestureLongPress — Жест «Нажатие и удержание»
GtkGestureMultiPress — Жест множественного нажатия
GtkGesturePan — Жест перемещения
GtkGestureSwipe — Жест свайпа
GtkGestureRotate — Жест поворота
GtkGestureZoom — Жест масштабирования
GtkGestureStylus — Жест для ввода стилусом
GtkPadController — Контроллер для планшетов с сенсорным входом
Устаревшие
GtkSymbolicColor — Символьные цвета
GtkGradient — Градиенты
Файлы ресурсов — Устаревшие функции для работы с файлами ресурсов
GtkStyle — Устаревший объект, содержащий информацию о стиле для виджетов
GtkHScale — Горизонтальный ползунок для выбора значения из диапазона
GtkVScale — Вертикальный ползунок для выбора значения из диапазона
GtkTearoffMenuItem — Элемент меню, используемый для отрыва и повторного присоединения меню
GtkColorSelection — Устаревший виджет, используемый для выбора цвета
GtkColorSelectionDialog — Устаревший диалоговый ящик для выбора цвета
GtkHSV — Виджет «цветовой круг»
GtkFontSelection — Устаревший виджет для выбора шрифтов
GtkFontSelectionDialog — Устаревший диалоговый ящик для выбора шрифтов
GtkHBox — Горизонтальная контейнерная коробка
GtkVBox — Вертикальная контейнерная коробка
GtkHButtonBox — Контейнер для горизонтального расположения кнопок
GtkVButtonBox — Контейнер для вертикального расположения кнопок
GtkHPaned — Контейнер с двумя панелями, расположенными горизонтально
GtkVPaned — Контейнер с двумя панелями, расположенными вертикально
GtkTable — Размещение виджетов в регулярных шаблонах
GtkHSeparator — Горизонтальная разделительная линия
GtkVSeparator — Вертикальная разделительная линия
GtkHScrollbar — Горизонтальная полоса прокрутки
GtkVScrollbar — Вертикальная полоса прокрутки
GtkUIManager — Создание меню и панелей инструментов из описания XML
GtkActionGroup — Группа действий
GtkAction — Устаревшее действие, которое может быть вызвано элементом меню или панели инструментов
GtkToggleAction — Действие, которое может быть переключено между двумя состояниями
GtkRadioAction — Действие, из которых только одно в группе может быть активным
GtkRecentAction — Действие, представляющее список недавно использовавшихся файлов
GtkActivatable — Интерфейс для активируемых виджетов
GtkImageMenuItem — Устаревший виджет для элемента меню с иконкой
GtkMisc — Базовый класс для виджетов с выравниванием и отступами
Стандартные элементы — Предварительно созданные общие элементы меню/панелей инструментов и соответствующие иконки
Темабельные стандартные изображения — Работа со стандартными иконками
GtkNumerableIcon — GIcon, позволяющий добавлять нумерованные значки
GtkArrow — Отображает стрелку
GtkStatusIcon — Отображение иконки в системном лотке
GtkThemingEngine — Модули для темы
GtkAlignment — Виджет, управляющий выравниванием и размером своего дочернего элемента
III. Справочник по GTK+ Core
Основной цикл и события — Инициализация библиотеки, основной цикл обработки событий и события
Информация о версии — Переменные и функции для проверки версии GTK+
Группы ускорителей — Группы глобальных ускорителей клавиатуры для всего GtkWindow
Карты ускорителей — Загружаемые спецификации ускорителей клавиатуры
Буферы обмена — Хранение данных в буферах обмена
Перетаскивание и сбрасывание — Функции для управления обработкой перетаскивания и сбрасывания
Настройки — Обмен настройками между приложениями
Связывания — Настройки клавиш для отдельных виджетов
Стандартные перечисления — Публичные перечисленные типы, используемые в GTK+
Выборки — Функции для обработки межпроцессного взаимодействия через выборки
Тестирование — Утилиты для тестирования приложений GTK+
Утилиты файловой системы — Функции для работы с GIO
IV. Тематическое оформление в GTK+
Обзор CSS в GTK+ — Обзор CSS в GTK+
Свойства CSS в GTK+ — Свойства CSS в GTK+
GtkStyleContext — Рендеринг элементов пользовательского интерфейса
GtkCssProvider — Стилевое оформление виджетов по типу CSS
GtkStyleProvider — Интерфейс для предоставления стилевой информации GtkStyleContext
GtkStyleProperties — Хранилище информации о свойствах стиля
GtkWidgetPath — Абстракция пути к виджету
GtkIconTheme — Поиск иконок по имени
V. Миграция с предыдущих версий GTK+
Миграция из GTK+ 2.x в GTK+ 3
Подготовка в GTK+ 2.x
Не включайте отдельные заголовочные файлы
Не используйте устаревшие символы
Используйте функции-акцессоры вместо прямого доступа
Замените GDK_<keyname> на GDK_KEY_<keyname>
Используйте GIO для запуска приложений
Используйте cairo для отрисовки
Изменения, которые необходимо выполнить во время перехода
Замените size_request на get_preferred_width/height
Замените GdkRegion на cairo_region_t
Замените GdkPixmap на поверхности cairo
Замените GdkColormap на GdkVisual
GdkDrawable больше не существует
Фильтрация событий
Код, специфичный для бэкенда
GtkPlug и GtkSocket
Сигнал GtkWidget::draw
Ориентация GtkProgressBar
Проверьте флаги expand и fill
Изменения в прокрутке
GtkObject больше не существует
Параметры сигнала GtkEntryCompletion
Маркеры изменения размера
Предотвращение смешанной компоновки
Установка модулей GTK+ в нужном месте
Изменения в оформлении
Миграция тем
Миграция движков тем
Расширение парсера CSS
Использование формата файла CSS
Список проверок для виджетов
Обработка пользовательских ресурсов
Дополнительные баллы
Миграция из libunique в GApplication или GtkApplication
Уникальность
Команды и сообщения
Миграция из EggSMClient в GtkApplication
Миграция из других контейнеров в GtkGrid
GtkBox против GtkGrid: размещение
GtkBox против GtkGrid: размеры
GtkBox против GtkGrid: отступы
Список проверок для миграции
Реализация GtkWidget::popup_menu
Использование GdkEventExpose.region
Правильная проверка модификаторов клавиш
Использование именованных иконок
Миграция между версиями GTK+ 3
Изменения в GTK+ 3.2
Изменения в GTK+ 3.4
Изменения в GTK+ 3.6
Изменения в GTK+ 3.8
Изменения в GTK+ 3.10
Изменения в GTK+ 3.12
Изменения в GTK+ 3.14
Изменения в GTK+ 3.16
Изменения в GTK+ 3.18
Изменения в GTK+ 3.20
Изменения в GTK+ 3.22
VI. Инструменты GTK+
gtk3-demo — Демонстрация виджетов GTK+
gtk3-demo-application — Демонстрация GtkApplication
gtk3-widget-factory — Демонстрация виджетов GTK+
gtk3-icon-browser — Список тематических иконок
gtk-query-immodules-3.0 — Утилита регистрации модулей ввода
gtk-update-icon-cache — Утилита кэширования тем иконок
gtk-encode-symbolic-svg — Утилита преобразования символических иконок в SVG
gtk-builder-tool — Утилита для работы с файлами GtkBuilder
gtk-launch — Запуск приложения
gtk-query-settings — Утилита для вывода имени и значения всех свойств GtkSettings
broadwayd — Сервер отображения Broadway
VII. Поддержка платформ GTK+
Компиляция библиотек GTK+ — Как скомпилировать сам GTK+
Компиляция приложений GTK+ — Как скомпилировать ваше приложение GTK+
Запуск приложений GTK+ — Как запустить и отладить ваше приложение GTK+
Использование GTK+ в системе X Window — Аспекты использования GTK+ специфичные для X11
Использование GTK+ в Windows — Аспекты использования GTK+ специфичные для Windows
Использование GTK+ в Mac OS X — Аспекты использования GTK+ специфичные для OS X
Использование GTK+ с Broadway — Аспекты использования GTK+ специфичные для HTML
Использование GTK+ с Wayland — Аспекты использования GTK+ специфичные для Wayland
Словарь терминов
Индекс всех символов
Словарь аннотаций

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/index.html

Spec-Zone.ru

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