forked from AuroraMiddleware/gtk
86b5c82a97
2000-10-23 Havoc Pennington <hp@redhat.com>
* gtk/testtext.c: Re-enable the "find" dialog
* gtk/testgtk.c: Add test for gdk_drawable_get_image
* gdk/gdkwindow.c (gdk_window_begin_paint_region): Fix bug where
the arguments to gdk_draw_drawable were in the wrong order
(gdk_window_paint_init_bg): This function was ignoring the
init_region, instead of clipping to it, so the entire backing
pixmap was cleared on every begin_paint()
(gdk_window_begin_paint_region): Hmm, the same list-walking bug
was in here again, the loop kept using the same GtkWindowPaint
over and over.
(gdk_window_begin_paint_region): Fix a bug where we had two
x_offset instead of x_offset and y_offset
* gdk/gdkdraw.c (gdk_drawable_get_image): get composite drawable
before we get the image.
(gdk_draw_drawable): get the composite before we draw the drawable.
(gdk_drawable_real_get_composite_drawable): default
get_composite_drawable implementation that returns the drawable
itself
* gdk/gdkdrawable.h (struct _GdkDrawableClass ): Add
get_composite_drawable virtual function
* gdk/gdkwindow.c (gdk_window_begin_paint_region): Fix a cheesy
list-walking bug
* gdk/x11/gdkdrawable-x11.c (gdk_x11_draw_drawable): Add a hack to
make this work if the source drawable is a GdkDrawableImplX11
instead of a public drawable type. This is really broken; the
problem is that GdkDrawable needs a virtual method get_xid(), but
of course that doesn't work in practice. Enter RTTI.
Also, improve mismatched depth message.
* gdk/gdkpixmap.c (gdk_pixmap_get_image): Implement get_image for
GdkPixmap
* gdk/x11/gdkdrawable-x11.c (gdk_drawable_impl_x11_class_init):
install _gdk_x11_get_image as our implementation of get_image
* gdk/x11/gdkimage-x11.c (gdk_image_get): Rename to
_gdk_x11_get_image and export for use in gdkdrawable-x11.c
* gdk/gdkimage.c (gdk_image_get): Make this just a wrapper around
gdk_drawable_get_image
* gdk/gdkdraw.c (gdk_drawable_get_image): call virtual get_image
* gdk/gdkdrawable.h (struct _GdkDrawableClass ): Virtualize
get_image
* gtk/gtktreestore.c (gtk_tree_store_get_node): remove weird
trailing semicolon after for loop
366 lines
12 KiB
Plaintext
366 lines
12 KiB
Plaintext
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
|
<!entity hash "#">
|
|
<!entity GtkAccelLabel SYSTEM "sgml/gtkaccellabel.sgml">
|
|
<!entity GtkAdjustment SYSTEM "sgml/gtkadjustment.sgml">
|
|
<!entity GtkAlignment SYSTEM "sgml/gtkalignment.sgml">
|
|
<!entity GtkArrow SYSTEM "sgml/gtkarrow.sgml">
|
|
<!entity GtkAspectFrame SYSTEM "sgml/gtkaspectframe.sgml">
|
|
<!entity GtkButtonBox SYSTEM "sgml/gtkbbox.sgml">
|
|
<!entity GtkBin SYSTEM "sgml/gtkbin.sgml">
|
|
<!entity GtkBox SYSTEM "sgml/gtkbox.sgml">
|
|
<!entity GtkButton SYSTEM "sgml/gtkbutton.sgml">
|
|
<!entity GtkCalendar SYSTEM "sgml/gtkcalendar.sgml">
|
|
<!entity GtkCheckButton SYSTEM "sgml/gtkcheckbutton.sgml">
|
|
<!entity GtkCheckMenuItem SYSTEM "sgml/gtkcheckmenuitem.sgml">
|
|
<!entity GtkCList SYSTEM "sgml/gtkclist.sgml">
|
|
<!entity GtkColorSelection SYSTEM "sgml/gtkcolorsel.sgml">
|
|
<!entity GtkColorSelectionDialog SYSTEM "sgml/gtkcolorseldlg.sgml">
|
|
<!entity GtkCombo SYSTEM "sgml/gtkcombo.sgml">
|
|
<!entity GtkContainer SYSTEM "sgml/gtkcontainer.sgml">
|
|
<!entity GtkCTree SYSTEM "sgml/gtkctree.sgml">
|
|
<!entity GtkCurve SYSTEM "sgml/gtkcurve.sgml">
|
|
<!entity GtkData SYSTEM "sgml/gtkdata.sgml">
|
|
<!entity GtkDialog SYSTEM "sgml/gtkdialog.sgml">
|
|
<!entity GtkDrawingArea SYSTEM "sgml/gtkdrawingarea.sgml">
|
|
<!entity GtkEditable SYSTEM "sgml/gtkeditable.sgml">
|
|
<!entity GtkEntry SYSTEM "sgml/gtkentry.sgml">
|
|
<!entity GtkEventBox SYSTEM "sgml/gtkeventbox.sgml">
|
|
<!entity GtkFileSelection SYSTEM "sgml/gtkfilesel.sgml">
|
|
<!entity GtkFixed SYSTEM "sgml/gtkfixed.sgml">
|
|
<!entity GtkFontSelection SYSTEM "sgml/gtkfontsel.sgml">
|
|
<!entity GtkFontSelectionDialog SYSTEM "sgml/gtkfontseldlg.sgml">
|
|
<!entity GtkFrame SYSTEM "sgml/gtkframe.sgml">
|
|
<!entity GtkGammaCurve SYSTEM "sgml/gtkgamma.sgml">
|
|
<!entity GtkHandleBox SYSTEM "sgml/gtkhandlebox.sgml">
|
|
<!entity GtkHButtonBox SYSTEM "sgml/gtkhbbox.sgml">
|
|
<!entity GtkHBox SYSTEM "sgml/gtkhbox.sgml">
|
|
<!entity GtkHPaned SYSTEM "sgml/gtkhpaned.sgml">
|
|
<!entity GtkHRuler SYSTEM "sgml/gtkhruler.sgml">
|
|
<!entity GtkHScale SYSTEM "sgml/gtkhscale.sgml">
|
|
<!entity GtkHScrollbar SYSTEM "sgml/gtkhscrollbar.sgml">
|
|
<!entity GtkHSeparator SYSTEM "sgml/gtkhseparator.sgml">
|
|
<!entity GtkImage SYSTEM "sgml/gtkimage.sgml">
|
|
<!entity GtkIMContext SYSTEM "sgml/gtkimcontext.sgml">
|
|
<!entity GtkIMMulticontext SYSTEM "sgml/gtkimmulticontext.sgml">
|
|
<!entity GtkInputDialog SYSTEM "sgml/gtkinputdialog.sgml">
|
|
<!entity GtkInvisible SYSTEM "sgml/gtkinvisible.sgml">
|
|
<!entity GtkItem SYSTEM "sgml/gtkitem.sgml">
|
|
<!entity GtkItemFactory SYSTEM "sgml/gtkitemfactory.sgml">
|
|
<!entity GtkLabel SYSTEM "sgml/gtklabel.sgml">
|
|
<!entity GtkLayout SYSTEM "sgml/gtklayout.sgml">
|
|
<!entity GtkList SYSTEM "sgml/gtklist.sgml">
|
|
<!entity GtkListItem SYSTEM "sgml/gtklistitem.sgml">
|
|
<!entity GtkMenu SYSTEM "sgml/gtkmenu.sgml">
|
|
<!entity GtkMenuBar SYSTEM "sgml/gtkmenubar.sgml">
|
|
<!entity GtkMenuItem SYSTEM "sgml/gtkmenuitem.sgml">
|
|
<!entity GtkMenuShell SYSTEM "sgml/gtkmenushell.sgml">
|
|
<!entity GtkMisc SYSTEM "sgml/gtkmisc.sgml">
|
|
<!entity GtkNotebook SYSTEM "sgml/gtknotebook.sgml">
|
|
<!entity GtkObject SYSTEM "sgml/gtkobject.sgml">
|
|
<!entity GtkOptionMenu SYSTEM "sgml/gtkoptionmenu.sgml">
|
|
<!entity GtkPacker SYSTEM "sgml/gtkpacker.sgml">
|
|
<!entity GtkPaned SYSTEM "sgml/gtkpaned.sgml">
|
|
<!entity GtkPixmap SYSTEM "sgml/gtkpixmap.sgml">
|
|
<!entity GtkPlug SYSTEM "sgml/gtkplug.sgml">
|
|
<!entity GtkPreview SYSTEM "sgml/gtkpreview.sgml">
|
|
<!entity GtkProgress SYSTEM "sgml/gtkprogress.sgml">
|
|
<!entity GtkProgressBar SYSTEM "sgml/gtkprogressbar.sgml">
|
|
<!entity GtkRadioButton SYSTEM "sgml/gtkradiobutton.sgml">
|
|
<!entity GtkRadioMenuItem SYSTEM "sgml/gtkradiomenuitem.sgml">
|
|
<!entity GtkRange SYSTEM "sgml/gtkrange.sgml">
|
|
<!entity GtkRuler SYSTEM "sgml/gtkruler.sgml">
|
|
<!entity GtkScale SYSTEM "sgml/gtkscale.sgml">
|
|
<!entity GtkScrollbar SYSTEM "sgml/gtkscrollbar.sgml">
|
|
<!entity GtkScrolledWindow SYSTEM "sgml/gtkscrolledwindow.sgml">
|
|
<!entity GtkSeparator SYSTEM "sgml/gtkseparator.sgml">
|
|
<!entity GtkSocket SYSTEM "sgml/gtksocket.sgml">
|
|
<!entity GtkSpinButton SYSTEM "sgml/gtkspinbutton.sgml">
|
|
<!entity GtkStatusbar SYSTEM "sgml/gtkstatusbar.sgml">
|
|
<!entity GtkTable SYSTEM "sgml/gtktable.sgml">
|
|
<!entity GtkTearoffMenuItem SYSTEM "sgml/gtktearoffmenuitem.sgml">
|
|
<!entity GtkText SYSTEM "sgml/gtktext.sgml">
|
|
<!entity GtkTextBuffer SYSTEM "sgml/gtktextbuffer.sgml">
|
|
<!entity gtk-GtkTextIter SYSTEM "sgml/gtktextiter.sgml">
|
|
<!entity gtk-GtkTextMark SYSTEM "sgml/gtktextmark.sgml">
|
|
<!entity GtkTextTag SYSTEM "sgml/gtktexttag.sgml">
|
|
<!entity GtkTextTagTable SYSTEM "sgml/gtktexttagtable.sgml">
|
|
<!entity GtkTextView SYSTEM "sgml/gtktextview.sgml">
|
|
<!entity GtkTipsQuery SYSTEM "sgml/gtktipsquery.sgml">
|
|
<!entity GtkToggleButton SYSTEM "sgml/gtktogglebutton.sgml">
|
|
<!entity GtkToolbar SYSTEM "sgml/gtktoolbar.sgml">
|
|
<!entity GtkTooltips SYSTEM "sgml/gtktooltips.sgml">
|
|
<!entity GtkTree SYSTEM "sgml/gtktree.sgml">
|
|
<!entity GtkTreeItem SYSTEM "sgml/gtktreeitem.sgml">
|
|
<!entity GtkVButtonBox SYSTEM "sgml/gtkvbbox.sgml">
|
|
<!entity GtkVBox SYSTEM "sgml/gtkvbox.sgml">
|
|
<!entity GtkViewport SYSTEM "sgml/gtkviewport.sgml">
|
|
<!entity GtkVPaned SYSTEM "sgml/gtkvpaned.sgml">
|
|
<!entity GtkVRuler SYSTEM "sgml/gtkvruler.sgml">
|
|
<!entity GtkVScale SYSTEM "sgml/gtkvscale.sgml">
|
|
<!entity GtkVScrollbar SYSTEM "sgml/gtkvscrollbar.sgml">
|
|
<!entity GtkVSeparator SYSTEM "sgml/gtkvseparator.sgml">
|
|
<!entity GtkWidget SYSTEM "sgml/gtkwidget.sgml">
|
|
<!entity GtkWindow SYSTEM "sgml/gtkwindow.sgml">
|
|
<!entity gtk-General SYSTEM "sgml/gtkmain.sgml">
|
|
<!entity gtk-Feature-Test-Macros SYSTEM "sgml/gtkfeatures.sgml">
|
|
<!entity gtk-Graphics-Contexts SYSTEM "sgml/gtkgc.sgml">
|
|
<!entity gtk-Styles SYSTEM "sgml/gtkstyle.sgml">
|
|
<!entity gtk-Themes SYSTEM "sgml/gtkthemes.sgml">
|
|
<!entity gtk-Resource-Files SYSTEM "sgml/gtkrc.sgml">
|
|
<!entity gtk-Keyboard-Accelerators SYSTEM "sgml/gtkaccelgroup.sgml">
|
|
<!entity gtk-Selections SYSTEM "sgml/gtkselection.sgml">
|
|
<!entity gtk-Drag-and-Drop SYSTEM "sgml/gtkdnd.sgml">
|
|
<!entity gtk-Signals SYSTEM "sgml/gtksignal.sgml">
|
|
<!entity gtk-Signal-Marshallers SYSTEM "sgml/gtkmarshal.sgml">
|
|
<!entity gtk-Object-Properties SYSTEM "sgml/gtkarg.sgml">
|
|
<!entity gtk-Types SYSTEM "sgml/gtktypeutils.sgml">
|
|
<!entity gtk-Bindings SYSTEM "sgml/gtkbindings.sgml">
|
|
<!entity gtk-Standard-Enumerations SYSTEM "sgml/gtkenums.sgml">
|
|
|
|
<!entity index-Object-Tree SYSTEM "sgml/tree_index.sgml">
|
|
|
|
<!entity index-Objects-Grouped SYSTEM "objects_grouped.sgml">
|
|
<!entity gtk-TextWidget SYSTEM "text_widget.sgml">
|
|
]>
|
|
<book id="index">
|
|
<bookinfo>
|
|
<title>GTK+ Reference Manual</title>
|
|
</bookinfo>
|
|
|
|
<chapter id="gtk">
|
|
<title>GTK+ </title>
|
|
<para>
|
|
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.
|
|
</para>
|
|
<para>
|
|
GTK+ is a set of libraries to create graphical user interfaces. It
|
|
works on many Unix-like platforms, and a Windows version is in
|
|
development. 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
|
|
allows for maximum flexibility. Bindings for other languages have
|
|
been written, including C++, Objective-C, Guile/Scheme, Perl, Python,
|
|
TOM, Ada95, Free Pascal, and Eiffel.
|
|
</para>
|
|
<para>
|
|
GTK+ consists of the following component libraries:
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>GLib</term>
|
|
<listitem><para>
|
|
Provides many useful data types, macros, type conversions,
|
|
string utilities and a lexical scanner. Includes Win32 support.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>GDK</term>
|
|
<listitem><para>
|
|
A wrapper for low-level windowing functions.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>GTK+</term>
|
|
<listitem><para>
|
|
An advanced widget set.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
|
|
>k-General;
|
|
>k-Feature-Test-Macros;
|
|
>k-Graphics-Contexts;
|
|
>k-Styles;
|
|
>k-Themes;
|
|
>k-Resource-Files;
|
|
>k-Keyboard-Accelerators;
|
|
>k-Selections;
|
|
>k-Drag-and-Drop;
|
|
>k-Signals;
|
|
>k-Signal-Marshallers;
|
|
>k-Object-Properties;
|
|
>k-Types;
|
|
>k-Bindings;
|
|
>k-Standard-Enumerations;
|
|
|
|
</chapter>
|
|
|
|
<chapter id="gtkobjects" role="no-toc">
|
|
<title>GTK+ Widgets and Objects</title>
|
|
|
|
<sect1>
|
|
<title>Object Hierarchy</title>
|
|
&index-Object-Tree;
|
|
</sect1>
|
|
|
|
<sect1 id="WindowWidgets">
|
|
<title>Windows</title>
|
|
&GtkDialog;
|
|
&GtkInvisible;
|
|
&GtkPlug;
|
|
&GtkWindow;
|
|
</sect1>
|
|
|
|
<sect1 id="DisplayWidgets">
|
|
<title>Display Widgets</title>
|
|
&GtkAccelLabel;
|
|
&GtkImage;
|
|
&GtkLabel;
|
|
&GtkProgressBar;
|
|
&GtkStatusbar;
|
|
</sect1>
|
|
|
|
<sect1 id="ButtonWidgets">
|
|
<title>Buttons and Toggles</title>
|
|
&GtkButton;
|
|
&GtkCheckButton;
|
|
&GtkRadioButton;
|
|
&GtkToggleButton;
|
|
</sect1>
|
|
|
|
<sect1 id="NumericEntry">
|
|
<title>Numeric/Text Data Entry</title>
|
|
&GtkEntry;
|
|
&GtkHScale;
|
|
&GtkSpinButton;
|
|
&GtkVScale;
|
|
</sect1>
|
|
|
|
<sect1 id="TextWidgetObjects">
|
|
<title>Multiline Text Editor</title>
|
|
>k-TextWidget;
|
|
>k-GtkTextIter;
|
|
>k-GtkTextMark;
|
|
&GtkText;
|
|
&GtkTextBuffer;
|
|
&GtkTextTag;
|
|
&GtkTextTagTable;
|
|
&GtkTextView;
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="MenusAndCombos">
|
|
<title>Menus, Combo Box, Toolbar</title>
|
|
&GtkCheckMenuItem;
|
|
&GtkCombo;
|
|
&GtkItemFactory;
|
|
&GtkMenu;
|
|
&GtkMenuBar;
|
|
&GtkMenuItem;
|
|
&GtkMenuShell;
|
|
&GtkOptionMenu;
|
|
&GtkRadioMenuItem;
|
|
&GtkTearoffMenuItem;
|
|
&GtkToolbar;
|
|
</sect1>
|
|
|
|
<sect1 id="SelectorWidgets">
|
|
<title>Selectors (File/Font/Color/Input Devices)</title>
|
|
&GtkColorSelection;
|
|
&GtkColorSelectionDialog;
|
|
&GtkFileSelection;
|
|
&GtkFontSelection;
|
|
&GtkFontSelectionDialog;
|
|
&GtkInputDialog;
|
|
</sect1>
|
|
|
|
<sect1 id="LayoutContainers">
|
|
<title>Layout Containers</title>
|
|
&GtkAlignment;
|
|
&GtkAspectFrame;
|
|
&GtkHBox;
|
|
&GtkHButtonBox;
|
|
&GtkFixed;
|
|
&GtkHPaned;
|
|
&GtkLayout;
|
|
&GtkNotebook;
|
|
&GtkTable;
|
|
&GtkVButtonBox;
|
|
&GtkVBox;
|
|
&GtkVPaned;
|
|
</sect1>
|
|
|
|
<sect1 id="Ornaments">
|
|
<title>Ornaments</title>
|
|
&GtkFrame;
|
|
&GtkHSeparator;
|
|
&GtkVSeparator;
|
|
</sect1>
|
|
|
|
<sect1 id="ScrollingWidgets">
|
|
<title>Scrolling</title>
|
|
&GtkHScrollbar;
|
|
&GtkScrolledWindow;
|
|
&GtkVScrollbar;
|
|
</sect1>
|
|
|
|
<sect1 id="MiscObjects">
|
|
<title>Miscellaneous</title>
|
|
&GtkAdjustment;
|
|
&GtkArrow;
|
|
&GtkCalendar;
|
|
&GtkDrawingArea;
|
|
&GtkEventBox;
|
|
&GtkHandleBox;
|
|
&GtkIMContext;
|
|
&GtkIMMulticontext;
|
|
&GtkTooltips;
|
|
&GtkViewport;
|
|
</sect1>
|
|
|
|
<sect1 id="AbstractObjects">
|
|
<title>Abstract Base Classes</title>
|
|
&GtkBin;
|
|
&GtkBox;
|
|
&GtkContainer;
|
|
&GtkEditable;
|
|
&GtkButtonBox;
|
|
&GtkMisc;
|
|
&GtkObject;
|
|
&GtkPaned;
|
|
&GtkRange;
|
|
&GtkScale;
|
|
&GtkScrollbar;
|
|
&GtkSeparator;
|
|
&GtkWidget;
|
|
</sect1>
|
|
|
|
<sect1 id="PlugSocket">
|
|
<title>Cross-process Embedding</title>
|
|
&GtkSocket;
|
|
</sect1>
|
|
|
|
<sect1 id="DeprecatedObjects">
|
|
<title>Deprecated</title>
|
|
&GtkCList;
|
|
&GtkCTree;
|
|
&GtkCurve;
|
|
&GtkData;
|
|
&GtkGammaCurve;
|
|
&GtkHRuler;
|
|
&GtkItem;
|
|
&GtkList;
|
|
&GtkListItem;
|
|
&GtkPacker;
|
|
&GtkPixmap;
|
|
&GtkPreview;
|
|
&GtkProgress;
|
|
&GtkRuler;
|
|
&GtkTipsQuery;
|
|
&GtkTree;
|
|
&GtkTreeItem;
|
|
&GtkVRuler;
|
|
</sect1>
|
|
|
|
</chapter>
|
|
|
|
</book>
|