forked from AuroraMiddleware/gtk
fc4a6b955d
* gtk/gtkdialog.c, gtk/gtkrc.c, gtk/gtkwidget.c: Markup fixes.
* gdk-pixbuf-io.c: Markup fixes.
* gdk-pixbuf/tmpl/scaling.sgml, gdk/tmpl/fonts.sgml,
gdk/tmpl/general.sgml, gdk/tmpl/rgb.sgml, gdk/tmpl/visuals.sgml,
gdk/tmpl/windows.sgml, gtk/gtk-docs.sgml, gtk/tmpl/gtkaccellabel.sgml,
gtk/tmpl/gtkcombo.sgml, gtk/tmpl/gtkdialog.sgml,
gtk/tmpl/gtkdrawingarea.sgml, gtk/tmpl/gtkeditable.sgml,
gtk/tmpl/gtkfilesel.sgml, gtk/tmpl/gtkfontseldlg.sgml,
gtk/tmpl/gtkimage.sgml, gtk/tmpl/gtkmain.sgml, gtk/tmpl/gtkmenu.sgml,
gtk/tmpl/gtkmessagedialog.sgml, gtk/tmpl/gtkobject.sgml,
gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkradiobutton.sgml,
gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtkscale.sgml, gtk/tmpl/gtksignal.sgml,
gtk/tmpl/gtksocket.sgml, gtk/tmpl/gtkspinbutton.sgml,
gtk/tmpl/gtktogglebutton.sgml, gtk/tmpl/gtksignal.sgml,
gtk/tmpl/gtktooltips.sgml, gtk/tmpl/gtkwindow.sgml,
gdk/tmpl/regions.sgml, gtk/tmpl/gtkfontsel.sgml,
gtk/tmpl/gtkpixmap.sgml, gtk/tmpl/gtkprogress.sgml,
gtk/tmpl/gtkselection.sgml, gtk/tmpl/gtktable.sgml,
gtk/tmpl/gtktipsquery.sgml: Markup fixes (mainly examples).
114 lines
3.1 KiB
Plaintext
114 lines
3.1 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkDrawingArea
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
a widget for custom user interface elements.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkDrawingArea widget is used for creating custom
|
|
user interface elements. After creating a drawing
|
|
area, the application may want to connect to:
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Mouse and button press signals to respond to input from
|
|
the user.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The "realize" signal to take any necessary actions
|
|
when the widget
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The "size_allocate" signal to take any necessary actions
|
|
when the widget changes size.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The "expose_event" signal to handle redrawing the
|
|
contents of the widget.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
As a convenience, the #GtkDrawingArea widget synthesizes
|
|
a "configure_event" when the widget is realized
|
|
and any time the size of a widget changes when it
|
|
is realized. It often suffices to connect to this
|
|
signal instead of "realize" and "size_allocate".
|
|
</para>
|
|
<para>
|
|
The following code portion demonstrates using a drawing
|
|
area to implement a widget that draws a circle.
|
|
As this example demonstrates, an expose handler should
|
|
draw only the pixels within the requested area and
|
|
should draw or clear all these pixels.
|
|
</para>
|
|
<example>
|
|
<title>Simple <structname>GtkDrawingArea</structname> usage.</title>
|
|
<programlisting>
|
|
gboolean
|
|
expose_event (GdkWidget *widget, GdkEventExpose *event, gpointer data)
|
|
{
|
|
gdk_window_clear_area (widget->window,
|
|
event->area.x, event->area.y,
|
|
event->area.width, event->area.height);
|
|
gdk_gc_set_clip_rectangle (widget->style->fg_gc[widget->state],
|
|
&event->area);
|
|
gdk_draw_arc (widget->window,
|
|
widget->style->fg_gc[widget->state],
|
|
TRUE,
|
|
0, 0, widget->allocation.width, widget->allocation.height,
|
|
0, 64 * 360);
|
|
gdk_gc_set_clip_rectangle (widget->style->fg_gc[widget->state],
|
|
NULL);
|
|
|
|
return TRUE;
|
|
}
|
|
[...]
|
|
GtkWidget *drawing_area = gtk_drawing_area_new (<!>);
|
|
gtk_drawing_area_size (GTK_DRAWING_AREA (drawing_area),
|
|
100, 100);
|
|
gtk_signal_connect (GTK_OBJECT (drawing_area),
|
|
</programlisting>
|
|
</example>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkDrawingArea ##### -->
|
|
<para>
|
|
The #GtkDrawingArea struct contains private data only, and
|
|
should be accessed using the functions below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_drawing_area_new ##### -->
|
|
<para>
|
|
Creates a new drawing area.
|
|
</para>
|
|
|
|
@Returns: a new #GtkDrawingArea
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_drawing_area_size ##### -->
|
|
<para>
|
|
Sets the size that the drawing area will request
|
|
in response to a "size_request" signal. The
|
|
drawing area may actually be allocated a size
|
|
larger than this depending on how it is packed
|
|
within the enclosing containers.
|
|
</para>
|
|
|
|
@darea: a #GtkDrawingArea.
|
|
@width: the width to request.
|
|
@height: the height to request.
|
|
|
|
|