GTK+ Reference Manual
http://man.chinaunix.net/develop/GTK+/2.6/gtk/
GTK+ Reference Manual |
---|
for GTK+ 2.6.2
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
- 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
- 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
- Migrating from old menu and toolbar systems to GtkAction
- Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry
- 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