gtk+ 2.10

замечания по поводу перевода присылать sergeyvp@gmail.com

table of contents

i. gtk+ overview

compiling the gtk+ libraries - как самостоятельно скомпилировать gtk+

compiling gtk+ applications - как скомпилировать вашу gtk+ программу

running gtk+ applications - как отладить и выполнить вашу gtk+ программу

using gtk+ on the x window system - использование gtk+ в x

using gtk+ on windows - использование gtk+ в windows

using gtk+ on mac os x - использование gtk+ в mac os x

using gtk+ on directfb - использование gtk+ в directfb

using gtk+ on the framebuffer - использование gtk+ в linux framebuffer

mailing lists and bug reports - получение помощи по gtk+

common questions - поиск ответов на основные вопросы в руководстве gtk+

ii. gtk+ core reference

main loop and events - инициализация библиотеки, события и основной цикл

accelerator groups - группа глобальных акселераторов клавиатуры для всего gtkwindow

accelerator maps - спецификация загружаемых акселераторов клавиатуры

clipboards - запоминание данных в буфер обмена

drag and drop - функции контролирующие drag and drop обработку

gtkicontheme - определение значка по имени.

stock items - предварительно подготовленные, основные элементы меню/инструментальных панелей и соответствующие значки.

themeable stock images - манипуляции заготовленными значками

resource files - подпрограммы для обработки ресурсных файлов

settings - совместное использование параметров настройки между приложениями

bindings - привязки клавиш для индивидуальных виджетов

standard enumerations - общие перечисления типов используемые повсеместно в gtk+

graphics contexts - общедоступный пул объектов gdkgc

styles - функции для отрисовки частей виджета

selections - функции для обработки меж-процессорного взаимодействия посредством выделения

version information - переменные и функции для контроля версии gtk+

signals - методы объекта и callback-функции

types - обработка во время создания типа

iii. gtk+ widgets and objects

object hierarchy

widget gallery

windows

gtkdialog - создание всплывающих окон

gtkinvisible - неотображаемый виджет

gtkmessagedialog - окно сообщений.

gtkwindow - окно верхнего уровня, которое может содержать другие виджеты

gtkwindowgroup - ограничение эффекта захватов

gtkaboutdialog - отображение информации о приложении

gtkassistant - виджет проводящий пользователя через многошаговые операции

display widgets

gtkaccellabel - метка которая отображает ключ акселератора справа от текста.

gtkimage - виджет отображающий изображение

gtklabel - виджет отображающий небольшое количество текста

gtkprogressbar - виджет визуально отображающий процесс выполнения.

gtkstatusbar - выводит сообщения небольшой важности для пользователя

gtkstatusicon - отображает значок в системном лотке

buttons and toggles

gtkbutton - виджет создающий сигнал когда на него нажимают

gtkcheckbutton - создаёт виджеты с дискретным выключателем

gtkradiobutton - выбор из множества контроль-кнопок

gtktogglebutton - кнопки с сохраняемым состоянием

gtklinkbutton - кнопки привязанные к url

numeric/text data entry

gtkentry - однострочное поле ввода текста

gtkentrycompletion - функциональные возможности завершения для gtkentry

gtkhscale - виджет горизонтальный слайдер для выбора значения из диапазона

gtkvscale - виджет вертикальный слайдер для выбора значения из диапазона

gtkspinbutton - пользовательское определение целого или числа с плавающей точкой

gtkeditable - интерфейс для виджетов редактирования текста

multiline text editor

text widget overview - краткий обзор gtktextbuffer, gtktextview и аналогичных

gtktextiter - итератор текстового буфера

gtktextmark - позиция в буфере сохраняемая вопреки буферных модификации

gtktextbuffer - хранение текста с атрибутами для отображения в gtktextview

gtktexttag - тег применяемый к тексту в gtktextbuffer

gtktexttagtable - коллекция тегов которые могут использоваться совместно

gtktextview - виджет который отображает gtktextbuffer

tree, list and icon grid widgets

tree and list widget overview - краткий обзор gtktreemodel, gtktreeview и других связанных с ними виджетов

gtktreemodel - древовидный интерфейс используемый gtktreeview

gtktreeselection - объект выбора для gtktreeview

gtktreeviewcolumn - видимый столбец в виджете gtktreeview

gtktreeview - виджет для отображения и деревьев и списков

gtktreeview drag-and-drop - интерфейс для поддержки drag-and-drop в gtktreeview

gtkcellview - виджет отображающий единственную строку gtktreemodel

gtkiconview - виджет который отображает список значков в сетке

gtktreesortable - интерфейс для сортируемых моделей используемых виджетом gtktreeview

gtktreemodelsort - gtktreemodel который делает основную модель дерева сортируемой

gtktreemodelfilter - gtktreemodel который скрывает части основной модели дерева

gtkcelllayout - интерфейс для упаковочных ячеек

gtkcellrenderer - объект представляющий единственную ячейку в gdkdrawable

gtkcelleditable - интерфейс для виджетов которые могут использоваться для редактирования ячеек

