X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=docs%2Freference%2Fgtk%2Fgtk-docs.sgml;h=370a6dbaf859ee805d32e2913debf4a5ef484c22;hb=27f746fbd0e56872a8d3b4bfff2588ad0b7cd7c4;hp=056432077f6d52c7af565a4b1b0f047fa5b8a4f2;hpb=c9b26b3dc6eaf9f8314264cb1cfc763fcbf06243;p=~andy%2Fgtk diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml index 056432077..370a6dbaf 100644 --- a/docs/reference/gtk/gtk-docs.sgml +++ b/docs/reference/gtk/gtk-docs.sgml @@ -1,164 +1,242 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ]> GTK+ Reference Manual + for GTK+ &version; - - GTK+ + + GTK+ Overview + -GTK+ is a multi-platform open source GUI Toolkit. Everything about -GTK+ from the object-oriented design to the Free Software LGPL -licensing allows you to code your project with the most freedom -possible. You can develop open software, free software, or even -commercial non-free software without having to spend a dime for -licenses or royalties. - - -GTK+ is a set of libraries to create graphical user interfaces. It -works on many Unix-like platforms, Windows, and on framebuffer +GTK+ is a library for creating graphical user interfaces. It +works on many UNIX-like platforms, Windows, and on framebuffer devices. GTK+ is released under the GNU Library General Public License (GNU LGPL), which allows for flexible licensing of client applications. GTK+ has a C-based object-oriented architecture that @@ -167,180 +245,297 @@ been written, including C++, Objective-C, Guile/Scheme, Perl, Python, TOM, Ada95, Free Pascal, and Eiffel. -GTK+ consists of the following component libraries: +GTK+ depends on the following libraries: GLib -Provides many useful data types, macros, type conversions, -string utilities and a lexical scanner. Includes Win32 support. +A general-purpose utility library, not specific to graphical user interfaces. +GLib provides many useful data types, macros, type conversions, +string utilities, file utilities, a main loop abstraction, and so on. + + + + +Pango + + +Pango is a library for internationalized text handling. It centers +around the PangoLayout object, representing +a paragraph of text. +Pango provides the engine for GtkTextView, +GtkLabel, +GtkEntry, and +other widgets that display text. + + + + + +ATK + + +ATK is the Accessibility Toolkit. It provides a set of generic +interfaces allowing accessibility technologies to interact with a +graphical user interface. For example, a screen reader uses ATK to +discover the text in an interface and read it to blind users. GTK+ +widgets have built-in support for accessibility using the ATK +framework. + + + + + +GdkPixbuf + +This is a small library which allows you to create GdkPixbuf +("pixel buffer") objects from image data or image files. +Use a GdkPixbuf in combination with GtkImage to display images. GDK -A wrapper for low-level windowing functions. +GDK is the abstraction layer that allows GTK+ to support multiple +windowing systems. GDK provides drawing and window system facilities +on X11, Windows, and the Linux framebuffer device. GTK+ -An advanced widget set. + +The GTK+ library itself contains widgets, +that is, GUI components such as GtkButton or +GtkTextView. + - + + >k-Building; >k-Compiling; + >k-Running; + >k-X11; >k-Windows; + >k-OSX; + >k-DirectFB; >k-Framebuffer; + >k-Resources; + >k-Questions; + + + + + GTK+ Core Reference >k-General; - >k-Feature-Test-Macros; - >k-Graphics-Contexts; - >k-Styles; - - >k-Resource-Files; - >k-Keyboard-Accelerators; - >k-Selections; + &GtkAccelGroup; + >k-accel-map; >k-Clipboards; >k-Drag-and-Drop; - >k-Signals; + >k-Named-Icons; >k-Stock-Items; >k-Themeable-Stock-Images; - >k-Types; + >k-Resource-Files; + >k-Settings; >k-Bindings; >k-Standard-Enumerations; + >k-Graphics-Contexts; + >k-Styles; + >k-Selections; + >k-Feature-Test-Macros; + >k-Signals; + >k-Types; + - - - + GTK+ Widgets and Objects - + Object Hierarchy &index-Object-Tree; - + + + + Widget Gallery + &visual-index; + - + Windows &GtkDialog; &GtkInvisible; &GtkMessageDialog; - &GtkPlug; &GtkWindow; - + &GtkWindowGroup; + &GtkAboutDialog; + &GtkAssistant; + - + Display Widgets &GtkAccelLabel; &GtkImage; &GtkLabel; &GtkProgressBar; &GtkStatusbar; - + &GtkStatusIcon; + - + Buttons and Toggles &GtkButton; &GtkCheckButton; &GtkRadioButton; &GtkToggleButton; - + &GtkLinkButton; + - + Numeric/Text Data Entry &GtkEntry; + &GtkEntryCompletion; &GtkHScale; - &GtkSpinButton; &GtkVScale; - + &GtkSpinButton; + &GtkEditable; + - + Multiline Text Editor >k-TextWidget; - >k-GtkTextIter; - >k-GtkTextMark; + &GtkTextIter; + &GtkTextMark; &GtkTextBuffer; &GtkTextTag; &GtkTextTagTable; &GtkTextView; - + - - Tree and List Widget + + Tree, List and Icon Grid Widgets >k-TreeWidget; - >k-GtkTreeModel; - >k-GtkTreeSelection; - >k-GtkTreeStore; - >k-GtkTreeViewColumn; - >k-GtkTreeView; - >k-GtkTreeModelSort; - >k-GtkCellRenderer; - >k-GtkCellRendererPixbuf; - >k-GtkCellRendererText; - >k-GtkCellRendererTextPixbuf; - >k-GtkCellRendererToggle; - >k-GtkListStore; - - + &GtkTreeModel; + &GtkTreeSelection; + &GtkTreeViewColumn; + &GtkTreeView; + &GtkTreeDND; + &GtkCellView; + &GtkIconView; + &GtkTreeSortable; + &GtkTreeModelSort; + &GtkTreeModelFilter; + &GtkCellLayout; + &GtkCellRenderer; + &GtkCellEditable; + &GtkCellRendererAccel; + &GtkCellRendererCombo; + &GtkCellRendererPixbuf; + &GtkCellRendererProgress; + &GtkCellRendererSpin; + &GtkCellRendererText; + &GtkCellRendererToggle; + &GtkListStore; + &GtkTreeStore; + + + Menus, Combo Box, Toolbar - &GtkCheckMenuItem; - &GtkCombo; - &GtkItemFactory; + &GtkComboBox; + &GtkComboBoxEntry; &GtkMenu; &GtkMenuBar; &GtkMenuItem; &GtkMenuShell; - &GtkOptionMenu; + &GtkImageMenuItem; &GtkRadioMenuItem; + &GtkCheckMenuItem; + &GtkSeparatorMenuItem; &GtkTearoffMenuItem; &GtkToolbar; - + &GtkToolItem; + &GtkSeparatorToolItem; + &GtkToolButton; + &GtkMenuToolButton; + &GtkToggleToolButton; + &GtkRadioToolButton; + + + + Action-based menus and toolbars + &GtkUIManager; + &GtkActionGroup; + &GtkAction; + &GtkToggleAction; + &GtkRadioAction; + - + Selectors (File/Font/Color/Input Devices) + &GtkColorButton; &GtkColorSelection; &GtkColorSelectionDialog; &GtkFileSelection; + &GtkFileChooser; + &GtkFileChooserButton; + &GtkFileChooserDialog; + &GtkFileChooserWidget; + &GtkFileFilter; + &GtkFontButton; &GtkFontSelection; &GtkFontSelectionDialog; &GtkInputDialog; - + - + Layout Containers &GtkAlignment; &GtkAspectFrame; &GtkHBox; + &GtkVBox; &GtkHButtonBox; + &GtkVButtonBox; &GtkFixed; &GtkHPaned; + &GtkVPaned; &GtkLayout; &GtkNotebook; &GtkTable; - &GtkVButtonBox; - &GtkVBox; - &GtkVPaned; - + &GtkExpander; + - + Ornaments &GtkFrame; &GtkHSeparator; &GtkVSeparator; - + - + Scrolling &GtkHScrollbar; - &GtkScrolledWindow; &GtkVScrollbar; - + &GtkScrolledWindow; + + + + Printing + &GtkPrintOperation; + &GtkPrintContext; + &GtkPrintSettings; + &GtkPageSetup; + &GtkPaperSize; + &GtkPrintUnixDialog; + &GtkPrinter; + &GtkPrintJob; + &GtkPageSetupUnixDialog; + - + Miscellaneous &GtkAdjustment; &GtkArrow; @@ -348,21 +543,20 @@ An advanced widget set. &GtkDrawingArea; &GtkEventBox; &GtkHandleBox; - &GtkIMContext; + &GtkIMContextSimple; &GtkIMMulticontext; &GtkSizeGroup; &GtkTooltips; &GtkViewport; - + &GtkAccessible; + - + Abstract Base Classes &GtkBin; &GtkBox; &GtkButtonBox; &GtkContainer; - >k-GtkEditable; - &GtkOldEditable; &GtkItem; &GtkMisc; &GtkObject; @@ -372,37 +566,110 @@ An advanced widget set. &GtkScrollbar; &GtkSeparator; &GtkWidget; - + &GtkIMContext; + - + Cross-process Embedding + &GtkPlug; &GtkSocket; - + - + Special-purpose features &GtkCurve; &GtkGammaCurve; - &GtkHRuler; &GtkRuler; + &GtkHRuler; &GtkVRuler; - + + + + Recently Used Documents + &GtkRecentManager; + &GtkRecentChooser; + &GtkRecentChooserDialog; + &GtkRecentChooserMenu; + &GtkRecentChooserWidget; + &GtkRecentFilter; + - + Deprecated &GtkCList; &GtkCTree; + &GtkCombo; + &GtkItemFactory; &GtkList; &GtkListItem; + &GtkOldEditable; + &GtkOptionMenu; &GtkPixmap; - &GtkProgress; &GtkPreview; + &GtkProgress; &GtkText; &GtkTipsQuery; &GtkTree; &GtkTreeItem; - + + + + + Migrating from Previous Versions of GTK+ + + + + This part describes what you need to change in programs use + older versions of GTK+ so that they can use the new features. + It also mentions how to convert applications using widgets + found in the libgnomeui library to use their counterparts + in GTK+. + + + + >k-migrating-checklist; + >k-Changes-1-2; + >k-Changes-2-0; + >k-migrating-GtkFileChooser; + >k-migrating-GtkAction; + >k-migrating-GtkComboBox; + >k-migrating-GtkIconView; + >k-migrating-GtkAboutDialog; + >k-migrating-GtkColorButton; + >k-migrating-GtkAssistant; + >k-migrating-GtkRecentChooser; + >k-migrating-GtkLinkButton; + + + + GTK+ Tools + + >k-query-immodules; + >k-update-icon-cache; + + + >k-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 +