Spec-Zone.ru › GTK 3.22

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

Этот документ предназначен для библиотеки GTK+ 3, версия 3.22.3. Последние версии можно найти в интернете по адресу https://developer.gnome.org/gtk3/stable/. Если вы ищете более старые библиотеки GTK+ 2, см. http://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 — Popovers для использования в качестве меню
Виджеты выбора и диалоги
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 — Самодостаточный обработчик серии событий
GtkGesture — Базовый класс для жестов
GtkGestureSingle — Базовый класс для жестов мыши/однократного касания
GtkGestureDrag — Жест перетаскивания
GtkGestureLongPress — Жест "нажатия и удержания"
GtkGestureMultiPress — Жест многократного нажатия
GtkGesturePan — Жест перемещения
GtkGestureSwipe — Жест свайпа
GtkGestureRotate — Жест поворота
GtkGestureZoom — Жест масштабирования
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+
Основной цикл и события — Инициализация библиотеки, основной цикл обработки событий и события
Информация о версии — Переменные и функции для проверки версии GTK+
Группы акселераторов — Группы глобальных акселераторов клавиатуры для всего GtkWindow
Карты акселераторов — Загружаемые спецификации акселераторов клавиатуры
Буферы обмена — Хранение данных в буферах обмена
Перетаскивание — Функции для управления обработкой перетаскивания
Настройки — Обмен настройками между приложениями
Связывания — Связывания клавиш для отдельных виджетов
Стандартные перечисления — Публичные перечисления, используемые в GTK+
Выбор — Функции для обработки межпроцессного взаимодействия через выбор
Тестирование — Утилиты для тестирования приложений GTK+
Утилиты файловой системы — Функции для работы с GIO
IV. Тематическое оформление в GTK+
GTK+ CSS — Обзор CSS в GTK+
GTK+ CSS — Свойства GTK+ CSS
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 — Утилита преобразования символьных иконок
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
Использование GTK+ с Mir — Аспекты использования GTK+ специфичные для Mir
Глоссарий
Индекс всех символов
Индекс устаревших символов
Индекс новых символов в 3.0
Индекс новых символов в 3.2
Индекс новых символов в 3.4
Индекс новых символов в 3.6
Индекс новых символов в 3.8
Индекс новых символов в 3.10
Индекс новых символов в 3.12
Индекс новых символов в 3.14
Индекс новых символов в 3.16
Индекс новых символов в 3.18
Индекс новых символов в 3.20
Индекс новых символов в 3.22
Глоссарий аннотаций

© 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/index.html

Spec-Zone.ru

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