GTK+ Reference Manual

for GTK+ 2.8.20

Table of Contents

I. GTK+ Overview
  Compiling the GTK+ libraries - How to compile GTK+ itself
  Compiling GTK+ Applications - How to compile your GTK+ application
  Running GTK+ Applications - How to run and debug your GTK+ application
  Using GTK+ on Windows - Windows-specific aspects of using GTK+
  Using GTK+ on the Framebuffer - Linux framebuffer aspects of using GTK+
  Using GTK+ on the X Window System - X11 aspects of using GTK+
  Mailing lists and bug reports - Getting help with GTK+
  Common Questions - Find answers to common questions in the GTK+ manual
II. GTK+ Core Reference
  Main loop and Events - Library initialization, main event loop, and events
  Accelerator Groups - Groups of global keyboard accelerators for an entire GtkWindow
  Accelerator Maps - Loadable keyboard accelerator specifications
  Clipboards - Storing data on clipboards
  Drag and Drop - Functions for controlling drag and drop handling
  GtkIconTheme - Looking up icons by name
  Stock Items - Prebuilt common menu/toolbar items and corresponding icons
  Themeable Stock Images - Manipulating stock icons
  Resource Files - Routines for handling resource files
  Settings - Sharing settings between applications
  Bindings - Key bindings for individual widgets
  Standard Enumerations - Public enumerated types used throughout GTK+
  Graphics Contexts - A shared pool of GdkGC objects
  Styles - Functions for drawing widget parts
  Selections - Functions for handling inter-process communication via selections
  Version Information - Variables and functions to check the GTK+ version
  Signals - Object methods and callbacks
  Types - Handle run-time type creation
