Manuel de référence de GTK+
pour GTK+ 2.11.6
Table des matières
I.
Vue d'ensemble de GTK+
Compiler les bibliothèques GTK+
- Comment compiler GTK+ lui-même
Compiler les applications GTK+
- Comment compiler votre propre application GTK+
Lancer une application GTK+
- Comment lancer et déboguer votre application GTK+
Utiliser GTK+ dans le système X Windows
- Aspects X11 de l'utilisation de GTK+
(en cours)
Utiliser GTK+ dans Windows
- Les aspects spécifiques à l'utilisation de GTK+ dans Windows
Utiliser GTK+ dans Mac OS X
- Les aspects spécifiques à l'utilisation de GTK+ dans l'OS X
Utiliser GTK + dans DirectFB
- Les spécificités de l'utilisation de GTK+ dans DierctFB
Liste des Adresses Electroniques et rapport de bogues
- Obtenir de l'aide pour GTK+
Questions communes
- Trouver des réponses aux questions communes dans le manuel de GTK+
II.
Références de GTK+ Core
Boucle principale et événements
- Initialisation de la bibliothèque, boucle événementielle principale et événements
Groupes accélérateur
- Groupes des accelérateurs globaux du clavier pour un GtkWindow complet
Cartes des accélérateurs
- Caractéristiques des accélérateurs clavier chargeables
Presse-papier
- Mettre des données dans le presse-papier
Glisser-déposer
- Fonctions pour contrôler les manipulation du Glisser-Déposer
GtkIconTheme
- Rechercher les icônes à partir de leur nom
Stock Items
- Menu/barre d'outils commun prédéfini et icônes correspondantes
Stock Images dans un thème
- Manipuler des stock icons
Fichier ressource
- Routines pour manipuler des dossiers ressource
Configurations
- Partage des configurations entre les applications
Raccourcis
- raccourcis claviers pour les widgets isolés
(traduction très laborieuse !!) :(
Enumérations standards
- Types publiques d'énumérations utilisées dans GTK+
Contextes graphiques
- Ensemble d'objets partagés de GdkGC
Styles
- Fonctions pour dessiner les parties d'un widget
Sélections
- Fonctions pour manipuler des interprocessus de communication via des sélections
(en cours)
Version et information
- Variables et fonctions pour définir la version de GTK+
(en cours)
Signaux
- Méthodes d'objet et les callbacks
(en cours--> ne reste que des fonctions dépréciées à traduire)
Types
- Handle run-time type creation
(en cours)
III.
Les Widgets et les objets dans GTK+
Hiérarchie des Objects
Galerie des Widgets
Fenêtres
GtkDialog
- Créer une fenêtre popup
GtkInvisible
- Un widget qui n'est pas affiché
GtkMessageDialog
- Un message d'information de la fenêtre
GtkWindow
- Niveau supérieur qui peut contenir d'autres widgets
GtkWindowGroup
- Limite les effets des interceptions
GtkAboutDialog
- Affiche des informations au sujet de l'application
GtkAssistant
- Un widget utilisé pour guider les utilisateurs pour des opérations multi-tâches
Widgets d'affichage
GtkAccelLabel
- Label qui affiche un accélérateur clavier à la droite du texte
GtkImage
- Widget qui affiche une image
GtkLabel
- Widget qui affiche une quantité petite à moyenne de texte
GtkProgressBar
- Widget qui affiche un progression visuelle
GtkStatusbar
- Rapporte des messages d'importance mineur pour l'utilisateur
GtkStatusIcon
- Affiche une icône dans la zone du système tray
Boutons et boutons poussoires
GtkButton
- Widget qui crée un signal quand on clique dessus
GtkCheckButton
- Crée des widgets avec une case à cocher
GtkRadioButton
- Choix parmis des cases à cocher multiples
GtkToggleButton
- Crée des boutons qui enregistrent leur état
GtkLinkButton
- Crée des boutons reliés à un URL
Entrée de données numériques/alphanumériques
GtkEntry
- Entrée avec un champs texte d'une seule ligne
GtkEntryCompletion
- Fonctionnalité d'accomplissement des GtkEntry
(en cours)
GtkHScale - Widget ascenseur horizontale pour sélectionner une valeur dans une gamme
GtkVScale - Widget ascenseur vertical pour sélectionner une valeur dans une gamme
GtkSpinButton - Recherche d'un entier ou d'un nombre à virgule flottante par l'utilisateur
GtkEditable - Interface pour des widgets d'édition de texte
Editeurs de texte multilignes
Text Widget Overview - Vue d'ensemble de GtkTextBuffer, GtkTextView, et amis
GtkTextIter - itérateur sur le buffer texte
GtkTextMark - Position dans le buffer conservée pendant les modifications du buffer
GtkTextBuffer - Retient les attributs du texte pour l'afficher dans un GtkTextView
GtkTextTag - Une balise peut être appliquée à un texte dans un GtkTextBuffer
GtkTextTagTable - Collection de balises qui peuvent être utilisée ensemble
GtkTextView - Widget qui affiche un GtkTextBuffer
Widgets arbre, liste et grille d'icônes
Vue d'ensemble des Widgets arbre et liste
- GtkTreeModel, GtkTreeView, et autres widgets associés
GtkTreeModel
- Interface en arbre utilisée par GtkTreeView
GtkTreeSelection
- La sélection d'objets pour GtkTreeView
GtkTreeViewColumn
- Une colonne visible dans un widget GtkTreeView
GtkTreeView
- Widget pour afficher arbres et listes
GtkTreeView drag-and-drop - Interfaces utilisé pour le glisser/déposer dans GtkTreeView
GtkCellView - Widget qui affiche une simple rangée de GtkTreeModel
GtkIconView - Widget qui affiche une liste d'icônes dans une grille.
GtkTreeSortable - Interface pour classer des modèles utilisés par GtkTreeView
GtkTreeModelSort - Un GtkTreeModel qui créer un modèle fondamental d'arbre classable
GtkTreeModelFilter - GtkTreeModel masque des parties du modèle d'arbre fondamental
GtkCellLayout - Interface pour configurer les cellules
GtkCellRenderer - Objet pour montrer un cellule unique dans un GdkDrawable
GtkCellEditable - Interface pour widgets qui peuvent être utilisés pour éditer des cellules
GtkCellRendererAccel - Place un accélérateur clavier dans une cellule
GtkCellRendererCombo - Place une combobox dans une cellule
GtkCellRendererPixbuf - Place un pixbuf dans une cellule
GtkCellRendererProgress - Place une barre de progression numérique dans une cellule
GtkCellRendererSpin - Place un bouton spin dans une cellule
GtkCellRendererText - Affiche un texte dans une cellule
GtkCellRendererToggle - Affiche un bouton poussoire dans une cellule
GtkListStore - Un liste de structure de données (data structure) qui peut être utilisée avec GtkTreeView
GtkTreeStore - Une liste de data structure qui peut être utilisée avec GtkTreeView
Menus, Combo Box, Toolbar
GtkComboBox
- Un widget utilisé pour faire un choix parmis une liste d'items
(en cours)
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
Printing
GtkPrintOperation - High-level Printing API
GtkPrintContext - Encapsulates context for drawing pages
GtkPrintSettings - Stores print settings
GtkPageSetup - Stores page setup information
GtkPaperSize - Support for named paper sizes
GtkPrinter - Represents a printer
GtkPrintJob - Represents a print job
GtkPrintUnixDialog - A print dialog
GtkPageSetupUnixDialog - A page setup dialog
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
Recently Used Documents
GtkRecentManager - Managing Recently Used Files
GtkRecentChooser - Interface implemented by GtkRecentChooserWidget, GtkRecentChooserMenu and GtkRecentChooserDialog
GtkRecentChooserDialog - Displays recently used files in a dialog
GtkRecentChooserMenu - Displays recently used files in a menu
GtkRecentChooserWidget - Displays recently used files
GtkRecentFilter - A filter for selecting a subset of recently used files
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 - Input method module registration utility
gtk-update-icon-cache - Icon theme caching utility
Glossary
Index
Index des symboles obsolètes
Index des nouveaux symboles dans 2.2
Index des nouveaux symboles dans 2.4
Index des nouveaux symboles dans 2.6
Index des nouveaux symboles dans 2.8
Index des nouveaux symboles dans 2.10
Index des nouveaux symboles dans 2.12