GTK+ Reference Manual

for GTK+ 2.6.8

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