III. GTK+ Widgets and Objects
  Object Hierarchy
  Widget Gallery
  Windows
    GtkDialog - Create popup windows
    GtkInvisible - A widget which is not displayed
    GtkMessageDialog - A convenient message window
    GtkWindow - Toplevel which can contain other widgets
    GtkWindowGroup - Limit the effect of grabs
    GtkAboutDialog - Display information about an application
  Display Widgets
    GtkAccelLabel - A label which displays an accelerator key on the right of the text
    GtkImage - A widget displaying an image
    GtkLabel - A widget that displays a small to medium amount of text
    GtkProgressBar - A widget which indicates progress visually
    GtkStatusbar - Report messages of minor importance to the user
  Buttons and Toggles
    GtkButton - A widget that creates a signal when clicked on
    GtkCheckButton - Create widgets with a discrete toggle button
    GtkRadioButton - A choice from multiple check buttons
    GtkToggleButton - Create buttons which retain their state
  Numeric/Text Data Entry
    GtkEntry - A single line text entry field
    GtkEntryCompletion - Completion functionality for GtkEntry
    GtkHScale - A horizontal slider widget for selecting a value from a range
    GtkVScale - A vertical slider widget for selecting a value from a range
    GtkSpinButton - Retrieve an integer or floating-point number from the user
    GtkEditable - Interface for text-editing widgets
  Multiline Text Editor
    Text Widget Overview - Overview of GtkTextBuffer, GtkTextView, and friends
    GtkTextIter - Text buffer iterator
    GtkTextMark - A position in the buffer preserved across buffer modifications
    GtkTextBuffer - Stores attributed text for display in a GtkTextView
    GtkTextTag - A tag that can be applied to text in a GtkTextBuffer
    GtkTextTagTable - Collection of tags that can be used together
    GtkTextView - Widget that displays a GtkTextBuffer
  Tree, List and Icon Grid Widgets
    Tree and List Widget Overview - Overview of GtkTreeModel, GtkTreeView, and other associated widgets
    GtkTreeModel - The tree interface used by GtkTreeView
    GtkTreeSelection - The selection object for GtkTreeView
    GtkTreeViewColumn - A visible column in a GtkTreeView widget
    GtkTreeView - A widget for displaying both trees and lists
    GtkTreeView drag-and-drop - Interfaces for drag-and-drop support in GtkTreeView
    GtkCellView - A widget displaying a single row of a GtkTreeModel
    GtkIconView - A widget which displays a list of icons in a grid
    GtkTreeSortable - The interface for sortable models used by GtkTreeView
    GtkTreeModelSort - A GtkTreeModel which makes an underlying tree model sortable
    GtkTreeModelFilter - A GtkTreeModel which hides parts of an underlying tree model
    GtkCellLayout - An interface for packing cells
    GtkCellRenderer - An object for rendering a single cell on a GdkDrawable
    GtkCellEditable - Interface for widgets which can are used for editing cells
    GtkCellRendererCombo - Renders a combobox in a cell
    GtkCellRendererPixbuf - Renders a pixbuf in a cell
    GtkCellRendererProgress - Renders numbers as progress bars
    GtkCellRendererText - Renders text in a cell
    GtkCellRendererToggle - Renders a toggle button in a cell
    GtkListStore - A list-like data structure that can be used with the GtkTreeView
    GtkTreeStore - A tree-like data structure that can be used with the GtkTreeView
  Menus, Combo Box, Toolbar
    GtkComboBox - A widget used to choose from a list of items
    GtkComboBoxEntry - A text entry field with a dropdown list
    GtkMenu - A menu widget
    GtkMenuBar - A subclass widget for GtkMenuShell which holds GtkMenuItem widgets
    GtkMenuItem - The widget used for item in menus
    GtkMenuShell - A base class for menu objects
    GtkImageMenuItem - A menu item with an icon
    GtkRadioMenuItem - A choice from multiple check menu items
    GtkCheckMenuItem - A menu item with a check box
    GtkSeparatorMenuItem - A separator used in menus
    GtkTearoffMenuItem - A menu item used to tear off and reattach its menu
    GtkToolbar - Create bars of buttons and other widgets
    GtkToolItem - The base class of widgets that can be added to GtkToolbar
    GtkSeparatorToolItem - A toolbar item that separates groups of other toolbar items
    GtkToolButton - A GtkToolItem subclass that displays buttons
    GtkMenuToolButton - A GtkToolItem containing a button with an additional dropdown menu
    GtkToggleToolButton - A GtkToolItem containing a toggle button
    GtkRadioToolButton - A toolbar item that contains a radio button
  Action-based menus and toolbars
    GtkUIManager - Constructing menus and toolbars from an XML description
    GtkActionGroup - A group of actions
    GtkAction - An action which can be triggered by a menu or toolbar item
    GtkToggleAction - An action which can be toggled between two states
    GtkRadioAction - An action of which only one in a group can be active
  Selectors (File/Font/Color/Input Devices)
    GtkColorButton - A button to launch a color selection dialog
    GtkColorSelection - A widget used to select a color
    GtkColorSelectionDialog - A standard dialog box for selecting a color
    GtkFileSelection - Prompt the user for a file or directory name
    GtkFileChooser - File chooser interface used by GtkFileChooserWidget and GtkFileChooserDialog
    GtkFileChooserButton - A button to launch a file selection dialog
    GtkFileChooserDialog - A file chooser dialog, suitable for "File/Open" or "File/Save" commands
    GtkFileChooserWidget - File chooser widget that can be embedded in other widgets
    GtkFileFilter - A filter for selecting a file subset
    GtkFontButton - A button to launch a font selection dialog
    GtkFontSelection - A widget for selecting fonts
    GtkFontSelectionDialog - A dialog box for selecting fonts
    GtkInputDialog - Configure devices for the XInput extension
  Layout Containers
    GtkAlignment - A widget which controls the alignment and size of its child
    GtkAspectFrame - A frame that constrains its child to a particular aspect ratio
    GtkHBox - A horizontal container box
    GtkVBox - A vertical container box
    GtkHButtonBox - A container for arranging buttons horizontally
    GtkVButtonBox - A container for arranging buttons vertically
    GtkFixed - A container which allows you to position widgets at fixed coordinates
    GtkHPaned - A container with two panes arranged horizontally
    GtkVPaned - A container with two panes arranged vertically
    GtkLayout - Infinite scrollable area containing child widgets and/or custom drawing
    GtkNotebook - A tabbed notebook container
    GtkTable - Pack widgets in regular patterns
    GtkExpander - A container which can hide its child
  Ornaments
    GtkFrame - A bin with a decorative frame and optional label
    GtkHSeparator - A horizontal separator
    GtkVSeparator - A vertical separator
  Scrolling
    GtkHScrollbar - A horizontal scrollbar
    GtkVScrollbar - A vertical scrollbar
    GtkScrolledWindow - Adds scrollbars to its child widget
  Miscellaneous
    GtkAdjustment - A GtkObject representing an adjustable bounded value
    GtkArrow - Displays an arrow
    GtkCalendar - Displays a calendar and allows the user to select a date
    GtkDrawingArea - A widget for custom user interface elements
    GtkEventBox - A widget used to catch events for widgets which do not have their own window
    GtkHandleBox - a widget for detachable window portions
    GtkIMContextSimple - An input method context supporting table-based input methods
    GtkIMMulticontext - An input method context supporting multiple, loadable input methods
    GtkSizeGroup - Grouping widgets so they request the same size
    GtkTooltips - Add tips to your widgets
    GtkViewport - An adapter which makes widgets scrollable
    GtkAccessible - Accessibility support for widgets
  Abstract Base Classes
    GtkBin - A container with just one child
    GtkBox - Base class for box containers
    GtkButtonBox - Base class for GtkHButtonBox and GtkVButtonBox
    GtkContainer - Base class for widgets which contain other widgets
    GtkItem - Abstract base class for GtkMenuItem, GtkListItem and GtkTreeItem
    GtkMisc - Base class for widgets with alignments and padding
    GtkObject - The base class of the GTK+ type hierarchy
    GtkPaned - Base class for widgets with two adjustable panes
    GtkRange - Base class for widgets which visualize an adjustment
    GtkScale - Base class for GtkHScale and GtkVScale
    GtkScrollbar - Base class for GtkHScrollbar and GtkVScrollbar
    GtkSeparator - Base class for GtkHSeparator and GtkVSeparator
    GtkWidget - Base class for all widgets
    GtkIMContext - Base class for input method contexts
  Cross-process Embedding
    GtkPlug - Toplevel for embedding into other processes
    GtkSocket - Container for widgets from other processes
  Special-purpose features
    GtkCurve - Allows direct editing of a curve
    GtkGammaCurve - a subclass of GtkCurve for editing gamma curves.
    GtkRuler - Base class for horizontal or vertical rulers
    GtkHRuler - A horizontal ruler.
    GtkVRuler - A vertical ruler.
  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
V. GTK+ Tools
  gtk-query-immodules-2.0 - Input method module registration utility
  gtk-update-icon-cache - Icon theme caching utility
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