gtkcellrendereraccel - представляет клавиатурный акселератор в ячейке

gtkcellrenderercombo - представляет поле со списком в ячейке

gtkcellrendererpixbuf - представляет изображение в ячейке

gtkcellrendererprogress - представляет числа как шкалу выполнения

gtkcellrendererspin - представляет кнопку вращения в ячейке

gtkcellrenderertext - представляет текст в ячейке

gtkcellrenderertoggle - представляет кнопку переключения в ячейке

gtkliststore - структура данных, похожая на список, используемая с gtktreeview

gtktreestore - структура данных, похожая на дерево, используемая с gtktreeview

menus, combo box, toolbar

gtkcombobox - виджет используемый для выбора из списка пунктов

gtkcomboboxentry - поле ввода текста с выпадающим списком

gtkmenu - виджет меню

gtkmenubar - подкласс виджета для gtkmenushell который содержит gtkmenuitem виджеты

gtkmenuitem - виджет используемый для пунктов меню

gtkmenushell - базовый класс для объектов меню

gtkimagemenuitem - пункт меню со значком

gtkradiomenuitem - выбор из группы объединенных пунктов

gtkcheckmenuitem - пункт меню с флажком (check box)

gtkseparatormenuitem - разделитель используемый в меню

gtktearoffmenuitem - пункт меню используемый для отсоединения меню

gtktoolbar - создаёт панель для кнопок и других виджетов

gtktoolitem - основной класс виджетов добавляемых к gtktoolbar

gtkseparatortoolitem - пункт панели инструментов разделяющий группы других пунктов

gtktoolbutton - gtktoolitem подкласс отображающий кнопки

gtkmenutoolbutton - gtktoolitem содержащий кнопку с дополнительным выпадающим меню

gtktoggletoolbutton - gtktoolitem содержащий кнопку-переключатель

gtkradiotoolbutton - пункт панели инструментов который содержит радио-кнопку

action-based menus and toolbars

gtkuimanager - создание меню и панелей инструментов из xml описания

gtkactiongroup - группа действий

gtkaction - действия которые могут быть выполнены пунктами меню или панели инструментов

gtktoggleaction - действие выполнение которого выбирается из двух состояний

gtkradioaction - единственно активное действие из группы подобных

selectors (file/font/color/input devices)

gtkcolorbutton - кнопка запуска диалога для выбора цвета

gtkcolorselection - виджет используемый для выбора цвета

gtkcolorselectiondialog - стандартный диалог выбора цвета

gtkfileselection - приглашение ввести имя файла или каталога

gtkfilechooser - интерфейс выбора файла используемый в gtkfilechooserwidget и gtkfilechooserdialog

gtkfilechooserbutton - кнопка для переключения файлов диалога выбора

gtkfilechooserdialog - диалог выбора файлов, подходящий для использования командами "file/open" или "file/save"

gtkfilechooserwidget - виджет выбора файлов который встраивается в другие виджеты

gtkfilefilter - фильтр для выбора подмножества файлов

gtkfontbutton - кнопка переключающая шрифт в диалоге выбора

gtkfontselection - виджет для выбора шрифтов

gtkfontselectiondialog - диалоговое окно для выбора шрифта

gtkinputdialog - конфигурирование устройств для xinput расширений

layout containers

gtkalignment - виджет управляющий размером и выравниванием своего дочернего виджета

gtkaspectframe - рамка вынуждающая дочерний виджет к специфическому соотношению сторон

gtkhbox - горизонтальное контейнерное поле

gtkvbox - вертикальное контейнерное поле

gtkhbuttonbox - контейнер для горизонтального расположения кнопок

gtkvbuttonbox - контейнер для вертикального расположения кнопок

gtkfixed - контейнер позволяющий фиксировать координаты позиции виджета

gtkhpaned - контейнер с двумя панелями упорядоченными горизонтально

gtkvpaned - контейнер с двумя панелями упорядоченными вертикально

gtklayout - безграничная прокручиваемая область, содержащая дочерние виджеты или/и пользовательский рисунок

gtknotebook - контейнер содержащий переключающиеся вкладки

gtktable - табличная упаковка виджетов

gtkexpander - контейнер способный скрывать дочерний виджет

ornaments

gtkframe - контейнер с декоративной рамкой и опционально с меткой

gtkhseparator - горизонтальный разделитель

gtkvseparator - вертикальный разделитель

scrolling

gtkhscrollbar – горизонтальная полоса прокрутки

gtkvscrollbar – вертикальная полоса прокрутки

gtkscrolledwindow - добавляет полосы прокрутки к своему дочернему виджету

printing

gtkprintoperation - высший уровень printing api

gtkprintcontext - изолирует содержимое для представления страниц

gtkprintsettings - сохраняет параметры печати

gtkpagesetup - сохраняет параметры страницы

gtkpapersize - поддержка именованных размеров бумаги

gtkprinter - представляет принтер

gtkprintjob - представляет задание печати

gtkprintunixdialog - диалог печати

gtkpagesetupunixdialog - диалог параметров страницы

miscellaneous

gtkadjustment - gtkobject представляющий регулятор значений

