diff options
Diffstat (limited to 'docs/reference/pygtk-gtkstyle.xml')
-rw-r--r-- | docs/reference/pygtk-gtkstyle.xml | 2948 |
1 files changed, 0 insertions, 2948 deletions
diff --git a/docs/reference/pygtk-gtkstyle.xml b/docs/reference/pygtk-gtkstyle.xml deleted file mode 100644 index 689c1f89..00000000 --- a/docs/reference/pygtk-gtkstyle.xml +++ /dev/null @@ -1,2948 +0,0 @@ -<?xml version="1.0" standalone="no"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> - -<refentry id="class-gtkstyle"> - <refnamediv> - <refname>gtk.Style</refname> - <refpurpose>an object that hold style information for widgets</refpurpose> - </refnamediv> - - <refsect1> - <title>Synopsis</title> - - <classsynopsis language="python"> - <ooclass><classname>gtk.Style</classname></ooclass> - <ooclass><classname><link -linkend="class-gobject">gobject.GObject</link></classname></ooclass> - <constructorsynopsis language="python"> - <methodname><link -linkend="constructor-gtkstyle">gtk.Style</link></methodname> - <methodparam></methodparam> </constructorsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--copy">copy</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--attach">attach</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--detach">detach</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--set-background">set_background</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--apply-default-background">apply_default_background</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">set_bg</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--lookup-icon-set">lookup_icon_set</link></methodname> - <methodparam><parameter - role="keyword">stock_id</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--render-icon">render_icon</link></methodname> - <methodparam><parameter - role="keyword">source</parameter></methodparam> - <methodparam><parameter - role="keyword">direction</parameter></methodparam> - <methodparam><parameter - role="keyword">state</parameter></methodparam> - <methodparam><parameter - role="keyword">size</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-hline">paint_hline</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x1</parameter></methodparam> - <methodparam><parameter role="keyword">x2</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-vline">paint_vline</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">y1</parameter></methodparam> - <methodparam><parameter role="keyword">y2</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-shadow">paint_shadow</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-polygon">paint_polygon</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">points</parameter></methodparam> - <methodparam><parameter - role="keyword">fill</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-arrow">paint_arrow</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">arrow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">fill</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-diamond">paint_diamond</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-box">paint_box</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-flat-box">paint_flat_box</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-check">paint_check</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-option">paint_option</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-tab">paint_tab</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-shadow-gap">paint_shadow_gap</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_side</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_x</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_width</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-box-gap">paint_box_gap</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_side</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_x</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_width</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-extension">paint_extension</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_side</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-focus">paint_focus</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-slider">paint_slider</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">orientation</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-handle">paint_handle</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">orientation</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-expander">paint_expander</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">expander_style</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-layout">paint_layout</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">use_text</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">layout</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtkstyle--paint-resize-grip">paint_resize_grip</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">edge</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - - </refsect1> - - <refsect1> - <title>Ancestry</title> - -<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link> - +-- <link linkend="class-gtkstyle">gtk.Style</link> -</synopsis> - - </refsect1> - - <refsect1 id="attributes-gtkstyle"> - <title>Attributes</title> - - <note> - <para>Even though the following attributes that are arrays of <link - linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>, - <link linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link> - or <link - linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link> - objects are read-only, the individual array items are - read-write.</para> - </note> - - <blockquote role="properties"> - <informaltable pgwide="1" frame="none"> - <tgroup cols="3"> - <?dbhtml cellpadding="5"?> - <colspec column="1" colwidth="1in"/> - <colspec column="2" colwidth="1in"/> - <colspec column="3" colwidth="4in"/> - <tbody> - - <row valign="top"> - <entry>"fg"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the foreground colors in each widget state.</entry> - </row> - - <row valign="top"> - <entry>"bg"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the background colors in each widget state.</entry> - </row> - - <row valign="top"> - <entry>"light"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the light colors in each widget state. The light colors are -slightly lighter than the bg colors and used for creating shadows.</entry> - </row> - - <row valign="top"> - <entry>"dark"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the dark colors in each widget state. The dark colors are slightly -darker than the bg colors and used for creating shadows.</entry> - </row> - - <row valign="top"> - <entry>"mid"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the mid colors (between light and dark) in each widget -state</entry> - </row> - - <row valign="top"> - <entry>"text"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the text colors in each widget state.</entry> - </row> - - <row valign="top"> - <entry>"base"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the base colors in each widget state.</entry> - </row> - - <row valign="top"> - <entry>"text_aa"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>s to be -used for the anti-aliased text colors in each widget state.</entry> - </row> - - <row valign="top"> - <entry>"black"</entry> - <entry>Read-Write</entry> - <entry>A <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link> that is -used for the black color.</entry> - </row> - - <row valign="top"> - <entry>"white"</entry> - <entry>Read-Write</entry> - <entry>A <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link> that is -used for the white color.</entry> - </row> - - <row valign="top"> - <entry>"font_desc"</entry> - <entry>Read</entry> - <entry>A <classname>pango.FontDescription</classname> used as -the default text font.</entry> - </row> - - <row valign="top"> - <entry>"xthickness"</entry> - <entry>Read</entry> - <entry>The thickness of lines drawn vertically.</entry> - </row> - - <row valign="top"> - <entry>"ythickness"</entry> - <entry>Read</entry> - <entry>The thickness of lines drawn horizontally.</entry> - </row> - - <row valign="top"> - <entry>"fg_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the fg colors.</entry> - </row> - - <row valign="top"> - <entry>"bg_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the bg colors.</entry> - </row> - - <row valign="top"> - <entry>"light_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the light colors.</entry> - </row> - - <row valign="top"> - <entry>"dark_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the dark colors.</entry> - </row> - - <row valign="top"> - <entry>"mid_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the mid colors.</entry> - </row> - - <row valign="top"> - <entry>"text_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the text colors.</entry> - </row> - - <row valign="top"> - <entry>"base_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the base colors.</entry> - </row> - - <row valign="top"> - <entry>"text_aa_gc"</entry> - <entry>Read</entry> - <entry>An array of graphics contexts (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the anti-aliased text colors.</entry> - </row> - - <row valign="top"> - <entry>"black_gc"</entry> - <entry>Read-Write</entry> - <entry>A graphics context (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the black color.</entry> - </row> - - <row valign="top"> - <entry>"white_gc"</entry> - <entry>Read-Write</entry> - <entry>A graphics context (<link -linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link>) for drawing -using the white color.</entry> - </row> - - <row valign="top"> - <entry>"bg_pixmap"</entry> - <entry>Read</entry> - <entry>An array of <link -linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link> to -be used for the background stippling in each widget state.</entry> - </row> - - </tbody> - </tgroup> - </informaltable> - </blockquote> - - </refsect1> - - <refsect1 id="signal-prototypes-gtkstyle"> - <title>gtk.Style Signal Prototypes</title> - - <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para> - - <variablelist> - <varlistentry> - <term>"<link linkend="signal-gtkstyle--realize">realize</link></term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>style</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtkstyle--unrealize">unrealize</link></term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>style</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - </variablelist> - - </refsect1> - - <refsect1> - <title>Description</title> - - <para>A <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> object -encapsulates the information that provides the look and feel for a widget. -Each <link -linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> has an -associated <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> object that -is used when rendering that widget. Usually the <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> for a -widget is the same as the default style that is set by GTK and modified the -theme engine. A <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> holds -information for the five possible widget states though not every widget -supports all five states:</para> - - <variablelist> - <varlistentry> - <term><literal>gtk.STATE_NORMAL</literal></term> - <listitem> - <simpara>The state of a sensitive widget that is not active and -does not have the focus</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.STATE_ACTIVE</literal></term> - <listitem> - <simpara>The state of a sensitive widget when it is active e.g. a -button that is pressed but not yet released</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.STATE_PRELIGHT</literal></term> - <listitem> - <simpara>The state of a sensitive widget that has the focus e.g. a -button that has the mouse pointer over it.</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.STATE_SELECTED</literal></term> - <listitem> - <simpara>The state of a widget that is selected e.g. selected text -in a <link linkend="class-gtkentry"><classname>gtk.Entry</classname></link> -widget</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.STATE_INSENSITIVE</literal></term> - <listitem> - <simpara>The state of a widget that is insensitive and will not -respond to any events e.g. cannot be activated, selected or -prelit.</simpara> - </listitem> - </varlistentry> - </variablelist> - - <para>A <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> contains -the read-only attributes described in the above <link -linkend="attributes-gtkstyle">section</link>.</para> - - <para>Usually applications should not need to use or modify the <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> of their -widgets.</para> - - </refsect1> - - <refsect1 id="constructor-gtkstyle"> - <title>Constructor</title> - - <programlisting><constructorsynopsis language="python"> - <methodname>gtk.Style</methodname> - <methodparam></methodparam> </constructorsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a new <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> -object</simpara></listitem> - </varlistentry> - </variablelist> - - <para>Creates a new <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> -object.</para> - - </refsect1> - - <refsect1> - <title>Methods</title> - - <refsect2 id="method-gtkstyle--copy"> - <title>gtk.Style.copy</title> - - <programlisting><methodsynopsis language="python"> - <methodname>copy</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a copy of the <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> -object</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>copy</methodname>() method returns a copy of the -style object.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--attach"> - <title>gtk.Style.attach</title> - - <programlisting><methodsynopsis language="python"> - <methodname>attach</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtkwindow"><classname>gtk.Window</classname></link>.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> -object</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>attach</methodname>() method adapts a style to -the specified <parameter>window</parameter>. This process allocates the -colors and creates the graphics contexts for the style specializing them to -a particular visual and colormap. A new <link -linkend="class-gtkstyle"><classname>gtk.Style</classname></link> may be -created if the style has already been adapted to a window with a different -style and colormap.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--detach"> - <title>gtk.Style.detach</title> - - <programlisting><methodsynopsis language="python"> - <methodname>detach</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - - <para>The <methodname>detach</methodname>() method detaches the style and frees its resources if it is no longer attached.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--set-background"> - <title>gtk.Style.set_background</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_background</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_background</methodname>() method sets the -background of <parameter>window</parameter> to the background color or -pixmap of the style for the widget state specified by -<parameter>state_type</parameter>.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--apply-default-background"> - <title>gtk.Style.apply_default_background</title> - - <programlisting><methodsynopsis language="python"> - <methodname>apply_default_background</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">set_bg</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">set_bg</parameter> :</term> - <listitem><simpara>if <literal>True</literal> use the bg_pixmap -for the widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>the widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>the clipping area</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>apply_default_background</methodname>() method -sets the background of the specified <parameter>window</parameter> in the -area specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. The -background color is derived from the bg_gc of the style with the state -specified by <parameter>state_type</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping area for the application of the background.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--lookup-icon-set"> - <title>gtk.Style.lookup_icon_set</title> - - <programlisting><methodsynopsis language="python"> - <methodname>lookup_icon_set</methodname> - <methodparam><parameter - role="keyword">stock_id</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">stock_id</parameter> :</term> - <listitem><simpara>a stock ID</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gtkiconset"><classname>gtk.IconSet</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>lookup_icon_set</methodname>() method looks in -the <link -linkend="class-gtkiconfactory"><classname>gtk.IconFactory</classname></link> -list associated with the style and the default icon factory for the stock -icon specified by <parameter>stock_id</parameter>. If the stock icon iconset -is found it is returned.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--render-icon"> - <title>gtk.Style.render_icon</title> - - <programlisting><methodsynopsis language="python"> - <methodname>render_icon</methodname> - <methodparam><parameter - role="keyword">source</parameter></methodparam> - <methodparam><parameter - role="keyword">direction</parameter></methodparam> - <methodparam><parameter - role="keyword">state</parameter></methodparam> - <methodparam><parameter - role="keyword">size</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter> - <initializer>None</initializer></methodparam> - <methodparam><parameter - role="keyword">detail</parameter> - <initializer>None</initializer></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">source</parameter> :</term> - <listitem><simpara>the <link -linkend="class-gtkiconsource"><classname>gtk.IconSource</classname></link> -specifying the icon to render</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">direction</parameter> :</term> - <listitem><simpara>a text direction</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">state</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">size</parameter> :</term> - <listitem><simpara>the size to render the icon at. A size of -1 -means render at the size of the source and don't scale.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a style detail</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>render_icon</methodname>() method renders the -icon specified by <parameter>source</parameter> at the specified -<parameter>size</parameter> for the specified widget -<parameter>state</parameter> according to the given parameters and returns -the result in a <link -linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link>.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-hline"> - <title>gtk.Style.paint_hline</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_hline</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">x1</parameter></methodparam> - <methodparam><parameter - role="keyword">x2</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>the rectangle that clips the -output</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x1</parameter> :</term> - <listitem><simpara>the starting x coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x2</parameter> :</term> - <listitem><simpara>the ending x coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y coordinate</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_hline</methodname>() method draws a -horizontal line from (<parameter>x1</parameter>, <parameter>y</parameter>) -to (<parameter>x2</parameter>, <parameter>y</parameter>) in -<parameter>window</parameter> using the specified -<parameter>state_type</parameter> of the style. If -<parameter>area</parameter> is not <literal>None</literal> the line is -clipped by the rectangle specified by <parameter>area</parameter>.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-vline"> - <title>gtk.Style.paint_vline</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_vline</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">y1</parameter></methodparam> - <methodparam><parameter - role="keyword">y2</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>the rectangle to which the output is -clipped</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y1</parameter> :</term> - <listitem><simpara>the starting y coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y2</parameter> :</term> - <listitem><simpara>the ending y coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x coordinate</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_vline</methodname>() method draws a -vertical line from (<parameter>x</parameter>, <parameter>y1</parameter>) to -(<parameter>x</parameter>, <parameter>y2</parameter>) in -<parameter>window</parameter> using the specified -<parameter>state_type</parameter> of the style. If -<parameter>area</parameter> is not <literal>None</literal> the line is -clipped by the rectangle specified by <parameter>area</parameter>.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-shadow"> - <title>gtk.Style.paint_shadow</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_shadow</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link - linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link>*</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a type of shadow - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>the rectangle to which the output is -clipped</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_shadow</methodname>() method draws a -shadow of the specified <parameter>shadow_type</parameter> on the specified -<parameter>window</parameter> with the size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> the shadow is -clipped to the rectangle' area. <parameter>state_type</parameter> specifies -the style state to use for drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-polygon"> - <title>gtk.Style.paint_polygon</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_polygon</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">points</parameter></methodparam> - <methodparam><parameter - role="keyword">fill</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">points</parameter> :</term> - <listitem><simpara>a list or tuple containing point (x, y) -tuples</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">fill</parameter> :</term> - <listitem><simpara>if <literal>True</literal> the polygon should -be filled</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_polygon</methodname>() method draws a -polygon on the specified <parameter>window</parameter> with the shadow type -specified by <parameter>shadow_type</parameter> connecting the points -specified by <parameter>points</parameter>. If <parameter>area</parameter> -is not <literal>None</literal> it specifies a clipping rectangle. The style -state specified by <parameter>state_type</parameter> determines the graphics -context to use while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-arrow"> - <title>gtk.Style.paint_arrow</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_arrow</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">arrow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">fill</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>the widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">arrow_type</parameter> :</term> - <listitem><simpara>an arrow type - one of: -<literal>gtk.ARROW_UP</literal>, <literal>gtk.ARROW_DOWN</literal>, -<literal>gtk.ARROW_LEFT</literal>, -<literal>gtk.ARROW_RIGHT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">fill</parameter> :</term> - <listitem><simpara>if <literal>True</literal> the arrow should be -filled</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The<methodname> paint_arrow</methodname>() method draws an arrow -of the type specified by <parameter>arrow_type</parameter> on the specified -<parameter>window</parameter> with the shadow type specified by -<parameter>shadow_type</parameter> with the location and size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-diamond"> - <title>gtk.Style.paint_diamond</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_diamond</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_diamond</methodname>() method draws a -diamond on the specified <parameter>window</parameter> with the shadow type -specified by <parameter>shadow_type</parameter> and the location and size -specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-box"> - <title>gtk.Style.paint_box</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_box</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_box</methodname>() method draws a box on -the specified <parameter>window</parameter> with the shadow type specified -by <parameter>shadow_type</parameter> and the location and size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-flat-box"> - <title>gtk.Style.paint_flat_box</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_flat_box</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_flat_box</methodname>() method draws a -flat box (no shadow) on the specified <parameter>window</parameter> with -the location and size specified by <parameter>x</parameter>, -<parameter>y</parameter>, <parameter>width</parameter> and -<parameter>height</parameter>. If <parameter>area</parameter> is not -<literal>None</literal> it specifies a clipping rectangle. The style state -specified by <parameter>state_type</parameter> determines the graphics -context to use while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-check"> - <title>gtk.Style.paint_check</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_check</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_check</methodname>() method draws a check -on the specified <parameter>window</parameter> with the shadow type -specified by <parameter>shadow_type</parameter> and the location and size -specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-option"> - <title>gtk.Style.paint_option</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_option</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_option</methodname>() method draws an -option menu item on the specified <parameter>window</parameter> with the -shadow type specified by <parameter>shadow_type</parameter> and the location -and size specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-tab"> - <title>gtk.Style.paint_tab</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_tab</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_tab</methodname>() method draws a tab on -the specified <parameter>window</parameter> with the shadow type specified -by <parameter>shadow_type</parameter> and the location and size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-shadow-gap"> - <title>gtk.Style.paint_shadow_gap</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_shadow_gap</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_side</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_x</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_width</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">gap_side</parameter> :</term> - <listitem><simpara>a position - one of: -<literal>gtk.POS_LEFT</literal>, <literal>gtk.POS_RIGHT</literal>, -<literal>gtk.POS_TOP</literal>, -<literal>gtk.POS_BOTTOM</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">gap_x</parameter> :</term> - <listitem><simpara>the x position of the gap</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">gap_width</parameter> :</term> - <listitem><simpara>the gap width</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_shadow_gap</methodname>() method draws a -shadow with a gap on the specified <parameter>window</parameter> with the -shadow type specified by <parameter>shadow_type</parameter> and the location -and size specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. The gap -position and width is specified by <parameter>gap_side</parameter>, -<parameter>gap_x</parameter> and <parameter>gap_width</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-box-gap"> - <title>gtk.Style.paint_box_gap</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_box_gap</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_side</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_x</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_width</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">gap_side</parameter> :</term> - <listitem><simpara>a position - one of: -<literal>gtk.POS_LEFT</literal>, <literal>gtk.POS_RIGHT</literal>, -<literal>gtk.POS_TOP</literal>, -<literal>gtk.POS_BOTTOM</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">gap_x</parameter> :</term> - <listitem><simpara>the x position of the gap</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">gap_width</parameter> :</term> - <listitem><simpara>the gap width</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_box_gap</methodname>() method draws a box -with a gap on the specified <parameter>window</parameter> with the shadow -type specified by <parameter>shadow_type</parameter> and the location and -size specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. The gap -position and width is specified by <parameter>gap_side</parameter>, -<parameter>gap_x</parameter> and <parameter>gap_width</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-extension"> - <title>gtk.Style.paint_extension</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_extension</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">gap_side</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">gap_side</parameter> :</term> - <listitem><simpara>a position - one of: -<literal>gtk.POS_LEFT</literal>, <literal>gtk.POS_RIGHT</literal>, -<literal>gtk.POS_TOP</literal>, -<literal>gtk.POS_BOTTOM</literal></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_extension</methodname>() method draws an -extension on the specified <parameter>window</parameter> with the shadow -type specified by <parameter>shadow_type</parameter> and the location and -size specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. The -extension position is specified by <parameter>gap_side</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-focus"> - <title>gtk.Style.paint_focus</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_focus</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_focus</methodname>() method draws a focus -indicator on the specified <parameter>window</parameter> with the location -and size specified by <parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-slider"> - <title>gtk.Style.paint_slider</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_slider</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">orientation</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">orientation</parameter> :</term> - <listitem><simpara>a position - one of: -<literal>gtk.ORIENTATION_HORIZONTAL</literal> or -<literal>gtk.ORIENTATION_VERTICAL</literal></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_slider</methodname>() method draws a -slider with the specified <parameter>orientation</parameter> on the -specified <parameter>window</parameter> with the shadow type specified by -<parameter>shadow_type</parameter> and the location and size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-handle"> - <title>gtk.Style.paint_handle</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_handle</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">shadow_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - <methodparam><parameter - role="keyword">orientation</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">shadow_type</parameter> :</term> - <listitem><simpara>a shadow type - one of: -<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>, -<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>, -<literal>gtk.SHADOW_ETCHED_OUT</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">orientation</parameter> :</term> - <listitem><simpara>a position - one of: -<literal>gtk.ORIENTATION_HORIZONTAL</literal> or -<literal>gtk.ORIENTATION_VERTICAL</literal></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_handle</methodname>() method draws a -handle with the specified <parameter>orientation</parameter> on the -specified <parameter>window</parameter> with the shadow type specified by -<parameter>shadow_type</parameter> and the location and size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-expander"> - <title>gtk.Style.paint_expander</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_expander</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">expander_style</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">expander_style</parameter> :</term> - <listitem><simpara>an expander style - one of: -<literal>gtk.EXPANDER_COLLAPSED</literal>, -<literal>gtk.EXPANDER_SEMI_COLLAPSED</literal>, -<literal>gtk.EXPANDER_SEMI_EXPANDED</literal> or -<literal>gtk.EXPANDER_EXPANDED</literal></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_expander</methodname>() method draws an -expander with the specified <parameter>expander_style</parameter> on the -specified <parameter>window</parameter> at the location specified by -<parameter>x</parameter>, <parameter>y</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-layout"> - <title>gtk.Style.paint_layout</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_layout</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">use_text</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">layout</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">use_text</parameter> :</term> - <listitem><simpara>if <literal>True</literal> use the text -graphics context for drawing</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">layout</parameter> :</term> - <listitem><simpara>a <classname>Pango.Layout</classname> object -containing the text to display</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_layout</methodname>() method draws the -text in a <classname>pango.Layout</classname> specified by -<parameter>layout</parameter> on the specified <parameter>window</parameter> -at the location specified by <parameter>x</parameter> and -<parameter>y</parameter>. If text is <literal>True</literal> use the text -graphics context of the style for drawing, otherwise use the fg graphics -context. If <parameter>area</parameter> is not <literal>None</literal> it -specifies a clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing.</para> - - </refsect2> - - <refsect2 id="method-gtkstyle--paint-resize-grip"> - <title>gtk.Style.paint_resize_grip</title> - - <programlisting><methodsynopsis language="python"> - <methodname>paint_resize_grip</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - <methodparam><parameter - role="keyword">state_type</parameter></methodparam> - <methodparam><parameter - role="keyword">area</parameter></methodparam> - <methodparam><parameter - role="keyword">widget</parameter></methodparam> - <methodparam><parameter - role="keyword">detail</parameter></methodparam> - <methodparam><parameter - role="keyword">edge</parameter></methodparam> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - <methodparam><parameter - role="keyword">width</parameter></methodparam> - <methodparam><parameter - role="keyword">height</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">state_type</parameter> :</term> - <listitem><simpara>a widget state</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">area</parameter> :</term> - <listitem><simpara>a clipping rectangle</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">widget</parameter> :</term> - <listitem><simpara>a widget</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">detail</parameter> :</term> - <listitem><simpara>a detail string</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">edge</parameter> :</term> - <listitem><simpara>the edge in which to draw the resize grip, -currently only <literal>gtk.WINDOW_EDGE_SOUTH_EAST</literal> is -implemented</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>the x location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>the y location</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">width</parameter> :</term> - <listitem><simpara>the width</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">height</parameter> :</term> - <listitem><simpara>the height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>paint_resize_grip</methodname>() method draws a -resize grip at the specified <parameter>edge</parameter> on the specified -<parameter>window</parameter> with the location and size specified by -<parameter>x</parameter>, <parameter>y</parameter>, -<parameter>width</parameter> and <parameter>height</parameter>. If -<parameter>area</parameter> is not <literal>None</literal> it specifies a -clipping rectangle. The widget state specified by -<parameter>state_type</parameter> determines the graphics context to use -while drawing. Currently the grip can only be drawn at the -<literal>gtk.WINDOW_EDGE_SOUTH_EAST</literal> (lower right) edge.</para> - - </refsect2> - - </refsect1> - - <refsect1> - <title>Signals</title> - - <refsect2 id="signal-gtkstyle--realize"> - <title>The "realize" gtk.Style Signal</title> - - <programlisting><methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>style</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>style</parameter> :</term> - <listitem><simpara>the object which received the - signal.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified - with the <link - linkend="method-gobject--connect"><methodname>connect</methodname>()</link> - method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if any)</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This signal is available in GTK+ 2.4 and above.</para> - </note> - - <para>Emitted when the style has been initialized for a particular - colormap and depth. Connecting to this signal is probably seldom - useful since most of the time applications and widgets only deal with - styles that have been already realized.</para> - - </refsect2> - - <refsect2 id="signal-gtkstyle--unrealize"> - <title>The "unrealize" gtk.Style Signal</title> - - <programlisting><methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>style</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>style</parameter> :</term> - <listitem><simpara>the object which received the - signal.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified - with the <link - linkend="method-gobject--connect"><methodname>connect</methodname>()</link> - method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if any)</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This signal is available in GTK+ 2.4 and above.</para> - </note> - - <para>Emitted when the aspects of the style specific to a particular - colormap and depth are being cleaned up. A connection to this signal - can be useful if a widget wants to cache objects like a <link - linkend="class-gdkgc"><classname>gtk.gdk.GC</classname></link> as - object data on <link - linkend="class-gtkstyle"><classname>gtk.Style</classname></link>. - This signal provides a convenient place to free such cached - objects.</para> - - </refsect2> - -</refsect1> - -</refentry> |