gtkarrow - отображает стрелку

gtkcalendar - отображает календарь позволяющий пользователю выбирать дату

gtkdrawingarea - виджет область рисования

gtkeventbox - виджет используемый для захвата событий виджетами не имеющими собственного окна

gtkhandlebox - виджет для перемещения частей окна

gtkimcontextsimple - система ввода контекста поддерживающий табличный метод ввода

gtkimmulticontext - система ввода контекста поддерживающая множественные, загружаемые методы ввода

gtksizegroup - группирует виджеты таким образом, чтобы они запрашивали один и тот же размер

gtktooltips - добавляет подсказки к вашим виджетам

gtkviewport - адаптер который делает виджеты прокручиваемыми

gtkaccessible - поддержка допустимости для виджетов

abstract base classes

gtkbin - контейнер для единственного виджета

gtkbox - базовый класс для контейнеров

gtkbuttonbox - базовый класс для gtkhbuttonbox и gtkvbuttonbox

gtkcontainer - базовый класс для виджетов содержащих другие виджеты

gtkitem - абстрактный базовый класс для gtkmenuitem, gtklistitem и gtktreeitem

gtkmisc - базовый класс для виджетов с выравниванием и дополнением

gtkobject - базовый класс иерархии типов gtk+

gtkpaned - базовый класс для виджетов с двумя регулируемыми панелями

gtkrange - базовый класс для виджетов которые визуализируют регулировки

gtkscale - базовый класс для gtkhscale и gtkvscale

gtkscrollbar - базовый класс для gtkhscrollbar и gtkvscrollbar

gtkseparator - базовый класс для gtkhseparator и gtkvseparator

gtkwidget - base class for all widgets

gtkimcontext - базовый класс для системы ввода контекста

cross-process embedding

gtkplug - верхний уровень встраивания в другие процессы

gtksocket - контейнер для виджетов из другого процесса

special-purpose features

gtkcurve - позволяет непосредственное редактирование кривой

gtkgammacurve - подкласс gtkcurve для редактирования кривых гаммы

gtkruler - базовый класс для горизонтальных и вертикальных линеек

gtkhruler - горизонтальная линейка

gtkvruler - вертикальная линейка

recently used documents

gtkrecentmanager - управление недавно использованными файлами

gtkrecentchooser - интерфейс реализуемый gtkrecentchooserwidget, gtkrecentchoosermenu и gtkrecentchooserdialog

gtkrecentchooserdialog - отображение недавно использованных файлов в диалоге

gtkrecentchoosermenu - отображает недавно использованные файлы в меню

gtkrecentchooserwidget - отображает недавно использованные файлы

gtkrecentfilter - фильтр для выделения подмножества недавно использованных файлов

deprecated

gtkclist - a multi-columned scrolling list widget

gtkctree - a widget displaying a hierarchical tree

gtkcombo - a text entry field with a dropdown list

gtkitemfactory - a factory for menus

gtklist - widget for packing a list of selectable items

gtklistitem - an item in a gtklist

gtkoldeditable - base class for text-editing widgets

gtkoptionmenu - a widget used to choose from a list of valid choices

gtkpixmap - a widget displaying a graphical image or icon

gtkpreview - a widget to display rgb or grayscale data

gtkprogress - base class for gtkprogressbar

gtktext - a text widget

gtktipsquery - displays help about widgets in the user interface

gtktree - a tree widget

gtktreeitem - the widget used for items in a gtktree

iv. migrating from previous versions of gtk+

migration checklist

implement gtkwidget::popup_menu

use gdkeventexpose.region

test for modifier keys correctly

use named icons

changes from 1.0 to 1.2 - incompatible changes made between version 1.0 and version 1.2

changes from 1.2 to 2.0 - incompatible changes made between version 1.2 and version 2.0

migrating from gtkfileselection to gtkfilechooser

creating a gtkfilechooserdialog

selection modes

installing a preview widget

installing extra widgets

new features

migrating from old menu and toolbar systems to gtkaction

actions and action groups

user interface manager object

migrating from gnomeuiinfo

migrating from gtkoptionmenu and gtkcombo to gtkcombobox and gtkcomboboxentry

migrating from gtkoptionmenu to gtkcombobox

migrating from gtkcombo to gtkcomboboxentry

new features

migrating from gnomeiconlist to gtkiconview

migrating from gnomeabout to gtkaboutdialog

migrating from gnomecolorpicker to gtkcolorbutton

migrating from gnomedruid to gtkassistant

inserting pages

decorating the assistant pages

setting the page flow

migrating from eggrecent to gtkrecentchooser

managing the recently used documents

displaying the recently used documents

advanced usage

migrating from gnomehref to gtklinkbutton

v. gtk+ tools

gtk-query-immodules-2.0 - утилита регистрации модуля системы ввода.

gtk-update-icon-cache - утилита кэширования тем значков.

glossary - словарь специальных терминов

index

index of deprecated symbols

index of new symbols in 2.2

index of new symbols in 2.4

index of new symbols in 2.6

index of new symbols in 2.8

index of new symbols in 2.10