/usr/share/gtk-doc/html/pygtk/class-gtkwidget.html

<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Widget</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkviewport.html" title="gtk.Viewport"><link rel="next" href="class-gtkwindow.html" title="gtk.Window"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.Widget</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkviewport.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkwindow.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.Widget"><a name="class-gtkwidget"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Widget</h2><p>gtk.Widget — the base class for all <code class="literal">PyGTK</code>
widgets</p></div><div class="refsect1" title="Synopsis"><a name="id4076264"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Widget</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a></span></span>):
<code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-allocation" title="gtk.Widget.set_allocation">set_allocation</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>allocation</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-allocation" title="gtk.Widget.get_allocation">get_allocation</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-check-threshold" title="gtk.Widget.drag_check_threshold">drag_check_threshold</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>current_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>current_y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-get-data" title="gtk.Widget.drag_get_data">drag_get_data</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>context</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span><span class="initializer">=0L</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-highlight" title="gtk.Widget.drag_highlight">drag_highlight</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-unhighlight" title="gtk.Widget.drag_unhighlight">drag_unhighlight</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-set" title="gtk.Widget.drag_dest_set">drag_dest_set</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>flags</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-set-proxy" title="gtk.Widget.drag_dest_set_proxy">drag_dest_set_proxy</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>proxy_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>protocol</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>use_coordinates</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-unset" title="gtk.Widget.drag_dest_unset">drag_dest_unset</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-find-target" title="gtk.Widget.drag_dest_find_target">drag_dest_find_target</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>context</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target_list</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-get-target-list" title="gtk.Widget.drag_dest_get_target_list">drag_dest_get_target_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-set-target-list" title="gtk.Widget.drag_dest_set_target_list">drag_dest_set_target_list</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>target_list</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-add-image-targets" title="gtk.Widget.drag_dest_add_image_targets">drag_dest_add_image_targets</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-add-text-targets" title="gtk.Widget.drag_dest_add_text_targets">drag_dest_add_text_targets</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-add-uri-targets" title="gtk.Widget.drag_dest_add_uri_targets">drag_dest_add_uri_targets</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set" title="gtk.Widget.drag_source_set">drag_source_set</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_button_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-unset" title="gtk.Widget.drag_source_unset">drag_source_unset</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-icon" title="gtk.Widget.drag_source_set_icon">drag_source_set_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixmap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>mask</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-icon-pixbuf" title="gtk.Widget.drag_source_set_icon_pixbuf">drag_source_set_icon_pixbuf</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixbuf</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-icon-stock" title="gtk.Widget.drag_source_set_icon_stock">drag_source_set_icon_stock</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stock_id</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-icon-name" title="gtk.Widget.drag_source_set_icon_name">drag_source_set_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon_name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-add-text-targets" title="gtk.Widget.drag_source_add_text_targets">drag_source_add_text_targets</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-add-image-targets" title="gtk.Widget.drag_source_add_image_targets">drag_source_add_image_targets</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-add-uri-targets" title="gtk.Widget.drag_source_add_uri_targets">drag_source_add_uri_targets</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-begin" title="gtk.Widget.drag_begin">drag_begin</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>button</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-add" title="gtk.Widget.grab_add">grab_add</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-remove" title="gtk.Widget.grab_remove">grab_remove</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--rc-get-style" title="gtk.Widget.rc_get_style">rc_get_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--selection-owner-set" title="gtk.Widget.selection_owner_set">selection_owner_set</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span><span class="initializer">=0L</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--selection-add-target" title="gtk.Widget.selection_add_target">selection_add_target</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>info</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--selection-add-targets" title="gtk.Widget.selection_add_targets">selection_add_targets</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--selection-clear-targets" title="gtk.Widget.selection_clear_targets">selection_clear_targets</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--selection-convert" title="gtk.Widget.selection_convert">selection_convert</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span><span class="initializer">=0L</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--selection-remove-all" title="gtk.Widget.selection_remove_all">selection_remove_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--destroy" title="gtk.Widget.destroy">destroy</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--unparent" title="gtk.Widget.unparent">unparent</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show">show</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--show-now" title="gtk.Widget.show_now">show_now</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--hide" title="gtk.Widget.hide">hide</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--show-all" title="gtk.Widget.show_all">show_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--hide-all" title="gtk.Widget.hide_all">hide_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-no-show-all" title="gtk.Widget.set_no_show_all">set_no_show_all</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>no_show_all</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-no-show-all" title="gtk.Widget.get_no_show_all">get_no_show_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--map" title="gtk.Widget.map">map</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--unmap" title="gtk.Widget.unmap">unmap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--realize" title="gtk.Widget.realize">realize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--unrealize" title="gtk.Widget.unrealize">unrealize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-draw" title="gtk.Widget.queue_draw">queue_draw</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-draw-area" title="gtk.Widget.queue_draw_area">queue_draw_area</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-resize" title="gtk.Widget.queue_resize">queue_resize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-resize-no-redraw" title="gtk.Widget.queue_resize_no_redraw">queue_resize_no_redraw</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--size-request" title="gtk.Widget.size_request">size_request</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--size-allocate" title="gtk.Widget.size_allocate">size_allocate</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>allocation</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-child-requisition" title="gtk.Widget.get_child_requisition">get_child_requisition</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--add-accelerator" title="gtk.Widget.add_accelerator">add_accelerator</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_signal</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_key</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_mods</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_flags</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--remove-accelerator" title="gtk.Widget.remove_accelerator">remove_accelerator</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_key</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_mods</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-accel-path" title="gtk.Widget.set_accel_path">set_accel_path</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--can-activate-accel" title="gtk.Widget.can_activate_accel">can_activate_accel</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>signal_id</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--mnemonic-activate" title="gtk.Widget.mnemonic_activate">mnemonic_activate</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>group_cycling</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--event" title="gtk.Widget.event">event</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--send-expose" title="gtk.Widget.send_expose">send_expose</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--activate" title="gtk.Widget.activate">activate</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-scroll-adjustments" title="gtk.Widget.set_scroll_adjustments">set_scroll_adjustments</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hadjustment</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>vadjustment</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--reparent" title="gtk.Widget.reparent">reparent</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_parent</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--intersect" title="gtk.Widget.intersect">intersect</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>area</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--region-intersect" title="gtk.Widget.region_intersect">region_intersect</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>region</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--freeze-child-notify" title="gtk.Widget.freeze_child_notify">freeze_child_notify</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--child-notify" title="gtk.Widget.child_notify">child_notify</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_property</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--thaw-child-notify" title="gtk.Widget.thaw_child_notify">thaw_child_notify</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-focus" title="gtk.Widget.is_focus">is_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus">grab_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-default" title="gtk.Widget.grab_default">grab_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-name" title="gtk.Widget.set_name">set_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-name" title="gtk.Widget.get_name">get_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-state" title="gtk.Widget.set_state">set_state</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-sensitive" title="gtk.Widget.set_sensitive">set_sensitive</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sensitive</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-app-paintable" title="gtk.Widget.set_app_paintable">set_app_paintable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>app_paintable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-double-buffered" title="gtk.Widget.set_double_buffered">set_double_buffered</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>double_buffered</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-redraw-on-allocate" title="gtk.Widget.set_redraw_on_allocate">set_redraw_on_allocate</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>redraw_on_allocate</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-parent" title="gtk.Widget.set_parent">set_parent</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-parent-window" title="gtk.Widget.set_parent_window">set_parent_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent_window</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-child-visible" title="gtk.Widget.set_child_visible">set_child_visible</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_visible</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-child-visible" title="gtk.Widget.get_child_visible">get_child_visible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-parent" title="gtk.Widget.get_parent">get_parent</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-parent-window" title="gtk.Widget.get_parent_window">get_parent_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--child-focus" title="gtk.Widget.child_focus">child_focus</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>direction</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-size-request" title="gtk.Widget.set_size_request">set_size_request</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-size-request" title="gtk.Widget.get_size_request">get_size_request</a></span>()</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-events" title="gtk.Widget.set_events">set_events</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>events</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--add-events" title="gtk.Widget.add_events">add_events</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>events</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-extension-events" title="gtk.Widget.set_extension_events">set_extension_events</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mode</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-extension-events" title="gtk.Widget.get_extension_events">get_extension_events</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-toplevel" title="gtk.Widget.get_toplevel">get_toplevel</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-ancestor" title="gtk.Widget.get_ancestor">get_ancestor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_type</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-colormap" title="gtk.Widget.get_colormap">get_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-visual" title="gtk.Widget.get_visual">get_visual</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-screen" title="gtk.Widget.get_screen">get_screen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--has-screen" title="gtk.Widget.has_screen">has_screen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-display" title="gtk.Widget.get_display">get_display</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-root-window" title="gtk.Widget.get_root_window">get_root_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-settings" title="gtk.Widget.get_settings">get_settings</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-clipboard" title="gtk.Widget.get_clipboard">get_clipboard</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-accessible" title="gtk.Widget.get_accessible">get_accessible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-colormap" title="gtk.Widget.set_colormap">set_colormap</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-events" title="gtk.Widget.get_events">get_events</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-pointer" title="gtk.Widget.get_pointer">get_pointer</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-ancestor" title="gtk.Widget.is_ancestor">is_ancestor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>ancestor</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--translate-coordinates" title="gtk.Widget.translate_coordinates">translate_coordinates</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dest_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>src_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>src_y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--hide-on-delete" title="gtk.Widget.hide_on_delete">hide_on_delete</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-style" title="gtk.Widget.set_style">set_style</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--ensure-style" title="gtk.Widget.ensure_style">ensure_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-style" title="gtk.Widget.get_style">get_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-style" title="gtk.Widget.modify_style">modify_style</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-modifier-style" title="gtk.Widget.get_modifier_style">get_modifier_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-fg" title="gtk.Widget.modify_fg">modify_fg</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-bg" title="gtk.Widget.modify_bg">modify_bg</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-text" title="gtk.Widget.modify_text">modify_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-base" title="gtk.Widget.modify_base">modify_base</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-font" title="gtk.Widget.modify_font">modify_font</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>font_desc</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--create-pango-context" title="gtk.Widget.create_pango_context">create_pango_context</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-pango-context" title="gtk.Widget.get_pango_context">get_pango_context</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--create-pango-layout" title="gtk.Widget.create_pango_layout">create_pango_layout</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--render-icon" title="gtk.Widget.render_icon">render_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stock_id</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>detail</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-composite-name" title="gtk.Widget.set_composite_name">set_composite_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-composite-name" title="gtk.Widget.get_composite_name">get_composite_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--reset-rc-styles" title="gtk.Widget.reset_rc_styles">reset_rc_styles</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--style-get-property" title="gtk.Widget.style_get_property">style_get_property</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>property_name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-direction" title="gtk.Widget.set_direction">set_direction</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dir</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-direction" title="gtk.Widget.get_direction">get_direction</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--shape-combine-mask" title="gtk.Widget.shape_combine_mask">shape_combine_mask</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>shape_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--reset-shapes" title="gtk.Widget.reset_shapes">reset_shapes</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--path" title="gtk.Widget.path">path</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--class-path" title="gtk.Widget.class_path">class_path</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--list-mnemonic-labels" title="gtk.Widget.list_mnemonic_labels">list_mnemonic_labels</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--add-mnemonic-label" title="gtk.Widget.add_mnemonic_label">add_mnemonic_label</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>label</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--remove-mnemonic-label" title="gtk.Widget.remove_mnemonic_label">remove_mnemonic_label</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>label</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--menu-get-for-attach-widget" title="gtk.Widget.menu_get_for_attach_widget">menu_get_for_attach_widget</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-activate-signal" title="gtk.Widget.set_activate_signal">set_activate_signal</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>signal_name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-set-scroll-adjustments-signal" title="gtk.Widget.set_set_scroll_adjustments_signal">set_set_scroll_adjustments_signal</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>signal_name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-action" title="gtk.Widget.get_action">get_action</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-set-track-motion" title="gtk.Widget.drag_dest_set_track_motion">drag_dest_set_track_motion</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>track_motion</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-get-track-motion" title="gtk.Widget.drag_dest_get_track_motion">drag_dest_get_track_motion</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-composited" title="gtk.Widget.is_composited">is_composited</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--input-shape-combine-mask" title="gtk.Widget.input_shape_combine_mask">input_shape_combine_mask</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>shape_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-activate-signal" title="gtk.Widget.get_activate_signal">get_activate_signal</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--error-bell" title="gtk.Widget.error_bell">error_bell</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-has-tooltip" title="gtk.Widget.get_has_tooltip">get_has_tooltip</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-tooltip-markup" title="gtk.Widget.get_tooltip_markup">get_tooltip_markup</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-tooltip-text" title="gtk.Widget.get_tooltip_text">get_tooltip_text</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-tooltip-window" title="gtk.Widget.get_tooltip_window">get_tooltip_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--keynav-failed" title="gtk.Widget.keynav_failed">keynav_failed</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>direction</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-cursor" title="gtk.Widget.modify_cursor">modify_cursor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>primary</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>secondary</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-has-tooltip" title="gtk.Widget.set_has_tooltip">set_has_tooltip</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>has_tooltip</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-tooltip-markup" title="gtk.Widget.set_tooltip_markup">set_tooltip_markup</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>markup</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-tooltip-text" title="gtk.Widget.set_tooltip_text">set_tooltip_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-tooltip-window" title="gtk.Widget.set_tooltip_window">set_tooltip_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--trigger-tooltip-query" title="gtk.Widget.trigger_tooltip_query">trigger_tooltip_query</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-snapshot" title="gtk.Widget.get_snapshot">get_snapshot</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clip_rect</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-window" title="gtk.Widget.get_window">get_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--send-focus-change" title="gtk.Widget.send_focus_change">send_focus_change</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-realized" title="gtk.Widget.set_realized">set_realized</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>realized</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-realized" title="gtk.Widget.get_realized">get_realized</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-mapped" title="gtk.Widget.set_mapped">set_mapped</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mapped</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-mapped" title="gtk.Widget.get_mapped">get_mapped</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-requisition" title="gtk.Widget.get_requisition">get_requisition</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--style-attach" title="gtk.Widget.style_attach">style_attach</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--has-rc-style" title="gtk.Widget.has_rc_style">has_rc_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-app-paintable" title="gtk.Widget.get_app_paintable">get_app_paintable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-can-default" title="gtk.Widget.set_can_default">set_can_default</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>can_default</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-can-default" title="gtk.Widget.get_can_default">get_can_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-can-focus" title="gtk.Widget.set_can_focus">set_can_focus</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>can_focus</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-can-focus" title="gtk.Widget.get_can_focus">get_can_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-double-buffered" title="gtk.Widget.get_double_buffered">get_double_buffered</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-has-window" title="gtk.Widget.set_has_window">set_has_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>has_window</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-has-window" title="gtk.Widget.get_has_window">get_has_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-receives-default" title="gtk.Widget.set_receives_default">set_receives_default</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>receives_default</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-receives-default" title="gtk.Widget.get_receives_default">get_receives_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-sensitive" title="gtk.Widget.get_sensitive">get_sensitive</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-state" title="gtk.Widget.get_state">get_state</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-visible" title="gtk.Widget.set_visible">set_visible</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>visible</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--get-visible" title="gtk.Widget.get_visible">get_visible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--set-window" title="gtk.Widget.set_window">set_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--has-default" title="gtk.Widget.has_default">has_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--has-focus" title="gtk.Widget.has_focus">has_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--has-grab" title="gtk.Widget.has_grab">has_grab</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-sensitive" title="gtk.Widget.is_sensitive">is_sensitive</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-toplevel" title="gtk.Widget.is_toplevel">is_toplevel</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-drawable" title="gtk.Widget.is_drawable">is_drawable</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table><pre class="programlisting">
<span class="bold"><strong>Functions</strong></span>

<code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-push-colormap" title="gtk.widget_push_colormap">gtk.widget_push_colormap</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cmap</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-push-composite-child" title="gtk.widget_push_composite_child">gtk.widget_push_composite_child</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-pop-composite-child" title="gtk.widget_pop_composite_child">gtk.widget_pop_composite_child</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-pop-colormap" title="gtk.widget_pop_colormap">gtk.widget_pop_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-get-default-style" title="gtk.widget_get_default_style">gtk.widget_get_default_style</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-set-default-colormap" title="gtk.widget_set_default_colormap">gtk.widget_set_default_colormap</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-get-default-colormap" title="gtk.widget_get_default_colormap">gtk.widget_get_default_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-get-default-visual" title="gtk.widget_get_default_visual">gtk.widget_get_default_visual</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-set-default-direction" title="gtk.widget_set_default_direction">gtk.widget_set_default_direction</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dir</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-get-default-direction" title="gtk.widget_get_default_direction">gtk.widget_get_default_direction</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-class-find-style-property" title="gtk.widget_class_find_style_property">gtk.widget_class_find_style_property</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>property_name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-class-list-style-properties" title="gtk.widget_class_list_style_properties">gtk.widget_class_list_style_properties</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwidget.html#function-gtk--widget-class-install-style-property" title="gtk.widget_class_install_style_property">gtk.widget_class_install_style_property</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pspec</code></strong></span></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id4081776"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
  +-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
    +-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id4081808"></a><h2>Implemented Interfaces</h2><p>
			<a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
			implements 
			<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
		</p></div><div class="refsect1" title="gtk.Widget Properties"><a name="properties-gtkwidget"></a><h2>gtk.Widget Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"app-paintable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the application will paint
directly on the widget</td></tr><tr valign="top"><td valign="top">"can-default"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget can be the
default widget</td></tr><tr valign="top"><td valign="top">"can-focus"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget can accept the
input focus</td></tr><tr valign="top"><td valign="top">"composite-child"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget is part of a
composite widget</td></tr><tr valign="top"><td valign="top">"double-buffered"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget is double buffered</td></tr><tr valign="top"><td valign="top">"events"</td><td valign="top">Read-Write</td><td valign="top">The event mask that decides what kind of <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a> this
widget gets.</td></tr><tr valign="top"><td valign="top">"extension-events"</td><td valign="top">Read-Write</td><td valign="top">The mask that decides what kind of extension events
this widget gets.</td></tr><tr valign="top"><td valign="top">"has-default"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget is the default
widget</td></tr><tr valign="top"><td valign="top">"has-focus"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget has the input
focus</td></tr><tr valign="top"><td valign="top">"has-tooltip"</td><td valign="top">Read-Write</td><td valign="top">Enables or disables the emission of GtkWidget::query-tooltip on widget.
          A value of <code class="literal">True</code> indicates that widget can have a tooltip,
          in this case the widget will be queried using GtkWidget::query-tooltip to
          determine whether it will provide a tooltip or not. Note that setting this
          property to <code class="literal">True</code> for the first time will change the event
          masks of the GdkWindows of this widget to include leave-notify and motion-notify events.
          This cannot and will not be undone when the property is set to <code class="literal">False</code> again.
          Default value: <code class="literal">False</code>.
          This property is available in GTK+ 2.12 and above.</td></tr><tr valign="top"><td valign="top">"height-request"</td><td valign="top">Read-Write</td><td valign="top">The height request of the widget, or -1 if natural
request should be used.</td></tr><tr valign="top"><td valign="top">"is-focus"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget is the focus
widget within the toplevel</td></tr><tr valign="top"><td valign="top">"name"</td><td valign="top">Read-Write</td><td valign="top">The name of the widget</td></tr><tr valign="top"><td valign="top">"no-show-all"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> <a class="link" href="class-gtkwidget.html#method-gtkwidget--show-all" title="gtk.Widget.show_all"><code class="methodname">show_all</code>()</a>
should not affect this widget. Available in GTK+ 2.4 and above.</td></tr><tr valign="top"><td valign="top">"parent"</td><td valign="top">Read-Write</td><td valign="top">The parent widget of this widget. Must be a <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>
widget.</td></tr><tr valign="top"><td valign="top">"receives-default"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget will receive the
default action when it is focused.</td></tr><tr valign="top"><td valign="top">"sensitive"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget responds to
input</td></tr><tr valign="top"><td valign="top">"style"</td><td valign="top">Read-Write</td><td valign="top">The style of the widget, which contains information
about how it will look (colors etc).</td></tr><tr valign="top"><td valign="top">"tooltip-markup"</td><td valign="top">Read-Write</td><td valign="top">Sets the text of tooltip to be the given string, which is marked up
          with the Pango text markup language. Also see 
          <code class="methodname"><a class="link" href="class-gtktooltip.html#method-gtktooltip--set-markup" title="gtk.Tooltip.set_markup">gtk.Tooltip.set_markup</a>().</code>
          This is a convenience property which will take care of getting the tooltip
          shown if the given string is not <code class="literal">None</code>: GtkWidget:has-tooltip
          will automatically be set to <code class="literal">True</code> and there will be taken
          care of GtkWidget::query-tooltip in the default signal handler.
          Default value: <code class="literal">None</code>
          This property is available in GTK+ 2.12 and above.</td></tr><tr valign="top"><td valign="top">"tooltip-text"</td><td valign="top">Read-Write</td><td valign="top">Sets the text of tooltip to be the given string. Also see
          <code class="methodname"><a class="link" href="class-gtktooltip.html#method-gtktooltip--set-markup" title="gtk.Tooltip.set_markup">gtk.Tooltip.set_text</a>().</code>
          This is a convenience property which will take care of getting the tooltip shown
          if the given string is not <code class="literal">None</code>: GtkWidget:has-tooltip will
          automatically be set to <code class="literal">None</code> and there will be taken care
          of GtkWidget::query-tooltip in the default signal handler.
          Default value: <code class="literal">None</code>.
          This property is available in GTK+ 2.12 and above.</td></tr><tr valign="top"><td valign="top">"visible"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the widget is
visible</td></tr><tr valign="top"><td valign="top">"width-request"</td><td valign="top">Read-Write</td><td valign="top">The width request of the widget, or -1 if natural
request should be used.</td></tr><tr valign="top"><td valign="top">"window"</td><td valign="top">Read</td><td valign="top">The widget's window if realized,
        <code class="literal">None</code> otherwise.
        This property is available in GTK+ 2.14 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Widget Style Properties"><a name="style-properties-gtkwidget"></a><h2>gtk.Widget Style Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"cursor-aspect-ratio"</td><td valign="top">Read</td><td valign="top">The aspect ratio with which to draw the insertion
cursor</td></tr><tr valign="top"><td valign="top">"cursor-color"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a> with
which to draw insertion cursor</td></tr><tr valign="top"><td valign="top">"draw-border"</td><td valign="top">Read</td><td valign="top">The "draw-border" property defines the size of areas
              outside the widget's allocation to draw. This property is
              available in GTK+ 2.8 and above.</td></tr><tr valign="top"><td valign="top">"focus-line-pattern"</td><td valign="top">Read-Write</td><td valign="top">The dash pattern used to draw the focus
indicator.</td></tr><tr valign="top"><td valign="top">"focus-line-width"</td><td valign="top">Read-Write</td><td valign="top">The width, in pixels, of the focus indicator
line.</td></tr><tr valign="top"><td valign="top">"focus-padding"</td><td valign="top">Read-Write</td><td valign="top">The width, in pixels, between the focus indicator and
the widget 'box'.</td></tr><tr valign="top"><td valign="top">"interior-focus"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, draw the focus indicator
inside widgets.</td></tr><tr valign="top"><td valign="top">"link-color"</td><td valign="top">Read</td><td valign="top">The "link-color" property defines the color of
              unvisited links.  This property is available in GTK+ 2.10 and
              above.</td></tr><tr valign="top"><td valign="top">"scroll-arrow-hlength"</td><td valign="top">Read</td><td valign="top">The "scroll-arrow-hlength" property defines the length
              of horizontal scroll arrows.  This property is available in
              GTK+ 2.10 and above.</td></tr><tr valign="top"><td valign="top">"scroll-arrow-vlength"</td><td valign="top">Read</td><td valign="top">The "scroll-arrow-vlength" property defines the length
              of vertical scroll arrows.  This property is available in GTK+
              2.10 and above.</td></tr><tr valign="top"><td valign="top">"secondary-cursor-color"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a> with
which to draw the secondary insertion cursor when editing mixed
right-to-left and left-to-right text.</td></tr><tr valign="top"><td valign="top">"separator-height"</td><td valign="top">Read</td><td valign="top">The "separator-height" property defines the height of
              separators.  This property only takes effect if
              "wide-separators" is <code class="literal">True</code>.  This property
              is available in GTK+ 2.10 and above.</td></tr><tr valign="top"><td valign="top">"separator-width"</td><td valign="top">Read</td><td valign="top">The "separator-width" property defines the width of
              separators.  This property only takes effect if
              "wide-separators" is <code class="literal">True</code>.  This property
              is available in GTK+ 2.10 and above.</td></tr><tr valign="top"><td valign="top">"visited-link-color"</td><td valign="top">Read</td><td valign="top">The "visited-link-color" property defines the color of
              visited links.  This property is available in GTK+ 2.10 and
              above.</td></tr><tr valign="top"><td valign="top">"wide-separators"</td><td valign="top">Read</td><td valign="top">The "wide-separators" property defines whether
              separators have configurable width and should be drawn using a
              box instead of a line.  This property is available in GTK+
              2.10 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="Attributes"><a name="id4082899"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table cellpadding="5" width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"allocation"</td><td valign="top">Read-Write</td><td valign="top">The <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
specifying the widget's space allocation. This attribute is writeable in
PyGTK 2.4.</td></tr><tr valign="top"><td valign="top">"name"</td><td valign="top">Read</td><td valign="top">The name of the widget</td></tr><tr valign="top"><td valign="top">"parent"</td><td valign="top">Read</td><td valign="top">The parent widget of this widget. Must be a <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>
widget.</td></tr><tr valign="top"><td valign="top">"saved_state"</td><td valign="top">Read</td><td valign="top">The widget's saved state.</td></tr><tr valign="top"><td valign="top">"state"</td><td valign="top">Read</td><td valign="top">The widget state: <code class="literal">gtk.STATE_NORMAL</code>,
<code class="literal">gtk.STATE_ACTIVE</code>, <code class="literal">gtk.STATE_PRELIGHT</code>,
<code class="literal">gtk.STATE_SELECTED</code> or
<code class="literal">gtk.STATE_INSENSITIVE</code></td></tr><tr valign="top"><td valign="top">"style"</td><td valign="top">Read</td><td valign="top">The style of the widget.</td></tr><tr valign="top"><td valign="top">"window"</td><td valign="top">Read-Write</td><td valign="top">The <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> used
by the widget. This attribute is writeable in PyGTK 2.4.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Widget Signal Prototypes"><a name="signal-prototypes-gtkwidget"></a><h2>gtk.Widget Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--accel-closures-changed" title='The "accel-closures-changed" gtk.Widget Signal'>accel-closures-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--button-press-event" title='The "button-press-event" gtk.Widget Signal'>button-press-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--button-release-event" title='The "button-release-event" gtk.Widget Signal'>button-release-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>signal_id</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--can-activate-accel" title='The "can-activate-accel" gtk.Widget Signal'>can-activate-accel</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--child-notify" title='The "child-notify" gtk.Widget Signal'>child-notify</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>child_property</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--composited-changed" title='The "composited-changed" gtk.Widget Signal'>composited-changed</a></span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--client-event" title='The "client-event" gtk.Widget Signal'>client-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--configure-event" title='The "configure-event" gtk.Widget Signal'>configure-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--damage-event" title='The "damage-event" gtk.Widget Signal'>damage-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--damage-event" title='The "damage-event" gtk.Widget Signal'>delete-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--delete-event" title='The "delete-event" gtk.Widget Signal'>delete-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--destroy-event" title='The "destroy-event" gtk.Widget Signal'>destroy-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--direction-changed" title='The "direction-changed" gtk.Widget Signal'>direction-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-begin" title='The "drag-begin" gtk.Widget Signal'>drag-begin</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-data-delete" title='The "drag-data-delete" gtk.Widget Signal'>drag-data-delete</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-data-get" title='The "drag-data-get" gtk.Widget Signal'>drag-data-get</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>info</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-data-received" title='The "drag-data-received" gtk.Widget Signal'>drag-data-received</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>info</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-drop" title='The "drag-drop" gtk.Widget Signal'>drag-drop</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-end" title='The "drag-end" gtk.Widget Signal'>drag-end</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-failed" title='The "drag-failed" gtk.Widget Signal'>drag-failed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>result</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-leave" title='The "drag-leave" gtk.Widget Signal'>drag-leave</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--drag-motion" title='The "drag-motion" gtk.Widget Signal'>drag-motion</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--enter-notify-event" title='The "enter-notify-event" gtk.Widget Signal'>enter-notify-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--event" title='The "event" gtk.Widget Signal'>event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--event-after" title='The "event-after" gtk.Widget Signal'>event-after</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--expose-event" title='The "expose-event" gtk.Widget Signal'>expose-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--focus" title='The "focus" gtk.Widget Signal'>focus</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--focus-in-event" title='The "focus-in-event" gtk.Widget Signal'>focus-in-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--focus-out-event" title='The "focus-out-event" gtk.Widget Signal'>focus-out-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--grab-broken-event" title='The "grab-broken-event" gtk.Widget Signal'>grab-broken-event</a></span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--grab-focus" title='The "grab-focus" gtk.Widget Signal'>grab-focus</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--grab-notify" title='The "grab-notify" gtk.Widget Signal'>grab-notify</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>was_grabbed</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--hide" title='The "hide" gtk.Widget Signal'>hide</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--hierarchy-changed" title='The "hierarchy-changed" gtk.Widget Signal'>hierarchy-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>previous_toplevel</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-press-event" title='The "key-press-event" gtk.Widget Signal'>key-press-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-release-event" title='The "key-release-event" gtk.Widget Signal'>key-release-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--keynav-failed" title='The "keynav-failed" gtk.Widget Signal'>keynav-failed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--leave-notify-event" title='The "leave-notify-event" gtk.Widget Signal'>leave-notify-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--map" title='The "map" gtk.Widget Signal'>map</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--map-event" title='The "map-event" gtk.Widget Signal'>map-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--mnemonic-activate" title='The "mnemonic-activate" gtk.Widget Signal'>mnemonic-activate</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>group_cycling</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--motion-notify-event" title='The "motion-notify-event" gtk.Widget Signal'>motion-notify-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--no-expose-event" title='The "no-expose-event" gtk.Widget Signal'>no-expose-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--parent-set" title='The "parent-set" gtk.Widget Signal'>parent-set</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>old_parent</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--popup-menu" title='The "popup-menu" gtk.Widget Signal'>popup-menu</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--property-notify-event" title='The "property-notify-event" gtk.Widget Signal'>property-notify-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--proximity-in-event" title='The "proximity-in-event" gtk.Widget Signal'>proximity-in-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--proximity-out-event" title='The "proximity-out-event" gtk.Widget Signal'>proximity-out-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--query-tooltip" title='The "query-tooltip" gtk.Widget Signal'>query-tooltip</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>keyboard_mode</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>tooltip</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--realize" title='The "realize" gtk.Widget Signal'>realize</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--screen-changed" title='The "screen-changed" gtk.Widget Signal'>screen-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>screen</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--scroll-event" title='The "scroll-event" gtk.Widget Signal'>scroll-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--selection-clear-event" title='The "selection-clear-event" gtk.Widget Signal'>selection-clear-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--selection-get" title='The "selection-get" gtk.Widget Signal'>selection-get</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>info</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--selection-notify-event" title='The "selection-notify-event" gtk.Widget Signal'>selection-notify-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--selection-received" title='The "selection-received" gtk.Widget Signal'>selection-received</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--selection-request-event" title='The "selection-request-event" gtk.Widget Signal'>selection-request-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--show" title='The "show" gtk.Widget Signal'>show</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--show-help" title='The "show-help" gtk.Widget Signal'>show-help</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>help_type</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--size-allocate" title='The "size-allocate" gtk.Widget Signal'>size-allocate</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>allocation</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--size-request" title='The "size-request" gtk.Widget Signal'>size-request</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>requisition</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--state-changed" title='The "state-changed" gtk.Widget Signal'>state-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>state</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--style-set" title='The "style-set" gtk.Widget Signal'>style-set</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>previous_style</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--unmap" title='The "unmap" gtk.Widget Signal'>unmap</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--unmap-event" title='The "unmap-event" gtk.Widget Signal'>unmap-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--unrealize" title='The "unrealize" gtk.Widget Signal'>unrealize</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--visibility-notify-event" title='The "visibility-notify-event" gtk.Widget Signal'>visibility-notify-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id4088268"></a><h2>Description</h2><p>The <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> class is
the base class for all <code class="literal">PyGTK</code> widgets. It provides the common set of method and signals for the widgets including:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">drag and drop setting and management methods</li><li class="listitem">selection methods</li><li class="listitem">methods to realize, map and show widgets</li><li class="listitem">methods to manage size allocation and requests</li><li class="listitem">methods to initiate widget redrawing</li><li class="listitem">methods to deal with the widget's place in the widget hierarchy</li><li class="listitem">event management methods</li><li class="listitem">methods to modify the style settings</li><li class="listitem">methods to access the default resources</li></ul></div><p><a name="widget-style-properties"></a><a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
introduces style properties - these are basically object properties that are
stored not on the object, but in the style object associated to the
widget. Style properties are set in resource files. This mechanism is used
for configuring such things as the location of the scrollbar arrows through
the theme, giving theme authors more control over the look of applications
without the need to write a theme engine in C.</p><p>Use the <a class="link" href="class-gtkwidget.html#function-gtk--widget-class-install-style-property" title="gtk.widget_class_install_style_property"><code class="function">gtk.widget_class_install_style_property</code>()</a>
    function to install style properties for a widget class, the <a class="link" href="class-gtkwidget.html#function-gtk--widget-class-find-style-property" title="gtk.widget_class_find_style_property"><code class="function">gtk.widget_class_find_style_property</code>()</a>
    function or the <a class="link" href="class-gtkwidget.html#function-gtk--widget-class-list-style-properties" title="gtk.widget_class_list_style_properties"><code class="function">gtk.widget_class_list_style_properties</code>()</a>
    function to get information about existing style properties and the
    <a class="link" href="class-gtkwidget.html#method-gtkwidget--style-get-property" title="gtk.Widget.style_get_property"><code class="methodname">style_get_property</code>()</a>
    method to obtain the value of a style property.</p></div><div class="refsect1" title="Methods"><a name="id4088442"></a><h2>Methods</h2><div class="refsect2" title="gtk.Widget.set_allocation"><a name="method-gtkwidget--set-allocation"></a><h3>gtk.Widget.set_allocation</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_allocation</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>allocation</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>allocation</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_allocation</code>() method sets the widget's allocation.
      This should not be used directly, but from within a widget's
      "size_allocate" implementation.</p></div><div class="refsect2" title="gtk.Widget.get_allocation"><a name="method-gtkwidget--get-allocation"></a><h3>gtk.Widget.get_allocation</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_allocation</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a></td></tr></tbody></table><p>The <code class="methodname">get_allocation</code>() method returns a
<a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a> containing the bounds of the widget's allocation.</p></div><div class="refsect2" title="gtk.Widget.drag_check_threshold"><a name="method-gtkwidget--drag-check-threshold"></a><h3>gtk.Widget.drag_check_threshold</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_check_threshold</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>current_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>current_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start_x</code></strong> :</span></p></td><td>the X coordinate of start of
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start_y</code></strong> :</span></p></td><td>the Y coordinate of start of
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>current_x</code></strong> :</span></p></td><td>the current X coordinate</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>current_y</code></strong> :</span></p></td><td>the current Y coordinate</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the drag threshold
has been passed.</td></tr></tbody></table><p>The check_drag_threshold() method checks to see if a mouse drag
starting at (<em class="parameter"><code>start_x</code></em>, <em class="parameter"><code>start_y</code></em>)
and ending at (<em class="parameter"><code>current_x</code></em>,
<em class="parameter"><code>current_y</code></em>) has passed the+ drag threshhold distance,
and thus should trigger the beginning of a drag-and-drop operation.</p></div><div class="refsect2" title="gtk.Widget.drag_get_data"><a name="method-gtkwidget--drag-get-data"></a><h3>gtk.Widget.drag_get_data</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_get_data</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>context</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span><span class="initializer">=0L</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>context</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>an atom</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>a timestamp or 0L to specify the current
time</td></tr></tbody></table><p>The <code class="methodname">drag_get_data</code>() method gets the
data associated with a drag specified by <em class="parameter"><code>drag_context</code></em>
and <em class="parameter"><code>target</code></em>. When the data is received or the
retrieval fails, a "drag_data_received" signal will be emitted. Failure of
the retrieval is indicated by the length field of the <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a> 
being negative. However, when the <code class="methodname">drag_get_data</code>()
method is called implicitly because <code class="literal">gtk.DRAG_DEFAULT_DROP</code>
was set, the widget will not receive notification of failed drops.</p></div><div class="refsect2" title="gtk.Widget.drag_highlight"><a name="method-gtkwidget--drag-highlight"></a><h3>gtk.Widget.drag_highlight</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_highlight</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">drag_highlight</code>() method draws a
highlight around a widget. This will attach handlers to "expose_event" and
"draw", so the highlight will continue to be displayed until the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-unhighlight" title="gtk.Widget.drag_unhighlight"><code class="methodname">drag_unhighlight</code>()</a> 
method is called.</p></div><div class="refsect2" title="gtk.Widget.drag_unhighlight"><a name="method-gtkwidget--drag-unhighlight"></a><h3>gtk.Widget.drag_unhighlight</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_unhighlight</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">drag_unhighlight</code>() method removes
the highlight that was set by the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-highlight" title="gtk.Widget.drag_highlight"><code class="methodname">drag_highlight</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_set"><a name="method-gtkwidget--drag-dest-set"></a><h3>gtk.Widget.drag_dest_set</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_set</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>flags</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>flags</code></strong> :</span></p></td><td>the flags that specify what actions should be
taken on behalf of a widget for drops onto that widget. The targets  and
actions fields only are used if <code class="literal">gtk.DEST_DEFAULT_MOTION</code>
or <code class="literal">gtk.DEST_DEFAULT_DROP</code> are given.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>a sequence of target
tuples</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>a bitmask of possible actions for a drop onto
this widget.</td></tr></tbody></table><p>The <code class="methodname">drag_dest_set</code>() method sets up a
widget as a potential drag drop destination. The value of
<em class="parameter"><code>flags</code></em> is a combination of the <a class="xref" href="gtk-constants.html#gtk-dest-defaults-constants" title="GTK Dest Defaults Constants">GTK Dest Defaults Constants</a>.</p><p><em class="parameter"><code>targets</code></em> is a sequence (list or tuple) of
3-tuples that contain information about the targets. The target data contains
a string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p><p>The value of <em class="parameter"><code>actions</code></em> is one of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a>.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_set_proxy"><a name="method-gtkwidget--drag-dest-set-proxy"></a><h3>gtk.Widget.drag_dest_set_proxy</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_set_proxy</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>proxy_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>protocol</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>use_coordinates</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>proxy_window</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> to
forward drag events to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>protocol</code></strong> :</span></p></td><td>the drag protocol that
<em class="parameter"><code>proxy_window</code></em> accepts</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>use_coordinates</code></strong> :</span></p></td><td>if <code class="literal">True</code>, send the same
coordinates to the destination, because it is an embedded
subwindow.</td></tr></tbody></table><p>The <code class="methodname">drag_dest_set_proxy</code>() method sets a
proxy <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
specified by <em class="parameter"><code>proxy_window</code></em> that drag events are
forwarded to on behalf of the widget. The value of
<em class="parameter"><code>protocol</code></em> is one of the <a class="xref" href="gdk-constants.html#gdk-drag-protocol-constants" title="GDK Drag Protocol Constants">GDK Drag Protocol Constants</a>.</p><p>If <em class="parameter"><code>use_coordinates</code></em> is
<code class="literal">True</code>, the same coordinates are sent to the destination
because the widget's an embedded subwindow.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_unset"><a name="method-gtkwidget--drag-dest-unset"></a><h3>gtk.Widget.drag_dest_unset</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_unset</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">drag_dest_unset</code>() method clears the
information about a drop destination set with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-set" title="gtk.Widget.drag_dest_set"><code class="methodname">drag_dest_set</code>()</a> 
method. The widget will no longer receive notification of drags.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_find_target"><a name="method-gtkwidget--drag-dest-find-target"></a><h3>gtk.Widget.drag_dest_find_target</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_find_target</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>context</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target_list</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>context</code></strong> :</span></p></td><td>the drag context</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target_list</code></strong> :</span></p></td><td>a list of droppable targets, or
<code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the first target that the source offers and the
dest can accept, or <code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">dest_find_target</code>() method looks for
a match between the targets in the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a> 
specified by <em class="parameter"><code>context</code></em> and the
<em class="parameter"><code>target_list</code></em>, returning the first matching target, or
<code class="literal">NONE</code> if no match is found. The list specified by
<em class="parameter"><code>target_list</code></em> should usually be the return value from
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-get-target-list" title="gtk.Widget.drag_dest_get_target_list"><code class="methodname">drag_dest_get_target_list</code>()</a> 
method, but some widgets may have different valid targets for different
parts of the widget; in that case, they will have to implement a
"drag-motion" handler that passes the correct target list to this method.
<em class="parameter"><code>target_list</code></em> is a sequence (list or tuple) of 3-tuples
that contain information about the targets. The target data contains a
string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_get_target_list"><a name="method-gtkwidget--drag-dest-get-target-list"></a><h3>gtk.Widget.drag_dest_get_target_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_get_target_list</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the list of targets or <code class="literal">None</code>
if no targets are set</td></tr></tbody></table><p>The <code class="methodname">drag_dest_get_target_list</code>() method
returns the list of targets this widget can accept from drag-and-drop. The
returned value is a sequence (list or tuple) of 3-tuples that contain
information about the targets. The target data contains a string
representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_set_target_list"><a name="method-gtkwidget--drag-dest-set-target-list"></a><h3>gtk.Widget.drag_dest_set_target_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_set_target_list</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>target_list</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>target_list</code></strong> :</span></p></td><td>a list of droppable targets, or
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">drag_dest_set_target_list</code>() method
sets the target types (that this widget can accept from drag-and-drop) to
the list specified by <em class="parameter"><code>target_list</code></em>. The widget must
first be made into a drag destination with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-dest-set" title="gtk.Widget.drag_dest_set"><code class="methodname">drag_dest_set()</code></a> 
method. <em class="parameter"><code>target_list</code></em> is a sequence (list or tuple) of
3-tuples that contain information about the targets. The target data contains
a string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_add_image_targets"><a name="method-gtkwidget--drag-dest-add-image-targets"></a><h3>gtk.Widget.drag_dest_add_image_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_add_image_targets</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">drag_dest_add_image_targets</code>()
method adds the image targets supported by <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a>
to the target list of the widget's drag destination using an info value of
0.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_add_text_targets"><a name="method-gtkwidget--drag-dest-add-text-targets"></a><h3>gtk.Widget.drag_dest_add_text_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_add_text_targets</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">drag_dest_add_text_targets</code>() method
adds the text targets supported by <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a>
to the target list of the widget's drag destination using an info value of
0.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_add_uri_targets"><a name="method-gtkwidget--drag-dest-add-uri-targets"></a><h3>gtk.Widget.drag_dest_add_uri_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_add_uri_targets</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">drag_dest_add_uri_targets</code>() method adds the URI targets supported by <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a>
to the target list of the widget's drag destination using an info value of
0.</p></div><div class="refsect2" title="gtk.Widget.drag_source_set"><a name="method-gtkwidget--drag-source-set"></a><h3>gtk.Widget.drag_source_set</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_set</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_button_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start_button_mask</code></strong> :</span></p></td><td>the bitmask of buttons that can start the drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>a list of targets that the drag will support</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>the possible actions for a drag from this widget.</td></tr></tbody></table><p>The <code class="methodname">drag_source_set</code>() method sets up
the widget to start a drag operation when the user clicks and drags on the
widget. The widget must have a window. The value of start_button_mask is a
combination of the <a class="xref" href="gdk-constants.html#gdk-modifier-constants" title="GDK Modifier Constants">GDK Modifier Constants</a>.</p><p><em class="parameter"><code>targets</code></em> is a sequence (list or tuple) of
3-tuples that contain information about the targets. The target data contains
a string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p><p>The value of <em class="parameter"><code>actions</code></em> is one of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a>:</p></div><div class="refsect2" title="gtk.Widget.drag_source_unset"><a name="method-gtkwidget--drag-source-unset"></a><h3>gtk.Widget.drag_source_unset</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_unset</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">drag_source_unset</code>() method unsets
the drag source for the widget that was set up by the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set" title="gtk.Widget.drag_source_set"><code class="methodname">drag_source_set</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.drag_source_set_icon"><a name="method-gtkwidget--drag-source-set-icon"></a><h3>gtk.Widget.drag_source_set_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_set_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixmap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>mask</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>colormap</code></strong> :</span></p></td><td>the colormap of the icon</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pixmap</code></strong> :</span></p></td><td>the image data for the
icon</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>mask</code></strong> :</span></p></td><td>the transparency mask for an
image.</td></tr></tbody></table><p>The <code class="methodname">drag_source_set_icon</code>() method sets
the icon that will be used for drags from the widget using the specified
<em class="parameter"><code>pixmap</code></em> and <em class="parameter"><code>mask</code></em>.
<em class="parameter"><code>colormap</code></em> specifies the colormap to be used to create
the icon. The <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-icon-pixbuf" title="gtk.Widget.drag_source_set_icon_pixbuf"><code class="methodname">drag_source_set_icon_pixbuf</code>()</a> 
method should be used instead of this method.</p></div><div class="refsect2" title="gtk.Widget.drag_source_set_icon_pixbuf"><a name="method-gtkwidget--drag-source-set-icon-pixbuf"></a><h3>gtk.Widget.drag_source_set_icon_pixbuf</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_set_icon_pixbuf</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixbuf</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>pixbuf</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a> for
the drag icon</td></tr></tbody></table><p>The <code class="methodname">drag_source_set_icon_pixbuf</code>()
method sets the icon that will be used for drags from the widget from the
<a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
specified by <em class="parameter"><code>pixbuf</code></em>.</p></div><div class="refsect2" title="gtk.Widget.drag_source_set_icon_stock"><a name="method-gtkwidget--drag-source-set-icon-stock"></a><h3>gtk.Widget.drag_source_set_icon_stock</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_set_icon_stock</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stock_id</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>stock_id</code></strong> :</span></p></td><td>the ID of the stock icon to
use</td></tr></tbody></table><p>The <code class="methodname">drag_source_set_icon_stock</code>() method
sets the icon that will be used for drags from a particular source using the
stock icon specified by <em class="parameter"><code>stock_id</code></em>.</p></div><div class="refsect2" title="gtk.Widget.drag_source_set_icon_name"><a name="method-gtkwidget--drag-source-set-icon-name"></a><h3>gtk.Widget.drag_source_set_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_set_icon_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon_name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>icon_name</code></strong> :</span></p></td><td>the name of a themed icon
use</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">drag_source_set_icon_name</code>() method
sets the icon that will be used for drags from a particular source using the
themed icon specified by <em class="parameter"><code>icon_name</code></em>. See the <a class="link" href="class-gtkicontheme.html" title="gtk.IconTheme"><code class="classname">gtk.IconTheme</code></a>
docs for more information.</p></div><div class="refsect2" title="gtk.Widget.drag_source_get_target_list"><a name="method-gtkwidget--drag-source-get-target-list"></a><h3>gtk.Widget.drag_source_get_target_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_get_target_list</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the list of targets or <code class="literal">None</code>
if no targets are set</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">drag_source_get_target_list</code>() method
returns the list of targets this widget can provide for drag-and-drop. The
returned value is a sequence (list or tuple) of 3-tuples that contain
information about the targets. The target data contains a string
representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p></div><div class="refsect2" title="gtk.Widget.drag_source_set_target_list"><a name="method-gtkwidget--drag-source-set-target-list"></a><h3>gtk.Widget.drag_source_set_target_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_set_target_list</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>target_list</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>target_list</code></strong> :</span></p></td><td>a list of droppable targets, or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">drag_source_set_target_list</code>()
method sets the target types (that this widget can provide for
drag-and-drop) to the list specified by
<em class="parameter"><code>target_list</code></em>. The widget must first be made into a
drag source with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set" title="gtk.Widget.drag_source_set"><code class="methodname">drag_source_set()</code></a>
method. <em class="parameter"><code>target_list</code></em> is a sequence (list or tuple) of
3-tuples that contain information about the targets. The target data
contains a string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p></div><div class="refsect2" title="gtk.Widget.drag_source_add_text_targets"><a name="method-gtkwidget--drag-source-add-text-targets"></a><h3>gtk.Widget.drag_source_add_text_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_add_text_targets</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">drag_source_add_text_targets</code>()
method adds the text targets supported by <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a>
to the target list of the widget's drag source using an info value of 0. If
you need another value for info, use the <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-text-targets" title="gtk.target_list_add_text_targets"><code class="function">gtk.target_list_add_text_targets</code>()</a>
function and the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-target-list" title="gtk.Widget.drag_source_set_target_list"><code class="methodname">drag_source_set_target_list</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Widget.drag_source_add_image_targets"><a name="method-gtkwidget--drag-source-add-image-targets"></a><h3>gtk.Widget.drag_source_add_image_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_add_image_targets</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">drag_source_add_image_targets</code>()
method adds the image targets supported by <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a>
to the target list of the widget's drag source using an info value of 0. If
you need another value for info, use the <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-image-targets" title="gtk.target_list_add_image_targets"><code class="function">gtk.target_list_add_image_targets</code>()</a>
function and the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-target-list" title="gtk.Widget.drag_source_set_target_list"><code class="methodname">drag_source_set_target_list</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Widget.drag_source_add_uri_targets"><a name="method-gtkwidget--drag-source-add-uri-targets"></a><h3>gtk.Widget.drag_source_add_uri_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_source_add_uri_targets</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">drag_source_add_uri_targets</code>()
method adds the URI targets supported by <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a>
to the target list of the widget's drag source using an info value of 0. If
you need another value for info, use the <a class="link" href="class-gtkselectiondata.html#function-gtk--target-list-add-image-targets" title="gtk.target_list_add_image_targets"><code class="function">gtk.target_list_add_image_targets</code>()</a> function
and the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-target-list" title="gtk.Widget.drag_source_set_target_list"><code class="methodname">drag_source_set_target_list</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Widget.drag_begin"><a name="method-gtkwidget--drag-begin"></a><h3>gtk.Widget.drag_begin</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_begin</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>button</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>the list of targets supported by the widget
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>the allowed drag operations for the
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>button</code></strong> :</span></p></td><td>the button the user pressed to start the
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a> that
triggered the drag</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr></tbody></table><p>The <code class="methodname">drag_begin</code>() method starts a drag
on the source side. The method only needs to be used when the application is
starting drags itself, and is not needed when the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set" title="gtk.Widget.drag_source_set"><code class="methodname">drag_source_set</code>()</a> 
method is used. <em class="parameter"><code>targets</code></em> is a sequence (list or tuple)
of 3-tuples that contain information about the targets. The target data
contains a string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p><p>The value of <em class="parameter"><code>actions</code></em> is one of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a>.</p><p><em class="parameter"><code>button</code></em> is the button that the user
pressed to start the drag operation. <em class="parameter"><code>event</code></em> is the
<a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a>
that triggered the start of the drag operation (the button press). This
method returns the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a> 
for the drag operation.</p></div><div class="refsect2" title="gtk.Widget.grab_add"><a name="method-gtkwidget--grab-add"></a><h3>gtk.Widget.grab_add</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">grab_add</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">grab_add</code>() method makes the widget
the current grabbed widget. This means that interaction with other widgets
in the same application is blocked and mouse as well as keyboard events are
delivered to this widget.</p></div><div class="refsect2" title="gtk.Widget.grab_remove"><a name="method-gtkwidget--grab-remove"></a><h3>gtk.Widget.grab_remove</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">grab_remove</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">grab_remove</code>() method removes the
grab from the widget. You have to pair calls to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-add" title="gtk.Widget.grab_add"><code class="methodname">grab_add</code>()</a> 
and <code class="methodname">grab_remove</code>() methods.</p></div><div class="refsect2" title="gtk.Widget.rc_get_style"><a name="method-gtkwidget--rc-get-style"></a><h3>gtk.Widget.rc_get_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">rc_get_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the resulting style.</td></tr></tbody></table><p>The <code class="methodname">rc_get_style</code>() method finds all
matching RC styles for the widget, composites them together, and then
creates a <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a>
representing the composite appearance.</p></div><div class="refsect2" title="gtk.Widget.selection_owner_set"><a name="method-gtkwidget--selection-owner-set"></a><h3>gtk.Widget.selection_owner_set</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selection_owner_set</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span><span class="initializer">=0L</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>selection</code></strong> :</span></p></td><td>an atom representing the selection to
claim</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>a timestamp or 0L to use the current
time</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if
successful</td></tr></tbody></table><p>The <code class="methodname">selection_owner_set</code>() method claims
the ownership of the selection specified by <em class="parameter"><code>selection</code></em>
for the widget.</p></div><div class="refsect2" title="gtk.Widget.selection_add_target"><a name="method-gtkwidget--selection-add-target"></a><h3>gtk.Widget.selection_add_target</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selection_add_target</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>info</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>selection</code></strong> :</span></p></td><td>an atom representing the
selection</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>an atom representing the target for the
selection</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>info</code></strong> :</span></p></td><td>an integer ID that will be passed to the
application</td></tr></tbody></table><p>The <code class="methodname">selection_add_target</code>() method adds
the specified <em class="parameter"><code>target</code></em> to the list of supported targets
for the specified <em class="parameter"><code>selection</code></em>.
<em class="parameter"><code>info</code></em> is an integer ID that will be passed to the
application when the "selection-get" handler is called.</p></div><div class="refsect2" title="gtk.Widget.selection_add_targets"><a name="method-gtkwidget--selection-add-targets"></a><h3>gtk.Widget.selection_add_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selection_add_targets</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>selection</code></strong> :</span></p></td><td>an atom representing the
selection</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>a sequence of 3-tuples containing target
data</td></tr></tbody></table><p>The <code class="methodname">selection_add_targets</code>() method adds
the list of targets (specified by <em class="parameter"><code>targets</code></em>) to the
list of supported targets for the specified
<em class="parameter"><code>selection</code></em>. targets is a sequence (Python tuple or
list) of 3-tuples that contain information about the targets. The target data
contains a string representing the drag type, target flags (a combination of
<code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification purposes.</p></div><div class="refsect2" title="gtk.Widget.selection_clear_targets"><a name="method-gtkwidget--selection-clear-targets"></a><h3>gtk.Widget.selection_clear_targets</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selection_clear_targets</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>selection</code></strong> :</span></p></td><td>an atom representing a
selection</td></tr></tbody></table><p>The <code class="methodname">selection_clear_targets</code>() method
remove all targets registered for the specified
<em class="parameter"><code>selection</code></em> for the widget.</p></div><div class="refsect2" title="gtk.Widget.selection_convert"><a name="method-gtkwidget--selection-convert"></a><h3>gtk.Widget.selection_convert</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selection_convert</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span><span class="initializer">=0L</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>selection</code></strong> :</span></p></td><td>an atom specifying the
selection</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>an atom specifying the target
type</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>a timestamp for the request or 0L to use the
current time</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the request
succeeded</td></tr></tbody></table><p>The <code class="methodname">selection_convert</code>() method requests
the contents of the specified <em class="parameter"><code>selection</code></em> for the
specified <em class="parameter"><code>target</code></em> type. When received, a
"selection_received" signal will be generated.</p></div><div class="refsect2" title="gtk.Widget.selection_remove_all"><a name="method-gtkwidget--selection-remove-all"></a><h3>gtk.Widget.selection_remove_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selection_remove_all</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">selection_remove_all</code>() method
removes all handlers and unsets ownership of all selections for a widget.
This method is called when widget is being destroyed and not usually by
applications.</p></div><div class="refsect2" title="gtk.Widget.destroy"><a name="method-gtkwidget--destroy"></a><h3>gtk.Widget.destroy</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">destroy</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">destroy</code>() method destroys the
widget. When a widget is destroyed, it will break any references it holds to
other objects. If the widget is inside a container, the widget will be
removed from the container. If the widget is a toplevel (derived from <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>), it will
be removed from the list of toplevels, and the reference
<code class="literal">PyGTK</code> holds to it will be removed. Removing a widget from
its container or the list of toplevels results in the widget being
finalized. In most cases, only toplevel widgets (windows) require explicit
destruction, because when you destroy a toplevel its children will be
destroyed as well.</p></div><div class="refsect2" title="gtk.Widget.unparent"><a name="method-gtkwidget--unparent"></a><h3>gtk.Widget.unparent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unparent</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unparent</code>() method is only for use
in widget implementations. It should be called by implementations of the
remove method on a <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>, to
dissociate a child widget from the container.</p></div><div class="refsect2" title="gtk.Widget.show"><a name="method-gtkwidget--show"></a><h3>gtk.Widget.show</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">show</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">show</code>() method causes a widget to be
displayed as soon as practical. Any widget that isn't shown will not appear
on the screen. If you want to show all the widgets in a container, it's
easier to call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show-all" title="gtk.Widget.show_all"><code class="methodname">show_all</code>()</a> 
on the container, instead of individually showing the widgets. Of course you
have to show the containers containing a widget, as well as the widget
itself, before it will appear onscreen. When a toplevel container is shown,
it is immediately realized and mapped; other shown widgets are realized and
mapped when their toplevel container is realized and mapped.</p></div><div class="refsect2" title="gtk.Widget.show_now"><a name="method-gtkwidget--show-now"></a><h3>gtk.Widget.show_now</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">show_now</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">show_now</code>() method is the same as
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show"><code class="methodname">show</code>()</a>
method except if the widget is an unmapped toplevel widget (i.e. a <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> that has
not yet been shown), it enters the main loop and waits for the window to
actually be mapped.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Because the main loop is running, anything can happen during
this method.</p></div></div><div class="refsect2" title="gtk.Widget.hide"><a name="method-gtkwidget--hide"></a><h3>gtk.Widget.hide</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">hide</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">hide</code>() method reverses the effects
of the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show"><code class="methodname">show</code>()</a>
method, causing the widget to be hidden (removed from the display) by
unmapping it.</p></div><div class="refsect2" title="gtk.Widget.show_all"><a name="method-gtkwidget--show-all"></a><h3>gtk.Widget.show_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">show_all</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">show_all</code>() method recursively shows
the widget, and any child widgets (if the widget is a container).</p></div><div class="refsect2" title="gtk.Widget.hide_all"><a name="method-gtkwidget--hide-all"></a><h3>gtk.Widget.hide_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">hide_all</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">hide_all</code>() method recursively hides
the widget and its child widgets (if any).</p></div><div class="refsect2" title="gtk.Widget.set_no_show_all"><a name="method-gtkwidget--set-no-show-all"></a><h3>gtk.Widget.set_no_show_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_no_show_all</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>no_show_all</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>no_show_all</code></em> :</span></p></td><td>the new value for the "no_show_all"
	  property</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_no_show_all</code>() method sets the
"no_show_all" property to the value of
<em class="parameter"><code>no_show_all</code></em>. If <em class="parameter"><code>no_show_all</code></em> is
<code class="literal">True</code> calls to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show-all" title="gtk.Widget.show_all"><code class="methodname">show_all()</code></a>
and <a class="link" href="class-gtkwidget.html#method-gtkwidget--hide-all" title="gtk.Widget.hide_all"><code class="methodname">hide_all()</code></a>
methods will not affect this widget.</p><p>This method is mostly for use in constructing widget hierarchies
with externally controlled visibility, see the <a class="link" href="class-gtkuimanager.html" title="gtk.UIManager"><code class="classname">gtk.UIManager</code></a>
reference for mote information.</p></div><div class="refsect2" title="gtk.Widget.get_no_show_all"><a name="method-gtkwidget--get-no-show-all"></a><h3>gtk.Widget.get_no_show_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_no_show_all</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the current value of the "no_show_all"
	  property.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">get_no_show_all</code>() method returns
the current value of the "no_show_all" property. If "no-show-all" is
<code class="literal">True</code> calls to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show-all" title="gtk.Widget.show_all"><code class="methodname">show_all()</code></a>
and <a class="link" href="class-gtkwidget.html#method-gtkwidget--hide-all" title="gtk.Widget.hide_all"><code class="methodname">hide_all()</code></a>
methods will not affect the widget.</p></div><div class="refsect2" title="gtk.Widget.map"><a name="method-gtkwidget--map"></a><h3>gtk.Widget.map</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">map</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">map</code>() method maps the widget
(causes it to be displayed). This method will also cause the widget to be
realized if it is not currently realized. This method is usually not used by
applications.</p></div><div class="refsect2" title="gtk.Widget.unmap"><a name="method-gtkwidget--unmap"></a><h3>gtk.Widget.unmap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unmap</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unmap</code>() method unmaps the widget
(causes it to be removed from the display). This method is not usually used
by applications.</p></div><div class="refsect2" title="gtk.Widget.realize"><a name="method-gtkwidget--realize"></a><h3>gtk.Widget.realize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">realize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">realize</code>() method creates the
resources associated with a widget.  For example, the widget <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> will
be created when the widget is realized.  Normally realization happens
implicitly; if you show a widget and all its parent containers, then the
widget will be realized and mapped automatically. Realizing a widget
requires all the widget's parent widgets to be realized; calling the
<code class="methodname">realize</code>() method realizes the widget's parents in
addition to the widget itself. A widget must be inside a toplevel window
when you realize it. This method is primarily used in widget
implementations, and not in applications. Many times when you think you
might need it, a better approach is to connect to a signal that will be
called after the widget is realized automatically, such as "expose_event".
Or simply using the <PYGTKDOCLINK HREF="method-gobject--connect-after"><code class="methodname">gobject.connect_after</code>()</PYGTKDOCLINK> 
method to add a handler to the "realize" signal.</p></div><div class="refsect2" title="gtk.Widget.unrealize"><a name="method-gtkwidget--unrealize"></a><h3>gtk.Widget.unrealize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unrealize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unrealize</code>() method frees all
resources associated with the widget, such as the <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>.</p></div><div class="refsect2" title="gtk.Widget.queue_draw"><a name="method-gtkwidget--queue-draw"></a><h3>gtk.Widget.queue_draw</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">queue_draw</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">queue_draw</code>() method is equivalent
to calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-draw-area" title="gtk.Widget.queue_draw_area"><code class="methodname">queue_draw_area</code>()</a> 
method for the entire area of a widget.</p></div><div class="refsect2" title="gtk.Widget.queue_draw_area"><a name="method-gtkwidget--queue-draw-area"></a><h3>gtk.Widget.queue_draw_area</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">queue_draw_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>the x coordinate of upper-left corner of
rectangle to redraw</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the y coordinate of upper-left corner of
rectangle to redraw</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>width</code></strong> :</span></p></td><td>the width of rectangle to
redraw</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height</code></strong> :</span></p></td><td>the height of rectangle to
redraw</td></tr></tbody></table><p>The <code class="methodname">queue_draw_area</code>() method
invalidates the rectangular area of the widget specified by
<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>,
<em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> by calling
the <a class="link" href="class-gdkwindow.html#method-gdkwindow--invalidate-rect" title="gtk.gdk.Window.invalidate_rect"><code class="methodname">gtk.gdk.Window.invalidate_rect</code>()</a> 
method on the widget's window and all its child windows. Once the main loop
becomes idle (after the current batch of events has been processed,
roughly), the window will receive expose events for the union of all regions
that have been invalidated.</p><p>Normally you would only use this method in widget
implementations. But you might also use it, or the <a class="link" href="class-gdkwindow.html#method-gdkwindow--invalidate-rect" title="gtk.gdk.Window.invalidate_rect"><code class="methodname">gtk.gdk.Window.invalidate_rect</code>()</a> 
method directly, to schedule a redraw of a <a class="link" href="class-gtkdrawingarea.html" title="gtk.DrawingArea"><code class="classname">gtk.DrawingArea</code></a>
or some portion thereof. Frequently you can just call the <a class="link" href="class-gdkwindow.html#method-gdkwindow--invalidate-rect" title="gtk.gdk.Window.invalidate_rect"><code class="methodname">gtk.gdk.Window.invalidate_rect</code>()</a> 
method instead of this method. This method will invalidate only a single
window, instead of the widget and all its children. The advantage of adding
to the invalidated region compared to simply drawing immediately is
efficiency; using an invalid region ensures that you only have to redraw one
time.</p></div><div class="refsect2" title="gtk.Widget.queue_resize"><a name="method-gtkwidget--queue-resize"></a><h3>gtk.Widget.queue_resize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">queue_resize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">queue_resize</code>() method schedules the
widget to have its size renegotiated. This method should be called when a
widget for some reason has a new size request. For example, when you change
the text in a <a class="link" href="class-gtklabel.html" title="gtk.Label"><code class="classname">gtk.Label</code></a>, a resize
is queued to ensure there's enough space for the new text.</p></div><div class="refsect2" title="gtk.Widget.queue_resize_no_redraw"><a name="method-gtkwidget--queue-resize-no-redraw"></a><h3>gtk.Widget.queue_resize_no_redraw</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">queue_resize_no_redraw</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">queue_resize_no_redraw</code>() method
works like the <a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-resize" title="gtk.Widget.queue_resize"><code class="methodname">queue_resize()</code></a>
method, except that the widget is not invalidated.</p></div><div class="refsect2" title="gtk.Widget.size_request"><a name="method-gtkwidget--size-request"></a><h3>gtk.Widget.size_request</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">size_request</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the widget's required width
and height.</td></tr></tbody></table><p>The <code class="methodname">size_request</code>() method returns the
preferred size of a widget as a tuple containing its required width and
height. This method is typically used when implementing a <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>
subclass to arrange the container's child widgets and decide what size
allocations to give them with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--size-allocate" title="gtk.Widget.size_allocate"><code class="methodname">size_allocate</code>()</a> 
method. Obtaining a size request requires that the widget be associated with
a screen, because font information may be needed.</p><p>Also remember that the size request is not necessarily the size
a widget will actually be allocated.</p><p>See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-child-requisition" title="gtk.Widget.get_child_requisition"><code class="methodname">get_child_requisition</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.size_allocate"><a name="method-gtkwidget--size-allocate"></a><h3>gtk.Widget.size_allocate</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">size_allocate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>allocation</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>allocation</code></strong> :</span></p></td><td>the position and size to be allocated to the
widget</td></tr></tbody></table><p>The <code class="methodname">size_allocate</code>() method sets a size
allocation for the widget using the <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
specified by <em class="parameter"><code>allocation</code></em>. This method is only used by
<a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>
subclasses, to assign a size and position to their child widgets.</p></div><div class="refsect2" title="gtk.Widget.get_child_requisition"><a name="method-gtkwidget--get-child-requisition"></a><h3>gtk.Widget.get_child_requisition</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_child_requisition</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the required size of the
widget</td></tr></tbody></table><p>The <code class="methodname">get_child_requisition</code>() method
returns a tuple containing the widget requisition width and height. This
method is only for use in widget container implementations since it obtains
the widget requisition directly. By comparison the <a class="link" href="class-gtkwidget.html#method-gtkwidget--size-request" title="gtk.Widget.size_request"><code class="methodname">size_request</code>()</a> 
method actually computes the size request and fills in the widget
requisition before returning. Because this method does not recalculate the
size request, it can only be used when you know that the widget requisition
is up-to-date, i.e. the <a class="link" href="class-gtkwidget.html#method-gtkwidget--size-request" title="gtk.Widget.size_request"><code class="methodname">size_request</code>()</a> 
method has been called since the last time a resize was queued. In general,
only container implementations have this information; applications should
use the <a class="link" href="class-gtkwidget.html#method-gtkwidget--size-request" title="gtk.Widget.size_request"><code class="methodname">size_request</code>()</a> 
method instead.</p></div><div class="refsect2" title="gtk.Widget.add_accelerator"><a name="method-gtkwidget--add-accelerator"></a><h3>gtk.Widget.add_accelerator</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_accelerator</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_signal</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_key</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_mods</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_flags</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>accel_signal</code></strong> :</span></p></td><td>the widget signal to emit on accelerator
activation</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_group</code></strong> :</span></p></td><td>the accel group for this widget, added to its
toplevel</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_key</code></strong> :</span></p></td><td>the keyval of the accelerator e.g.
<code class="literal">ord('q')</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_mods</code></strong> :</span></p></td><td>the modifier key combination of the
accelerator</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_flags</code></strong> :</span></p></td><td>the flag accelerators, e.g.
<code class="literal">gtk.ACCEL_VISIBLE</code></td></tr></tbody></table><p>The <code class="methodname">add_accelerator</code>() method installs
      an accelerator for the widget in <em class="parameter"><code>accel_group</code></em>
      that causes <em class="parameter"><code>accel_signal</code></em> to be emitted if the
      accelerator is activated. The accelerator key and modifiers are
      specified by <em class="parameter"><code>accel_key</code></em> and
      <em class="parameter"><code>accel_mods</code></em>
      respectively. <em class="parameter"><code>accel_mods</code></em> should be a
      combination of the <a class="xref" href="gdk-constants.html#gdk-modifier-constants" title="GDK Modifier Constants">GDK Modifier Constants</a>. <em class="parameter"><code>accel_flags</code></em>
      is a combination of <code class="literal">gtk.ACCEL_VISIBLE</code> and
      <code class="literal">gtk.ACCEL_LOCKED</code> (see the <a class="xref" href="gtk-constants.html#gtk-accel-flags-constants" title="GTK Accel Flags Constants">GTK Accel Flags Constants</a>). The
      <em class="parameter"><code>accel_group</code></em> needs to be added to the widget's
      toplevel via the <a class="link" href="class-gtkwindow.html#method-gtkwindow--add-accel-group" title="gtk.Window.add_accel_group"><code class="methodname">gtk.Window.add_accel_group</code>()</a>
      method and the signal specified by <em class="parameter"><code>accel_signal</code></em>
      must have signal flags that include the
      <code class="literal">gobject.SIGNAL_ACTION</code> flag (see the <PYGTKDOCLINK HREF="gobject-signal-constants">GObject Signal Flag
      Constants</PYGTKDOCLINK> for more information). Accelerators added through
      this method are not user changeable during runtime. If you want to
      support accelerators that can be changed by the user, the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-accel-path" title="gtk.Widget.set_accel_path"><code class="methodname">set_accel_path</code>()</a>
      or <a class="link" href="class-gtkmenuitem.html#method-gtkmenuitem--set-accel-path" title="gtk.MenuItem.set_accel_path"><code class="methodname">gtk.MenuItem.set_accel_path</code>()</a>
      methods instead.</p></div><div class="refsect2" title="gtk.Widget.remove_accelerator"><a name="method-gtkwidget--remove-accelerator"></a><h3>gtk.Widget.remove_accelerator</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_accelerator</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_key</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_mods</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>accel_group</code></strong> :</span></p></td><td>the accel group for this
widget</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_key</code></strong> :</span></p></td><td>the keyval of the
accelerator</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_mods</code></strong> :</span></p></td><td>the modifier key combination of the
accelerator</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the accelerator was
removed</td></tr></tbody></table><p>The <code class="methodname">remove_accelerator</code>() method removes
the accelerator specified by <em class="parameter"><code>accel_key</code></em> and
<em class="parameter"><code>accel_mods</code></em> from the widget's accelerator group
(specified by <em class="parameter"><code>accel_group</code></em>), previously installed with
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--add-accelerator" title="gtk.Widget.add_accelerator"><code class="methodname">add_accelerator</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.set_accel_path"><a name="method-gtkwidget--set-accel-path"></a><h3>gtk.Widget.set_accel_path</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_accel_path</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>accel_path</code></strong> :</span></p></td><td>the path used to look up the the
accelerator</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>accel_group</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkaccelgroup.html" title="gtk.AccelGroup"><code class="classname">gtk.AccelGroup</code></a>.</td></tr></tbody></table><p>The <code class="methodname">set_accel_path</code>() method sets an
accelerator (using the key bindings defined in
<em class="parameter"><code>accel_path</code></em>) in the accelerator group specified by
<em class="parameter"><code>accel_group</code></em>. This method removes any accelerators for
any accelerator group installed by previous calls to the
<code class="methodname">set_accel_path</code>() method. Associating accelerators
with paths allows them to be modified by the user and the modifications to
be saved for future use. This method is a low level method that would most
likely be used by a menu creation system like <a class="link" href="class-gtkitemfactory.html" title="gtk.ItemFactory"><code class="classname">gtk.ItemFactory</code></a>. 
If you use <a class="link" href="class-gtkitemfactory.html" title="gtk.ItemFactory"><code class="classname">gtk.ItemFactory</code></a>, 
setting up accelerator paths will be done automatically. Even when you you
aren't using <a class="link" href="class-gtkitemfactory.html" title="gtk.ItemFactory"><code class="classname">gtk.ItemFactory</code></a>, 
if you only want to set up accelerators on menu items the <a class="link" href="class-gtkmenuitem.html#method-gtkmenuitem--set-accel-path" title="gtk.MenuItem.set_accel_path"><code class="methodname">gtk.MenuItem.set_accel_path</code>()</a> 
method provides a somewhat more convenient interface.</p></div><div class="refsect2" title="gtk.Widget.can_activate_accel"><a name="method-gtkwidget--can-activate-accel"></a><h3>gtk.Widget.can_activate_accel</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">can_activate_accel</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>signal_id</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td><td>the ID of an installed signal</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the accelerator can
	  be activated.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">can_activate_accel</code>() method returns
<code class="literal">True</code> if an accelerator that activates the signal
specified by <em class="parameter"><code>signal_id</code></em> can currently be activated.
This is done by emitting the "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--can-activate-accel" title='The "can-activate-accel" gtk.Widget Signal'>can-activate-accel</a>"
signal. If the signal isn't overridden by a handler or in a derived widget,
then the default check is that the widget must be sensitive, and the widget
and all its ancestors mapped.</p></div><div class="refsect2" title="gtk.Widget.mnemonic_activate"><a name="method-gtkwidget--mnemonic-activate"></a><h3>gtk.Widget.mnemonic_activate</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">mnemonic_activate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>group_cycling</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>group_cycling</code></strong> :</span></p></td><td>if True grab the focus instead of activating
the widget</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>True if the signal was
handled</td></tr></tbody></table><p>The<code class="methodname"> mnemonic_activate</code>() method emits
the "mnemonic-activate" signal on the widget and returns
<code class="literal">True</code> if the signal was handled.
<em class="parameter"><code>group_cycling</code></em> is <code class="literal">True</code> if the focus
is being shifted to the widget and <code class="literal">False</code> if the widget
should be activated.</p></div><div class="refsect2" title="gtk.Widget.event"><a name="method-gtkwidget--event"></a><h3>gtk.Widget.event</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">event</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the event was
handled</td></tr></tbody></table><p>The <code class="methodname">event</code>() method emits the event
signals on a widget (those signals should never be emitted without using
this method to do so). If you want to synthesize an event though, don't use
this method; instead, use the <a class="link" href="gtk-functions.html#function-gtk--main-do-event" title="gtk.main_do_event"><code class="methodname">gtk.main_do_event</code>()</a> 
function so the event will behave as if it were in the event queue. Don't
synthesize expose events; instead, use the <a class="link" href="class-gdkwindow.html#method-gdkwindow--invalidate-rect" title="gtk.gdk.Window.invalidate_rect"><code class="methodname">gtk.gdk.Window.invalidate_rect</code>()</a> 
method to invalidate a region of the window.</p></div><div class="refsect2" title="gtk.Widget.send_expose"><a name="method-gtkwidget--send-expose"></a><h3>gtk.Widget.send_expose</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">send_expose</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>an expose <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the event was
handled</td></tr></tbody></table><p>The <code class="methodname">send_expose</code>() method emits an
expose event signal on a widget. This method is usually used when
propagating an expose event to a child <code class="literal">NO_WINDOW</code> widget,
and that is normally done using the <a class="link" href="class-gtkcontainer.html#method-gtkcontainer--propagate-expose" title="gtk.Container.propagate_expose"><code class="methodname">gtk.Container.propagate_expose</code>()</a> 
method. If you want to force an area of a window to be redrawn, use the
<a class="link" href="class-gdkwindow.html#method-gdkwindow--invalidate-rect" title="gtk.gdk.Window.invalidate_rect"><code class="methodname">gtk.gdk.Window.invalidate_rect</code>()</a> 
method. To cause the redraw to be done immediately, follow that call with a
call to the <a class="link" href="class-gdkwindow.html#method-gdkwindow--process-updates" title="gtk.gdk.Window.process_updates"><code class="methodname">gtk.gdk.Window.process_updates</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.activate"><a name="method-gtkwidget--activate"></a><h3>gtk.Widget.activate</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget was
activatable</td></tr></tbody></table><p>The <code class="methodname">activate</code>() method emits the
"activate" signal on the widget that activates it (if it can be activated).
Activation is what happens when you press <span class="keycap"><strong>Enter</strong></span> on a widget
during key navigation; clicking a button, selecting a menu item, etc. If the
widget isn't activatable, the method returns
<code class="literal">False</code>.</p></div><div class="refsect2" title="gtk.Widget.set_scroll_adjustments"><a name="method-gtkwidget--set-scroll-adjustments"></a><h3>gtk.Widget.set_scroll_adjustments</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_scroll_adjustments</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hadjustment</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>vadjustment</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>hadjustment</code></strong> :</span></p></td><td>an adjustment for horizontal scrolling, or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>vadjustment</code></strong> :</span></p></td><td>an adjustment for vertical scrolling, or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget supports
scrolling</td></tr></tbody></table><p>The <code class="methodname">set_scroll_adjustments</code>() method
sets the horizontal and vertical scroll adjustments specified by
<em class="parameter"><code>hadjustment</code></em> and <em class="parameter"><code>vadjustment</code></em>
respectively and returns <code class="literal">True</code>. If the widget doesn't
support scrolling this method returns <code class="literal">False</code>. Widgets that
don't support scrolling can be scrolled by placing them in a <a class="link" href="class-gtkviewport.html" title="gtk.Viewport"><code class="classname">gtk.Viewport</code></a>,
which does support scrolling. This method emits the "set-scroll-adjustments"
signal on the widget.</p></div><div class="refsect2" title="gtk.Widget.reparent"><a name="method-gtkwidget--reparent"></a><h3>gtk.Widget.reparent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">reparent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_parent</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>new_parent</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a> to
move the widget into</td></tr></tbody></table><p>The <code class="methodname">reparent</code>() method moves a widget
from one <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a> to
another.</p></div><div class="refsect2" title="gtk.Widget.intersect"><a name="method-gtkwidget--intersect"></a><h3>gtk.Widget.intersect</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">intersect</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>area</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>intersection</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>area</code></strong> :</span></p></td><td>a rectangle</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a rectangle of the intersection of the widget
and <em class="parameter"><code>area</code></em> or
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">intersect</code>() method computes the
intersection of a the widget's area and <em class="parameter"><code>area</code></em>, and
returns the intersection in a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>. 
This method returns <code class="literal">False</code> if there is no
intersection.</p></div><div class="refsect2" title="gtk.Widget.region_intersect"><a name="method-gtkwidget--region-intersect"></a><h3>gtk.Widget.region_intersect</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">region_intersect</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>region</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>region</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkregion.html" title="gtk.gdk.Region"><code class="classname">gtk.gdk.Region</code></a>,
          in the same coordinate system as the widget.allocation. That is,
          relative to the widget.window for <code class="literal">NO_WINDOW</code>
          widgets; relative to the parent window of the widget.window for
          widgets with their own window.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a newly allocated <a class="link" href="class-gdkregion.html" title="gtk.gdk.Region"><code class="classname">gtk.gdk.Region</code></a>
          holding the intersection of the widget and <em class="parameter"><code>region</code></em>. The coordinates of
          the returned region are relative to widget.window for <code class="literal">NO_WINDOW</code>
          widgets, and relative to the parent window of widget.window for
          widgets with their own window.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">region_intersect</code>() method computes
      and returns as a <a class="link" href="class-gdkregion.html" title="gtk.gdk.Region"><code class="classname">gtk.gdk.Region</code></a>
      the intersection of a the widget's area and the <a class="link" href="class-gdkregion.html" title="gtk.gdk.Region"><code class="classname">gtk.gdk.Region</code></a>
      specified by <em class="parameter"><code>region</code></em>. Since the result may be
      empty, use the <a class="link" href="class-gdkregion.html#method-gdkregion--empty" title="gtk.gdk.Region.empty"><code class="methodname">gtk.gdk.Region.empty</code>()</a>
      method to check.</p></div><div class="refsect2" title="gtk.Widget.freeze_child_notify"><a name="method-gtkwidget--freeze-child-notify"></a><h3>gtk.Widget.freeze_child_notify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">freeze_child_notify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">freeze_child_notify</code>() method
freezes the child notify queue that is used to notify child widgets of child
property changes.</p></div><div class="refsect2" title="gtk.Widget.child_notify"><a name="method-gtkwidget--child-notify"></a><h3>gtk.Widget.child_notify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">child_notify</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_property</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child_property</code></strong> :</span></p></td><td>a child property</td></tr></tbody></table><p>The <code class="methodname">child_notify</code>() method adds a child
property to the widget's child notify queue that is used to notify child
widgets of a change to a child property.</p></div><div class="refsect2" title="gtk.Widget.thaw_child_notify"><a name="method-gtkwidget--thaw-child-notify"></a><h3>gtk.Widget.thaw_child_notify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">thaw_child_notify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">thaw_child_notify</code>() method reverses
the effect of a previous call to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--freeze-child-notify" title="gtk.Widget.freeze_child_notify"><code class="methodname">freeze_child_notify</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.is_focus"><a name="method-gtkwidget--is-focus"></a><h3>gtk.Widget.is_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is the
focus widget.</td></tr></tbody></table><p>The <code class="methodname">is_focus</code>() method returns
<code class="literal">True</code> if the widget is the focus widget within its
toplevel. This does not mean that the <code class="literal">gtk.HAS_FOCUS</code> flag
is necessarily set; <code class="literal">gtk.HAS_FOCUS</code> will only be set if the
toplevel widget additionally has the global input focus.</p></div><div class="refsect2" title="gtk.Widget.grab_focus"><a name="method-gtkwidget--grab-focus"></a><h3>gtk.Widget.grab_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">grab_focus</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">grab_focus</code>() method causes the
widget to have the keyboard focus for it's enclosing <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>. The
widget must be a focusable widget, such as a <a class="link" href="class-gtkentry.html" title="gtk.Entry"><code class="classname">gtk.Entry</code></a>. Also, the
widget must have the <code class="literal">gtk.CAN_FOCUS</code> flag set.</p></div><div class="refsect2" title="gtk.Widget.grab_default"><a name="method-gtkwidget--grab-default"></a><h3>gtk.Widget.grab_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">grab_default</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">grab_default</code>() method causes the
widget to become the default widget. The widget must have the
<code class="literal">gtk.CAN_DEFAULT</code> flag set by calling the <a class="link" href="class-gtkobject.html#method-gtkobject--set-flags" title="gtk.Object.set_flags"><code class="methodname">gtk.Object.set_flags</code>()</a> 
method.  The default widget is activated when the user presses
<span class="keycap"><strong>Enter</strong></span> in a window. Default widgets must be activatable, that is,
<a class="link" href="class-gtkwidget.html#method-gtkwidget--activate" title="gtk.Widget.activate"><code class="methodname">gtk.Widget.activate</code>()</a>
should affect them.</p></div><div class="refsect2" title="gtk.Widget.set_name"><a name="method-gtkwidget--set-name"></a><h3>gtk.Widget.set_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name for the widget</td></tr></tbody></table><p>The <code class="methodname">set_name</code>() method sets the "name"
property of the widget to the string specified by
<em class="parameter"><code>name</code></em>. Widgets can be named, which allows you to refer
to them in a GTK resource file.</p></div><div class="refsect2" title="gtk.Widget.get_name"><a name="method-gtkwidget--get-name"></a><h3>gtk.Widget.get_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the name of the widget</td></tr></tbody></table><p>The <code class="methodname">get_name</code>() method returns the value
of the "name" property that contains the name of the widget or
<code class="literal">None</code> if the widget has no name.</p></div><div class="refsect2" title="gtk.Widget.set_state"><a name="method-gtkwidget--set-state"></a><h3>gtk.Widget.set_state</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_state</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>state</code></strong> :</span></p></td><td>the new state for the
widget</td></tr></tbody></table><p>The set_state() method sets the state of the widget to the value
specified by state. The value of state must be one of the <a class="xref" href="gtk-constants.html#gtk-state-type-constants" title="GTK State Type Constants">GTK State Type Constants</a>.</p><p>Usually you should set the state using wrapper methods such as
<a class="link" href="class-gtkwidget.html#method-gtkwidget--set-sensitive" title="gtk.Widget.set_sensitive"><code class="methodname">set_sensitive</code>()</a>.</p></div><div class="refsect2" title="gtk.Widget.set_sensitive"><a name="method-gtkwidget--set-sensitive"></a><h3>gtk.Widget.set_sensitive</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_sensitive</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sensitive</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>sensitive</code></strong> :</span></p></td><td>if <code class="literal">True</code> make the widget
sensitive</td></tr></tbody></table><p>The <code class="methodname">set_sensitive</code>() method sets the
"sensitive" property of the widget to the value specified by
<em class="parameter"><code>sensitive</code></em>. If <em class="parameter"><code>sensitive</code></em> is
<code class="literal">True</code> the widget will be sensitive and the user can
interact with it. An insensitive widget appears "grayed out" and the user
can't interact with it. Insensitive widgets are known as "inactive",
"disabled", or "ghosted" in some other toolkits.</p></div><div class="refsect2" title="gtk.Widget.set_app_paintable"><a name="method-gtkwidget--set-app-paintable"></a><h3>gtk.Widget.set_app_paintable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_app_paintable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>app_paintable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>app_paintable</code></strong> :</span></p></td><td>if <code class="literal">True</code> the application will
paint directly on the widget</td></tr></tbody></table><p>The <code class="methodname">set_app_paintable</code>() method sets the
"app-paintable" property to the value of
<em class="parameter"><code>app_paintable</code></em>. If
<em class="parameter"><code>app_paintable</code></em> is <code class="literal">True</code> the
application will paint directly on the widget.</p></div><div class="refsect2" title="gtk.Widget.set_double_buffered"><a name="method-gtkwidget--set-double-buffered"></a><h3>gtk.Widget.set_double_buffered</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_double_buffered</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>double_buffered</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>double_buffered</code></strong> :</span></p></td><td>if <code class="literal">True</code> double-buffer a
widget</td></tr></tbody></table><p>The <code class="methodname">set_double_buffered</code>() method sets
the widget's flags according to the value of
<em class="parameter"><code>double_buffered</code></em>. If
<em class="parameter"><code>double_buffered</code></em> is <code class="literal">True</code> the
<code class="literal">gtk.DOUBLE_BUFFERED</code> flag is set; otherwise it is unset.
Widgets are double buffered by default. "Double buffered" simply means that
the <a class="link" href="class-gdkwindow.html#method-gdkwindow--begin-paint-rect" title="gtk.gdk.Window.begin_paint_rect"><code class="methodname">gtk.gdk.Window.begin_paint_rect</code>()</a> 
and <a class="link" href="class-gdkwindow.html#method-gdkwindow--end-paint" title="gtk.gdk.Window.end_paint"><code class="methodname">gtk.gdk.Window.end_paint</code>()</a> 
methods are called automatically around expose events sent to the widget.
The <a class="link" href="class-gdkwindow.html#method-gdkwindow--begin-paint-rect" title="gtk.gdk.Window.begin_paint_rect"><code class="methodname">gtk.gdk.Window.begin_paint_rect</code>()</a> 
method diverts all drawing to a widget's window to an off screen buffer, and
the <a class="link" href="class-gdkwindow.html#method-gdkwindow--end-paint" title="gtk.gdk.Window.end_paint"><code class="methodname">gtk.gdk.Window.end_paint</code>()</a> 
method draws the buffer to the screen. The result is that users see the
window update in one smooth step, and don't see individual graphics
primitives being rendered. In very simple terms, double buffered widgets
don't flicker, so you would only use this method to turn off double
buffering if you had special needs and really knew what you were
doing.</p></div><div class="refsect2" title="gtk.Widget.set_redraw_on_allocate"><a name="method-gtkwidget--set-redraw-on-allocate"></a><h3>gtk.Widget.set_redraw_on_allocate</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_redraw_on_allocate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>redraw_on_allocate</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>redraw_on_allocate</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the entire widget
will be redrawn when it is allocated to a new size. Otherwise, only the new
portion of the widget will be redrawn.</td></tr></tbody></table><p>The <code class="methodname">set_redraw_on_allocate</code>() method
sets a flag that determines if the entire widget is queued for drawing when
a widget's size allocation changes. By default, this setting is
<code class="literal">True</code> and the entire widget is redrawn on every size
change. If your widget leaves the upper left are unchanged when made bigger,
turning this setting on will improve performance.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>For <code class="literal">NO_WINDOW</code> widgets setting this flag to
<code class="literal">False</code> turns off all allocation on resizing: the widget
will not redraw even if its position changes; this is to allow containers
that don't draw anything to avoid excess invalidations. If you set this flag
on a <code class="literal">NO_WINDOW</code> widget that <span class="emphasis"><em>does</em></span> draw
on the widget's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>, you
are responsible for invalidating both the old and new allocation of the
widget when the widget is moved and responsible for invalidating regions
newly when the widget increases size.</p></div></div><div class="refsect2" title="gtk.Widget.set_parent"><a name="method-gtkwidget--set-parent"></a><h3>gtk.Widget.set_parent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_parent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>parent</code></strong> :</span></p></td><td>a parent container</td></tr></tbody></table><p>The <code class="methodname">set_parent</code>() method is useful only
when implementing subclasses of <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>.
This method sets the container as the parent of the widget, and takes care
of some details such as updating the state and style of the child to reflect
its new location. The reverse method is the <a class="link" href="class-gtkwidget.html#method-gtkwidget--unparent" title="gtk.Widget.unparent"><code class="methodname">unparent</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.set_parent_window"><a name="method-gtkwidget--set-parent-window"></a><h3>gtk.Widget.set_parent_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_parent_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent_window</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>parent_window</code></strong> :</span></p></td><td>the new parent window.</td></tr></tbody></table><p>The <code class="methodname">set_parent_window</code>() method sets a
non default parent window for the widget.</p></div><div class="refsect2" title="gtk.Widget.set_child_visible"><a name="method-gtkwidget--set-child-visible"></a><h3>gtk.Widget.set_child_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_child_visible</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_visible</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>is_visible</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the widget should
be mapped along with its parent.</td></tr></tbody></table><p>The <code class="methodname">set_child_visible</code>() method
determines if the widget should be mapped along with its parent. If
<em class="parameter"><code>is_visible</code></em> is <code class="literal">True</code> the widget will
be mapped with its parent if it has called the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show"><code class="methodname">show</code>()</a>
method.</p><p>
The child visibility can be set for widget before it is added to a container
to avoid mapping children unnecessarily. The widget's child visibility flag
will be reset to its default state of <code class="literal">True</code> when the
widget is removed from a container. Note that changing the child visibility
of a widget does not queue a resize on the widget. Most of the time, the
size of a widget is computed from all visible children, whether or not they
are mapped. If this is not the case, the container can queue a resize
itself. This method is only useful for container implementations and never
should be called by an application.</p></div><div class="refsect2" title="gtk.Widget.get_child_visible"><a name="method-gtkwidget--get-child-visible"></a><h3>gtk.Widget.get_child_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_child_visible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is mapped
with the parent.</td></tr></tbody></table><p>The <code class="methodname">get_child_visible</code>() method returns
the value set with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-child-visible" title="gtk.Widget.set_child_visible"><code class="methodname">set_child_visible</code>()</a> 
method. This method is only useful for container implementations and never
should be called by an application.</p></div><div class="refsect2" title="gtk.Widget.get_parent"><a name="method-gtkwidget--get-parent"></a><h3>gtk.Widget.get_parent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_parent</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the parent container of the widget, or
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">get_parent</code>() method returns the
parent container of the widget or <code class="literal">None</code> if the widget has
no parent.</p></div><div class="refsect2" title="gtk.Widget.get_parent_window"><a name="method-gtkwidget--get-parent-window"></a><h3>gtk.Widget.get_parent_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_parent_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the parent <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> of
the widget</td></tr></tbody></table><p>The <code class="methodname">get_parent_window</code>() method returns
the widget's parent <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>.</p></div><div class="refsect2" title="gtk.Widget.child_focus"><a name="method-gtkwidget--child-focus"></a><h3>gtk.Widget.child_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">child_focus</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>direction</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>direction</code></strong> :</span></p></td><td>the direction of focus
movement</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if focus ended up
inside the widget</td></tr></tbody></table><p>The <code class="methodname">child_focus</code>() method is used by
custom widget implementations. If you're writing an application, use the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">grab_focus</code>()</a> 
method to move the focus to a particular widget, and the <a class="link" href="class-gtkcontainer.html#method-gtkcontainer--set-focus-chain" title="gtk.Container.set_focus_chain"><code class="methodname">gtk.Container.set_focus_chain</code>()</a> 
method to change the focus tab order.</p><p>The <code class="methodname">child_focus</code>() method is called by
containers as the user moves around the window using keyboard shortcuts. The
value of <em class="parameter"><code>direction</code></em> indicates what kind of motion is
taking place: <code class="literal">gtk.DIR_TAB_FORWARD</code>,
<code class="literal">gtk.DIR_TAB_BACKWARD</code>, <code class="literal">gtk.DIR_UP</code>,
<code class="literal">gtk.DIR_DOWN</code>, <code class="literal">gtk.DIR_LEFT</code> or
<code class="literal">gtk.DIR_RIGHT</code></p><p>This method emits the "focus" signal on the widget. Widgets
override the default handler for this signal in order to implement
appropriate focus behavior. The "focus" default handler for a widget should
return:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><code class="literal">True</code> if the focus is left on a
focusable location inside the widget, and</li><li class="listitem"><code class="literal">False</code> if the focus moved outside the
widget</li></ul></div><p>If returning <code class="literal">True</code>, widgets normally call the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">grab_focus</code>()</a> 
method to place the focus accordingly; if returning
<code class="literal">False</code>, they don't modify the current focus
location.</p></div><div class="refsect2" title="gtk.Widget.set_size_request"><a name="method-gtkwidget--set-size-request"></a><h3>gtk.Widget.set_size_request</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_size_request</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>width</code></strong> :</span></p></td><td>the width the widget should request, or -1 to
unset</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height</code></strong> :</span></p></td><td>the height the widget should request, or -1 to
unset</td></tr></tbody></table><p>The <code class="methodname">set_size_request</code>() method sets the
minimum size of a widget to the values specified by
<em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em>. You can use
this method to force a widget to be either larger or smaller than it
normally would be. In most cases, the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size"><code class="methodname">gtk.Window.set_default_size</code>()</a> 
is a better choice for toplevel windows than this method. Setting the
default size will still allow users to shrink the window but setting the
size request will force them to leave the window at least as large as the
size request. When dealing with window sizes, the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-geometry-hints" title="gtk.Window.set_geometry_hints"><code class="methodname">gtk.Window.set_geometry_hints</code>()</a> 
can be a useful method as well.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>There is an inherent danger when setting any fixed size -
themes, translations into other languages, different fonts, and user action
can all change the appropriate size for a given widget. So, it's basically
impossible to hard code a size that will always be correct.</p></div><p>The size request of a widget is the smallest size a widget can
accept while still functioning well and drawing itself correctly. However in
some strange cases a widget may be allocated less than its requested size,
and in many cases a widget may be allocated more space than it requested. If
the size request in a given direction is -1 (unset), then the "natural" size
request of the widget will be used instead. Widgets can't actually be
allocated a size less than 1 by 1, but you can pass 0,0 to this method to
mean "as small as possible".</p></div><div class="refsect2" title="gtk.Widget.get_size_request"><a name="method-gtkwidget--get-size-request"></a><h3>gtk.Widget.get_size_request</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size_request</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the requested width and
	  height</td></tr></tbody></table><p>The <code class="methodname">get_size_request</code>() method returns a
2-tuple containing the width and height of the widget that was explicitly
set for the widget using the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-size-request" title="gtk.Widget.set_size_request"><code class="methodname">set_size_request()</code></a>. A
value of -1 for the width or height indicates that that dimension has not
been set explicitly and the natural requisition of the widget will be used
instead. See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-size-request" title="gtk.Widget.set_size_request"><code class="methodname">set_size_request()</code></a>
method for more information. To get the size a widget will actually use,
call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--size-request" title="gtk.Widget.size_request"><code class="methodname">size_request()</code></a>
instead of this method.</p></div><div class="refsect2" title="gtk.Widget.set_events"><a name="method-gtkwidget--set-events"></a><h3>gtk.Widget.set_events</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_events</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>events</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>events</code></strong> :</span></p></td><td>the event mask</td></tr></tbody></table><p>The <code class="methodname">set_events</code>() method sets the event
mask for a widget using the value specified by
<em class="parameter"><code>events</code></em>. The event mask determines which events a
widget will receive. Keep in mind that different widgets have different
default event masks, and by changing the event mask you may disrupt a
widget's functionality, so be careful. This method must be called while a
widget is unrealized. Consider using the <a class="link" href="class-gtkwidget.html#method-gtkwidget--add-events" title="gtk.Widget.add_events"><code class="methodname">add_events</code>()</a> 
method for widgets that are already realized, or if you want to preserve the
existing event mask. This method can't be used with
<code class="literal">gtk.NO_WINDOW</code> widgets since a widget must have a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> to
receive events. To get events on <code class="literal">gtk.NO_WINDOW</code> widgets,
place them inside a <a class="link" href="class-gtkeventbox.html" title="gtk.EventBox"><code class="classname">gtk.EventBox</code></a> and
receive events on the event box.</p><p>The value of <em class="parameter"><code>events</code></em> must be a combination
of the <a class="xref" href="gdk-constants.html#gdk-event-mask-constants" title="GDK Event Mask Flag Constants">GDK Event Mask Flag Constants</a>:</p></div><div class="refsect2" title="gtk.Widget.add_events"><a name="method-gtkwidget--add-events"></a><h3>gtk.Widget.add_events</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_events</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>events</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>events</code></strong> :</span></p></td><td>an event mask</td></tr></tbody></table><p>The <code class="methodname">add_events</code>() method adds the events
specified by <em class="parameter"><code>events</code></em> to the event mask for the widget.
See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-events" title="gtk.Widget.set_events"><code class="methodname">set_events</code>()</a> 
method for details.</p></div><div class="refsect2" title="gtk.Widget.set_extension_events"><a name="method-gtkwidget--set-extension-events"></a><h3>gtk.Widget.set_extension_events</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_extension_events</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mode</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mode</code></strong> :</span></p></td><td>the extension events to
receive</td></tr></tbody></table><p>The <code class="methodname">set_extension_events</code>() method sets
the extension events mask to the value specified by
<em class="parameter"><code>mode</code></em>. The value of mode must be one of the <a class="xref" href="gdk-constants.html#gdk-extension-mode-constants" title="GDK Extension Mode Constants">GDK Extension Mode Constants</a>.</p><p>See the <a class="link" href="class-gdkwindow.html#method-gdkwindow--input-set-extension-events" title="gtk.gdk.Window.input_set_extension_events"><code class="methodname">gtk.gdk.Window.input_set_extension_events</code>()</a> 
method for more information.</p></div><div class="refsect2" title="gtk.Widget.get_extension_events"><a name="method-gtkwidget--get-extension-events"></a><h3>gtk.Widget.get_extension_events</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_extension_events</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the extension events for the
widget</td></tr></tbody></table><p>The <code class="methodname">get_extension_events</code>() method
returns the extension events the widget will receive. See the <a class="link" href="class-gdkwindow.html#method-gdkwindow--input-set-extension-events" title="gtk.gdk.Window.input_set_extension_events"><code class="methodname">gtk.gdk.Window.input_set_extension_events</code>()</a> 
method for more information.</p></div><div class="refsect2" title="gtk.Widget.get_toplevel"><a name="method-gtkwidget--get-toplevel"></a><h3>gtk.Widget.get_toplevel</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_toplevel</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the topmost ancestor of the widget, or the
widget itself if there's no ancestor.</td></tr></tbody></table><p>The <code class="methodname">get_toplevel</code>() method returns the
topmost widget in the container hierarchy that the widget is a part of. If
the widget has no parent widgets, it will be returned as the topmost
widget.</p><p>Note the difference in behavior as compared to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-ancestor" title="gtk.Widget.get_ancestor"><code class="methodname">get_ancestor</code>()</a> 
method that returns <code class="literal">None</code> if the widget isn't inside a
toplevel window, and if the window is inside a widget derived from <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> that is
in turn inside the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>. While
the second case may seem unlikely, it actually happens when a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> is embedded
inside a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a> within
the same application.</p><p>To reliably find the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>, use the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--get-toplevel" title="gtk.Widget.get_toplevel"><code class="methodname">get_toplevel</code>()</a> 
method and check if the <code class="literal">gtk.TOPLEVEL</code> flag is set on the
result.</p></div><div class="refsect2" title="gtk.Widget.get_ancestor"><a name="method-gtkwidget--get-ancestor"></a><h3>gtk.Widget.get_ancestor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_ancestor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_type</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget_type</code></strong> :</span></p></td><td>a widget type</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the ancestor widget, or <code class="literal">None</code>
if not found</td></tr></tbody></table><p>The <code class="methodname">get_ancestor</code>() method returns the
first ancestor of the widget with the type specified by
<em class="parameter"><code>widget_type</code></em>. For example:</p><pre class="programlisting">
  widget.get_ancestor(gtk.Box)
 </pre><p>returns the first <a class="link" href="class-gtkbox.html" title="gtk.Box"><code class="classname">gtk.Box</code></a> that's an
ancestor of the widget. See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-toplevel" title="gtk.Widget.get_toplevel"><code class="methodname">get_toplevel</code>()</a> 
method for information about checking for a toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>.</p></div><div class="refsect2" title="gtk.Widget.get_colormap"><a name="method-gtkwidget--get-colormap"></a><h3>gtk.Widget.get_colormap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_colormap</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the colormap used by the
widget</td></tr></tbody></table><p>The <code class="methodname">get_colormap</code>() method returns the
colormap that will be used to render the widget.</p></div><div class="refsect2" title="gtk.Widget.get_visual"><a name="method-gtkwidget--get-visual"></a><h3>gtk.Widget.get_visual</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_visual</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the visual for the widget</td></tr></tbody></table><p>The <code class="methodname">get_visual</code>() method returns the
visual that will be used to render the widget.</p></div><div class="refsect2" title="gtk.Widget.get_screen"><a name="method-gtkwidget--get-screen"></a><h3>gtk.Widget.get_screen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_screen</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
	  for the toplevel for this widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">get_screen</code>() method returns the
<a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
from the toplevel window associated with the widget. This method can only be
called after the widget has been added to a widget hierarchy with a <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> at the
top.</p></div><div class="refsect2" title="gtk.Widget.has_screen"><a name="method-gtkwidget--has-screen"></a><h3>gtk.Widget.has_screen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_screen</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if there is a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
	  associated with the widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">has_screen</code>() method returns
<code class="literal">True</code> if a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a> is
associated with the widget. All toplevel widgets have an associated screen,
as do all widgets added into a hierarchy with a toplevel window.</p></div><div class="refsect2" title="gtk.Widget.get_display"><a name="method-gtkwidget--get-display"></a><h3>gtk.Widget.get_display</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_display</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gdkdisplay.html" title="gtk.gdk.Display"><code class="classname">gtk.gdk.Display</code></a>
	  for the toplevel for this widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">get_display</code>() method returns the
<a class="link" href="class-gdkdisplay.html" title="gtk.gdk.Display"><code class="classname">gtk.gdk.Display</code></a> for
the toplevel window associated with the widget. This method can only be
called after the widget has been added to a widget hierarchy with a toplevel
<a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a></p></div><div class="refsect2" title="gtk.Widget.get_root_window"><a name="method-gtkwidget--get-root-window"></a><h3>gtk.Widget.get_root_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_root_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
	  root window for the toplevel for this widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">get_root_window</code>() method returns
the root window containing the widget. This method should only be called
after the widget has been added to a widget hierarchy with a toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a></p><p>The root window is useful for such purposes as creating a popup
<a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> associated with the window.</p></div><div class="refsect2" title="gtk.Widget.get_settings"><a name="method-gtkwidget--get-settings"></a><h3>gtk.Widget.get_settings</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_settings</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the associated <a class="link" href="class-gtksettings.html" title="gtk.Settings"><code class="classname">gtk.Settings</code></a>
object</td></tr></tbody></table><p>The <code class="methodname">get_settings</code>() method returns the
settings object holding the settings (global property settings, RC file
information, etc) used for this widget.</p></div><div class="refsect2" title="gtk.Widget.get_clipboard"><a name="method-gtkwidget--get-clipboard"></a><h3>gtk.Widget.get_clipboard</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_clipboard</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>selection</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>selection</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkatom.html" title="gtk.gdk.Atom"><code class="classname">gtk.gdk.Atom</code></a>
	  or string that identifies the clipboard to
	  use. <code class="literal">gtk.gdk.SELECTION_CLIPBOARD</code> gives the
	  default clipboard. Another common value is
	  <code class="literal">gtk.gdk.SELECTION_PRIMARY</code>, which gives the
	  primary X selection.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the appropriate <a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
	  object. If no clipboard already exists, a new one will be
	  created. Once a clipboard object has been created, it is
	  persistent for all time.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">get_clipboard</code>() method returns the
<a class="link" href="class-gtkclipboard.html" title="gtk.Clipboard"><code class="classname">gtk.Clipboard</code></a>
object for the selection specified by <em class="parameter"><code>selection</code></em>. The
widget must have a <a class="link" href="class-gdkdisplay.html" title="gtk.gdk.Display"><code class="classname">gtk.gdk.Display</code></a>
associated with it, and so must be attached to a toplevel window.</p></div><div class="refsect2" title="gtk.Widget.get_accessible"><a name="method-gtkwidget--get-accessible"></a><h3>gtk.Widget.get_accessible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_accessible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>an <a class="link" href="class-atkobject.html" title="atk.Object"><code class="classname">atk.Object</code></a></td></tr></tbody></table><p>The <code class="methodname">get_accessible</code>() method returns the
      Accessibility ToolKit (ATK) object for the widget as an <a class="link" href="class-atkobject.html" title="atk.Object"><code class="classname">atk.Object</code></a>.</p></div><div class="refsect2" title="gtk.Widget.set_colormap"><a name="method-gtkwidget--set-colormap"></a><h3>gtk.Widget.set_colormap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_colormap</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>colormap</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a></td></tr></tbody></table><p>The <code class="methodname">set_colormap</code>() method sets the
<a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
for the widget to the value specified by <em class="parameter"><code>colormap</code></em>.
Widget must not have been realized.</p></div><div class="refsect2" title="gtk.Widget.get_events"><a name="method-gtkwidget--get-events"></a><h3>gtk.Widget.get_events</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_events</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the event mask for the
widget</td></tr></tbody></table><p>The <code class="methodname">get_events</code>() method returns the
event mask for the widget that determines the events that the widget will
receive. See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-events" title="gtk.Widget.set_events"><code class="methodname">set_events</code>()</a> 
method for more detail about events.</p></div><div class="refsect2" title="gtk.Widget.get_pointer"><a name="method-gtkwidget--get-pointer"></a><h3>gtk.Widget.get_pointer</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_pointer</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the X and Y coordinates of
the mouse pointer</td></tr></tbody></table><p>The <code class="methodname">get_pointer</code>() method returns a
tuple containing the location of the mouse pointer in widget coordinates.
Widget coordinates are a bit odd; for historical reasons, they are defined
as:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">the widget <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
coordinates for widgets that are not <code class="literal">gtk.NO_WINDOW</code>
widgets, or</li><li class="listitem">the coordinates relative to the widget allocation for
widgets that are <code class="literal">gtk.NO_WINDOW</code> widgets.</li></ul></div><p></p></div><div class="refsect2" title="gtk.Widget.is_ancestor"><a name="method-gtkwidget--is-ancestor"></a><h3>gtk.Widget.is_ancestor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_ancestor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>ancestor</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>ancestor</code></strong> :</span></p></td><td>another <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if
<em class="parameter"><code>ancestor</code></em> contains the widget as a child, grandchild,
great grandchild, etc.</td></tr></tbody></table><p>The <code class="methodname">is_ancestor</code>() method returns
<code class="literal">True</code> if the widget is somewhere inside the hierarchy of
the widget specified by<em class="parameter"><code>ancestor</code></em></p></div><div class="refsect2" title="gtk.Widget.translate_coordinates"><a name="method-gtkwidget--translate-coordinates"></a><h3>gtk.Widget.translate_coordinates</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">translate_coordinates</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dest_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>src_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>src_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>dest_widget</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>src_x</code></strong> :</span></p></td><td>the X position relative to the
widget</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>src_y</code></strong> :</span></p></td><td>the Y position relative to the
widget</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the X and Y position
relative to <em class="parameter"><code>dest_widget</code></em></td></tr></tbody></table><p>The <code class="methodname">translate_coordinates</code>() method
returns a tuple containing the translation of the widget x and y coordinates
specified by <em class="parameter"><code>src_x</code></em> and <em class="parameter"><code>src_y</code></em>
respectively to coordinates relative to <em class="parameter"><code>dest_widget</code></em>.
In order to perform this operation, both widgets must be realized, and must
share a common toplevel.</p></div><div class="refsect2" title="gtk.Widget.hide_on_delete"><a name="method-gtkwidget--hide-on-delete"></a><h3>gtk.Widget.hide_on_delete</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">hide_on_delete</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code></td></tr></tbody></table><p>The <code class="methodname">hide_on_delete</code>() method is a
utility method that is intended to be connected to the "delete_event" signal
on a <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>. The
method calls the <a class="link" href="class-gtkwidget.html#method-gtkwidget--hide" title="gtk.Widget.hide"><code class="methodname">hide</code>()</a>
method on the widget, then returns <code class="literal">True</code>. If connected to
"delete_event", the result is that clicking the close button for a window
(on the window frame, top right corner usually) will hide but not destroy
the window. By default, <code class="literal">PyGTK</code> destroys windows when
"delete_event" is received.</p></div><div class="refsect2" title="gtk.Widget.set_style"><a name="method-gtkwidget--set-style"></a><h3>gtk.Widget.set_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_style</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>style</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a>, or
<code class="literal">None</code> to revert to the default style</td></tr></tbody></table><p>The <code class="methodname">set_style</code>() method sets the "style"
property to the value of <em class="parameter"><code>style</code></em>. The "style" property
contains the <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a> for the
widget. This method interacts badly with themes, because themes work by
replacing the <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a>.</p></div><div class="refsect2" title="gtk.Widget.ensure_style"><a name="method-gtkwidget--ensure-style"></a><h3>gtk.Widget.ensure_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">ensure_style</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">ensure_style</code>() method makes sure
that the widget has a style. This method is useful if applied to an
unrealized widget. Usually, if you want the style, the widget is realized,
and guaranteed to have a style.</p></div><div class="refsect2" title="gtk.Widget.get_style"><a name="method-gtkwidget--get-style"></a><h3>gtk.Widget.get_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the widget's <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a></td></tr></tbody></table><p>The <code class="methodname">get_style</code>() method returns the
value of the "style" property.</p></div><div class="refsect2" title="gtk.Widget.modify_style"><a name="method-gtkwidget--modify-style"></a><h3>gtk.Widget.modify_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_style</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>style</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkrcstyle.html" title="gtk.RcStyle"><code class="classname">gtk.RcStyle</code></a> holding
the style modifications</td></tr></tbody></table><p>The <code class="methodname">modify_style</code>() method modifies the
style values on the widget using the values in <em class="parameter"><code>style</code></em>.
Modifications made using this technique take precedence over style values
set via an RC file, however, they will be overridden if a style is explicitly
set on the widget using the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-style" title="gtk.Widget.set_style"><code class="methodname">set_style</code>()</a> 
method. The <a class="link" href="class-gtkrcstyle.html" title="gtk.RcStyle"><code class="classname">gtk.RcStyle</code></a> object
is designed so each attribute can either be set or unset, so it is possible,
using this method, to modify some style values and leave the others
unchanged.</p><p>Note that modifications made with this method are not cumulative
with previous calls to the <code class="methodname">modify_style</code>() method or
with such methods as the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-fg" title="gtk.Widget.modify_fg"><code class="methodname">modify_fg</code>()</a> 
method. If you wish to retain previous values, you must first call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-modifier-style" title="gtk.Widget.get_modifier_style"><code class="methodname">get_modifier_style</code>()</a> 
method, make your modifications to the returned style, then call the
<code class="methodname">modify_style</code>() method with that style. On the other
hand, if you first call the <code class="methodname">modify_style</code>() method,
subsequent calls to such methods as the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-fg" title="gtk.Widget.modify_fg"><code class="methodname">modify_fg</code>()</a> 
method will have a cumulative effect with the initial modifications.</p></div><div class="refsect2" title="gtk.Widget.get_modifier_style"><a name="method-gtkwidget--get-modifier-style"></a><h3>gtk.Widget.get_modifier_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_modifier_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the modifier style for the widget. This <a class="link" href="class-gtkrcstyle.html" title="gtk.RcStyle"><code class="classname">gtk.RcStyle</code></a> is
owned by the widget.</td></tr></tbody></table><p>The <code class="methodname">get_modifier_style</code>() method returns
the current modifier style for the widget as set by the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-style" title="gtk.Widget.modify_style"><code class="methodname">modify_style</code>()</a> 
method. If no style was previously set, a new <a class="link" href="class-gtkrcstyle.html" title="gtk.RcStyle"><code class="classname">gtk.RcStyle</code></a> object
will be created( with all values unset), and set as the modifier style for
the widget. If you make changes to this rc style, you must call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-style" title="gtk.Widget.modify_style"><code class="methodname">modify_style</code>()</a> 
method, passing in the returned rc style, to make sure that your changes
take effect.</p><div class="caution" title="Caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3><p>Passing the style back to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-style" title="gtk.Widget.modify_style"><code class="methodname">modify_style</code>()</a> 
method will normally end up destroying it, because the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-style" title="gtk.Widget.modify_style"><code class="methodname">modify_style</code>()</a> 
method copies the passed-in style and sets the copy as the new modifier
style, thus dropping any reference to the old modifier style.</p></div></div><div class="refsect2" title="gtk.Widget.modify_fg"><a name="method-gtkwidget--modify-fg"></a><h3>gtk.Widget.modify_fg</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_fg</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>state</code></strong> :</span></p></td><td>a widget state.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>color</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a> to
assign.</td></tr></tbody></table><p>The <code class="methodname">modify_fg</code>() method sets the
foreground color to the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a>
specified by <em class="parameter"><code>color</code></em> for the widget in the specified
<em class="parameter"><code>state</code></em>. All other style values are left untouched. The
value of state must be one of the <a class="xref" href="gtk-constants.html#gtk-state-type-constants" title="GTK State Type Constants">GTK State Type Constants</a>.</p></div><div class="refsect2" title="gtk.Widget.modify_bg"><a name="method-gtkwidget--modify-bg"></a><h3>gtk.Widget.modify_bg</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_bg</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>state</code></strong> :</span></p></td><td>a widget state.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>color</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a> to
assign</td></tr></tbody></table><p>The <code class="methodname">modify_bg</code>() method sets the
background color to the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a>
specified by <em class="parameter"><code>color</code></em> for the widget in the specified
<em class="parameter"><code>state</code></em>. All other style values are left untouched. See
<a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-fg" title="gtk.Widget.modify_fg"><code class="methodname">modify_fg</code>()</a> 
method for detail on the possible values of
<em class="parameter"><code>state</code></em>.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p><code class="methodname">modify_bg</code>() only affects widgets that
have an associated <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>. Widgets
that do not have an associated window include <a class="link" href="class-gtkarrow.html" title="gtk.Arrow"><code class="classname">gtk.Arrow</code></a>, <a class="link" href="class-gtkbin.html" title="gtk.Bin"><code class="classname">gtk.Bin</code></a>, <a class="link" href="class-gtkbox.html" title="gtk.Box"><code class="classname">gtk.Box</code></a>, <a class="link" href="class-gtkbutton.html" title="gtk.Button"><code class="classname">gtk.Button</code></a>, <a class="link" href="class-gtkcheckbutton.html" title="gtk.CheckButton"><code class="classname">gtk.CheckButton</code></a>,
<a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a>,
<a class="link" href="class-gtkimage.html" title="gtk.Image"><code class="classname">gtk.Image</code></a>,
<a class="link" href="class-gtklabel.html" title="gtk.Label"><code class="classname">gtk.Label</code></a>,
<a class="link" href="class-gtkmenuitem.html" title="gtk.MenuItem"><code class="classname">gtk.MenuItem</code></a>,
<a class="link" href="class-gtknotebook.html" title="gtk.Notebook"><code class="classname">gtk.Notebook</code></a>,
<a class="link" href="class-gtkpaned.html" title="gtk.Paned"><code class="classname">gtk.Paned</code></a>,
<a class="link" href="class-gtkradiobutton.html" title="gtk.RadioButton"><code class="classname">gtk.RadioButton</code></a>,
<a class="link" href="class-gtkrange.html" title="gtk.Range"><code class="classname">gtk.Range</code></a>,
<a class="link" href="class-gtkscrolledwindow.html" title="gtk.ScrolledWindow"><code class="classname">gtk.ScrolledWindow</code></a>,
<a class="link" href="class-gtkseparator.html" title="gtk.Separator"><code class="classname">gtk.Separator</code></a>,
<a class="link" href="class-gtktable.html" title="gtk.Table"><code class="classname">gtk.Table</code></a>,
<a class="link" href="class-gtktoolbar.html" title="gtk.Toolbar"><code class="classname">gtk.Toolbar</code></a>,
<a class="link" href="class-gtkaspectframe.html" title="gtk.AspectFrame"><code class="classname">gtk.AspectFrame</code></a>,
<a class="link" href="class-gtkframe.html" title="gtk.Frame"><code class="classname">gtk.Frame</code></a>,
<a class="link" href="class-gtkvbox.html" title="gtk.VBox"><code class="classname">gtk.VBox</code></a>, <a class="link" href="class-gtkhbox.html" title="gtk.HBox"><code class="classname">gtk.HBox</code></a>, <a class="link" href="class-gtkvseparator.html" title="gtk.VSeparator"><code class="classname">gtk.VSeparator</code></a>,
<a class="link" href="class-gtkhseparator.html" title="gtk.HSeparator"><code class="classname">gtk.HSeparator</code></a>. These
widgets can be added to a <a class="link" href="class-gtkeventbox.html" title="gtk.EventBox"><code class="classname">gtk.EventBox</code></a> to
overcome this limitation.</p></div></div><div class="refsect2" title="gtk.Widget.modify_text"><a name="method-gtkwidget--modify-text"></a><h3>gtk.Widget.modify_text</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>state</code></strong> :</span></p></td><td>a widget state.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>color</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a> to
assign.</td></tr></tbody></table><p>The <code class="methodname">modify_text</code>() method sets the text
color to the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a>
specified by <em class="parameter"><code>color</code></em> for the widget in the specified
<em class="parameter"><code>state</code></em>. All other style values are left untouched. The
text color is the foreground color used along with the base color (see the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-base" title="gtk.Widget.modify_base"><code class="methodname">modify_base</code>()</a> 
method) for widgets such as <a class="link" href="class-gtkentry.html" title="gtk.Entry"><code class="classname">gtk.Entry</code></a> and <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a>. See
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-fg" title="gtk.Widget.modify_fg"><code class="methodname">modify_fg</code>()</a> 
method for detail on the possible values of
<em class="parameter"><code>state</code></em>.</p></div><div class="refsect2" title="gtk.Widget.modify_base"><a name="method-gtkwidget--modify-base"></a><h3>gtk.Widget.modify_base</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_base</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>state</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>color</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>state</code></strong> :</span></p></td><td>a widget state.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>color</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a> to
assign</td></tr></tbody></table><p>The <code class="methodname">modify_base</code>() method sets the base
color to the <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a>
specified by <em class="parameter"><code>color</code></em> for the widget in the specified
<em class="parameter"><code>state</code></em>. All other style values are left untouched. The
base color is the background color used along with the text color (see the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-text" title="gtk.Widget.modify_text"><code class="methodname">modify_text</code>()</a> 
method) for widgets such as <a class="link" href="class-gtkentry.html" title="gtk.Entry"><code class="classname">gtk.Entry</code></a> and <a class="link" href="class-gtktextview.html" title="gtk.TextView"><code class="classname">gtk.TextView</code></a>. See
<a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-fg" title="gtk.Widget.modify_fg"><code class="methodname">modify_fg</code>()</a> 
method for detail on the possible values of
<em class="parameter"><code>state</code></em>.</p></div><div class="refsect2" title="gtk.Widget.modify_font"><a name="method-gtkwidget--modify-font"></a><h3>gtk.Widget.modify_font</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_font</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>font_desc</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>font_desc</code></strong> :</span></p></td><td>a font description to use</td></tr></tbody></table><p>The <code class="methodname">modify_font</code>() method sets the font
to use to the value specified by <em class="parameter"><code>font_desc</code></em> for the
widget. All other style values are left untouched.</p></div><div class="refsect2" title="gtk.Widget.create_pango_context"><a name="method-gtkwidget--create-pango-context"></a><h3>gtk.Widget.create_pango_context</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">create_pango_context</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new <a class="link" href="class-pangocontext.html" title="pango.Context"><code class="classname">pango.Context</code></a></td></tr></tbody></table><p>The <code class="methodname">create_pango_context</code>() method
creates a new <a class="link" href="class-pangocontext.html" title="pango.Context"><code class="classname">pango.Context</code></a>
with the appropriate colormap, font description, and base direction for
drawing text for this widget. See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-pango-context" title="gtk.Widget.get_pango_context"><code class="methodname">get_pango_context</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.Widget.get_pango_context"><a name="method-gtkwidget--get-pango-context"></a><h3>gtk.Widget.get_pango_context</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_pango_context</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-pangocontext.html" title="pango.Context"><code class="classname">pango.Context</code></a> for
the widget.</td></tr></tbody></table><p>The <code class="methodname">get_pango_context</code>() method returns
the <a class="link" href="class-pangocontext.html" title="pango.Context"><code class="classname">pango.Context</code></a>
with the appropriate colormap, font description and base direction for this
widget. Unlike the context returned by the <a class="link" href="class-gtkwidget.html#method-gtkwidget--create-pango-context" title="gtk.Widget.create_pango_context"><code class="methodname">create_pango_context</code>()</a> 
method, this context is owned by the widget (it can be used as long as
widget exists), and will be updated to match any changes to the widget's
attributes.</p><p>If you create and keep a <a class="link" href="class-pangolayout.html" title="pango.Layout"><code class="classname">pango.Layout</code></a> using
this context, you must deal with changes to the context by calling the <a class="link" href="class-pangolayout.html#method-pangolayout--context-changed" title="pango.Layout.context_changed"><code class="methodname">pango.Layout.context_changed</code>()</a> 
method on the layout in response to the "style-set" and "direction-set"
signals for the widget.</p></div><div class="refsect2" title="gtk.Widget.create_pango_layout"><a name="method-gtkwidget--create-pango-layout"></a><h3>gtk.Widget.create_pango_layout</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">create_pango_layout</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>the text to set on the
layout</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new <a class="link" href="class-pangolayout.html" title="pango.Layout"><code class="classname">pango.Layout</code></a></td></tr></tbody></table><p>The <code class="methodname">create_pango_layout</code>() method
creates a new <a class="link" href="class-pangolayout.html" title="pango.Layout"><code class="classname">pango.Layout</code></a> with
the appropriate colormap, font description, and base direction for drawing
the specified <em class="parameter"><code>text</code></em> for this widget. If you keep a
<a class="link" href="class-pangolayout.html" title="pango.Layout"><code class="classname">pango.Layout</code></a>
created by this method, you must call <a class="link" href="class-pangolayout.html#method-pangolayout--context-changed" title="pango.Layout.context_changed"><code class="methodname">pango.Layout.context_changed()</code></a> 
in response to the "style-set" and "direction-set" signals for the widget to
notify the layout of changes to the base direction or font of this
widget.</p></div><div class="refsect2" title="gtk.Widget.render_icon"><a name="method-gtkwidget--render-icon"></a><h3>gtk.Widget.render_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">render_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stock_id</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>size</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>detail</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>stock_id</code></strong> :</span></p></td><td>a stock ID</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>size</code></strong> :</span></p></td><td>a stock size</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>detail</code></strong> :</span></p></td><td>the render detail to pass to the theme engine or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new pixbuf, or <code class="literal">None</code> if the
stock ID wasn't known</td></tr></tbody></table><p>The <code class="methodname">render_icon</code>() method is a
convenience method that uses the theme engine and RC file settings for the
widget to look up the stock icon specified by
<em class="parameter"><code>stock_id</code></em> of the specified <em class="parameter"><code>size</code></em>
and to render it to a pixbuf that is returned.
<em class="parameter"><code>stock_id</code></em> should be a stock icon ID such as
<code class="literal">gtk.STOCK_OPEN</code> or <code class="literal">gtk.STOCK_OK</code>.
<em class="parameter"><code>size</code></em> should be one of the <a class="xref" href="gtk-constants.html#gtk-icon-size-constants" title="GTK Icon Size Constants">GTK Icon Size Constants</a>:</p><p><em class="parameter"><code>detail</code></em> is an optional string that
identifies the widget or code doing the rendering, so that theme engines can
special-case rendering for that widget or code.</p></div><div class="refsect2" title="gtk.Widget.set_composite_name"><a name="method-gtkwidget--set-composite-name"></a><h3>gtk.Widget.set_composite_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_composite_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name to set.</td></tr></tbody></table><p>The <code class="methodname">set_composite_name</code>() method sets a
widgets composite name to the value specified by
<em class="parameter"><code>name</code></em>. The widget must be a composite child of its
parent</p></div><div class="refsect2" title="gtk.Widget.get_composite_name"><a name="method-gtkwidget--get-composite-name"></a><h3>gtk.Widget.get_composite_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_composite_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the composite name of the widget or
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">get_composite_name</code>() method returns
the composite name of a widget or <code class="literal">None</code> if the widget is
not a composite.</p></div><div class="refsect2" title="gtk.Widget.reset_rc_styles"><a name="method-gtkwidget--reset-rc-styles"></a><h3>gtk.Widget.reset_rc_styles</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">reset_rc_styles</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">reset_rc_styles</code>() method resets the
styles of widget and all descendants to the correct values for the currently
loaded RC file settings. This method is not useful for applications.</p></div><div class="refsect2" title="gtk.Widget.style_get_property"><a name="method-gtkwidget--style-get-property"></a><h3>gtk.Widget.style_get_property</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">style_get_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>property_name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>property_name</code></strong> :</span></p></td><td>the name of a style property</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the property value</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">style_get_property</code>() method returns
the value of a style property specified by
<em class="parameter"><code>property_name</code></em>.</p></div><div class="refsect2" title="gtk.Widget.set_direction"><a name="method-gtkwidget--set-direction"></a><h3>gtk.Widget.set_direction</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_direction</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dir</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>dir</code></strong> :</span></p></td><td>the new direction</td></tr></tbody></table><p>The <code class="methodname">set_direction</code>() method sets the
"direction" property to the value specified by <em class="parameter"><code>dir</code></em>.
The "direction" property determines the reading direction of the widget that
controls the primary direction for widgets containing text, and also the
direction in which the children of a container are packed. The ability to
set the direction is to handle localization for languages with right-to-left
reading directions. Generally, applications will use the default reading
direction, except for containers that are arranged in an order that is
explicitly visual rather than logical (such as buttons for text
justification). The values of <em class="parameter"><code>dir</code></em> must be one of the
<a class="xref" href="gtk-constants.html#gtk-text-direction-constants" title="GTK Text Direction Constants">GTK Text Direction Constants</a>.</p><p>If the direction is set to <code class="literal">gtk.TEXT_DIR_NONE</code>,
then the value set by the <a class="link" href="class-gtkwidget.html#function-gtk--widget-set-default-direction" title="gtk.widget_set_default_direction"><code class="function">gtk.widget.set_default_direction</code>()</a>
function will be used.</p></div><div class="refsect2" title="gtk.Widget.get_direction"><a name="method-gtkwidget--get-direction"></a><h3>gtk.Widget.get_direction</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_direction</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the reading direction for the
widget.</td></tr></tbody></table><p>The <code class="methodname">get_direction</code>() method returns the
reading direction for the widget. See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-direction" title="gtk.Widget.set_direction"><code class="methodname">set_direction</code>()</a> 
method for more information.</p></div><div class="refsect2" title="gtk.Widget.shape_combine_mask"><a name="method-gtkwidget--shape-combine-mask"></a><h3>gtk.Widget.shape_combine_mask</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">shape_combine_mask</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>shape_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>shape_mask</code></strong> :</span></p></td><td>the shape to be added.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>offset_x</code></strong> :</span></p></td><td>the X position of shape mask with respect to
the widget's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>offset_y</code></strong> :</span></p></td><td>Y position of shape mask with respect to the
widget's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>.</td></tr></tbody></table><p>The <code class="methodname">shape_combine_mask</code>() method sets a
shape for the widget's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> using
the mask specified by <em class="parameter"><code>shape_mask</code></em> at the location
specified by <em class="parameter"><code>offset_x</code></em> and
<em class="parameter"><code>offset_y</code></em>. This allows for transparent windows etc.,
see the <a class="link" href="class-gdkwindow.html#method-gdkwindow--shape-combine-mask" title="gtk.gdk.Window.shape_combine_mask"><code class="methodname">gtk.gdk.Window.shape_combine_mask</code>()</a> 
method for more information.</p></div><div class="refsect2" title="gtk.Widget.reset_shapes"><a name="method-gtkwidget--reset-shapes"></a><h3>gtk.Widget.reset_shapes</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">reset_shapes</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">reset_shapes</code>() method recursively
resets the shapes of the widget and its descendants.</p></div><div class="refsect2" title="gtk.Widget.path"><a name="method-gtkwidget--path"></a><h3>gtk.Widget.path</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">path</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the widget's path</td></tr></tbody></table><p>The <code class="methodname">path</code>() method returns the full path
to the widget. The path is simply the name of a widget and all its parents
in the container hierarchy, separated by periods. The name of a widget comes
from the <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-name" title="gtk.Widget.get_name"><code class="methodname">get_name</code>()</a> 
method. Paths are used to apply styles to a widget in gtkrc configuration
files.  Widget names are the type of the widget by default (e.g.
"GtkButton") or can be set to an application-specific value with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-name" title="gtk.Widget.set_name"><code class="methodname">set_name</code>()</a> 
method.  By setting the name of a widget, you allow users or theme authors
to apply styles to that specific widget in their gtkrc file.</p></div><div class="refsect2" title="gtk.Widget.class_path"><a name="method-gtkwidget--class-path"></a><h3>gtk.Widget.class_path</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">class_path</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the widget's class path</td></tr></tbody></table><p>The <code class="methodname">class_path</code>() method is similar to
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--path" title="gtk.Widget.path"><code class="methodname">path</code>()</a>
method, but does not use a custom name set with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-name" title="gtk.Widget.set_name"><code class="methodname">set_name</code>()</a> 
(e.g. always uses "GtkButton" even if a custom name is available).</p></div><div class="refsect2" title="gtk.Widget.list_mnemonic_labels"><a name="method-gtkwidget--list-mnemonic-labels"></a><h3>gtk.Widget.list_mnemonic_labels</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">list_mnemonic_labels</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the list of mnemonic labels</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">list_mnemonic_labels</code>() method
returns a list of the widgets, normally labels, for which this widget is a
the target of a mnemonic (see for example, the <a class="link" href="class-gtklabel.html#method-gtklabel--set-mnemonic-widget" title="gtk.Label.set_mnemonic_widget"><code class="function">gtk.Label.set_mnemonic_widget()</code></a>
method).</p></div><div class="refsect2" title="gtk.Widget.add_mnemonic_label"><a name="method-gtkwidget--add-mnemonic-label"></a><h3>gtk.Widget.add_mnemonic_label</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_mnemonic_label</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>label</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td><td>a <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
	  that acts as a mnemonic label.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">add_mnemonic_label</code>() method adds
the widget specified by <em class="parameter"><code>label</code></em> to the list of mnemonic
labels for the widget.(See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--list-mnemonic-labels" title="gtk.Widget.list_mnemonic_labels"><code class="methodname">list_mnemonic_labels()</code></a>
method for more detail).</p></div><div class="refsect2" title="gtk.Widget.remove_mnemonic_label"><a name="method-gtkwidget--remove-mnemonic-label"></a><h3>gtk.Widget.remove_mnemonic_label</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_mnemonic_label</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>label</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td><td>a <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
	  that was previously set as a mnemonic label.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">remove_mnemonic_label</code>() method
removes the widget specified by <em class="parameter"><code>label</code></em> from the list
of mnemonic labels for the widget. (See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--list-mnemonic-labels" title="gtk.Widget.list_mnemonic_labels"><code class="methodname">list_mnemonic_labels()</code></a>
method). <em class="parameter"><code>label</code></em> must have previously been added to the
list with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--add-mnemonic-label" title="gtk.Widget.add_mnemonic_label"><code class="methodname">add_mnemonic_label()</code></a>.</p></div><div class="refsect2" title="gtk.Widget.menu_get_for_attach_widget"><a name="method-gtkwidget--menu-get-for-attach-widget"></a><h3>gtk.Widget.menu_get_for_attach_widget</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">menu_get_for_attach_widget</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of menus attached to this widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">menu_get_for_attach_widget</code>() method
returns a list of the menus that are attached to this widget.</p></div><div class="refsect2" title="gtk.Widget.set_activate_signal"><a name="method-gtkwidget--set-activate-signal"></a><h3>gtk.Widget.set_activate_signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_activate_signal</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>signal_name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>signal_name</em></span> :</span></p></td><td>a signal name</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_activate_signal</code>() method sets
the signal specified by <em class="parameter"><code>signal_name</code></em> as the signal to
be emitted when the widget is activated for example by a call to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--activate" title="gtk.Widget.activate"><code class="methodname">activate</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Widget.set_set_scroll_adjustments_signal"><a name="method-gtkwidget--set-set-scroll-adjustments-signal"></a><h3>gtk.Widget.set_set_scroll_adjustments_signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_set_scroll_adjustments_signal</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>signal_name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>signal_name</em></span> :</span></p></td><td>a signal name</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_scroll_adjustments_signal</code>()
method sets the signal specified by <em class="parameter"><code>signal_name</code></em> as
the signal to be emitted when the widget has its scroll adjustments set for
example by a call to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-scroll-adjustments" title="gtk.Widget.set_scroll_adjustments"><code class="methodname">set_scroll_adjustments</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Widget.get_action"><a name="method-gtkwidget--get-action"></a><h3>gtk.Widget.get_action</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_action</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gtkaction.html" title="gtk.Action"><code class="classname">gtk.Action</code></a>
          that a widget is a proxy for, or <code class="literal">None</code>, if it is
          not attached to an action.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_action</code>() method returns the
      <a class="link" href="class-gtkaction.html" title="gtk.Action"><code class="classname">gtk.Action</code></a>
      that <em class="parameter"><code>widget</code></em> is a proxy for.  See also the <a class="link" href="class-gtkaction.html#method-gtkaction--get-proxies" title="gtk.Action.get_proxies"><code class="methodname">gtk.Action.get_proxies()</code></a>
      method.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_set_track_motion"><a name="method-gtkwidget--drag-dest-set-track-motion"></a><h3>gtk.Widget.drag_dest_set_track_motion</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_set_track_motion</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>track_motion</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>track_motion</code></strong> :</span></p></td><td>if <code class="literal">True</code> accept all
          targets</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">drag_dest_set_track_motion</code>() method
      tells the widget to emit "drag-motion" and "drag-leave" events
      regardless of the targets and the
      <code class="literal">gtk.DEST_DEFAULT_MOTION</code> flag.</p><p>This may be used when a widget wants to do generic actions
      regardless of the targets that the source offers.</p></div><div class="refsect2" title="gtk.Widget.drag_dest_get_track_motion"><a name="method-gtkwidget--drag-dest-get-track-motion"></a><h3>gtk.Widget.drag_dest_get_track_motion</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">drag_dest_get_track_motion</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget always
          emits "drag-motion events"</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">drag_dest_get_track_motion</code>() method
      returns <code class="literal">True</code> if the widget has been configured to
      always emit "drag-motion" signals.</p></div><div class="refsect2" title="gtk.Widget.is_composited"><a name="method-gtkwidget--is-composited"></a><h3>gtk.Widget.is_composited</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_composited</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget can rely
          on its alpha channel being drawn correctly.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">is_composited</code>() method returns
      <code class="literal">True</code> if the widget can rely on having its alpha
      channel drawn correctly. On X11 this function returns whether a
      compositing manager is running for the widget's screen</p></div><div class="refsect2" title="gtk.Widget.input_shape_combine_mask"><a name="method-gtkwidget--input-shape-combine-mask"></a><h3>gtk.Widget.input_shape_combine_mask</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">input_shape_combine_mask</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>shape_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>offset_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>shape_mask</code></strong> :</span></p></td><td>shape to be added, or <code class="literal">None</code>
          to remove an existing shape.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>offset_x</code></strong> :</span></p></td><td>X position of <em class="parameter"><code>shape_mask</code></em>
          with respect to the widget's window.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>offset_y</code></strong> :</span></p></td><td>Y position of <em class="parameter"><code>shape_mask</code></em>
          with respect to the widget's window.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">input_shape_combine_mask</code>() method
      sets an input shape for this widget's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>.
      This allows for windows that react to a mouse click in a
      nonrectangular region, see the <a class="link" href="class-gdkwindow.html#method-gdkwindow--input-shape-combine-mask" title="gtk.gdk.Window.input_shape_combine_mask"><code class="methodname">gtk.gdk.Window.input_shape_combine_mask</code>()</a>
      method for more information.</p></div><div class="refsect2" title="gtk.Widget.get_activate_signal"><a name="method-gtkwidget--get-activate-signal"></a><h3>gtk.Widget.get_activate_signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_activate_signal</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a signal name</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_activate_signal</code>() method
      returns the name of the signal that is emitted when the widget is
      activated for example by a call to the <a class="link" href="class-gtkwidget.html#method-gtkwidget--activate" title="gtk.Widget.activate"><code class="methodname">activate</code>()</a>
      method. See the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-activate-signal" title="gtk.Widget.set_activate_signal"><code class="methodname">set_activate_signal</code>()</a>
      method for more information.</p></div><div class="refsect2" title="gtk.Widget.error_bell"><a name="method-gtkwidget--error-bell"></a><h3>gtk.Widget.error_bell</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">error_bell</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">error_bell</code>() method
            notifies the user about an input-related error on this widget. If the
            GtkSettings:gtk-error-bell setting is <code class="literal">True</code>, it calls
            <a class="link" href="class-gdkwindow.html#method-gdkwindow--beep" title="gtk.gdk.Window.beep"><code class="methodname">gtk.gdk.Window.beep</code>()</a>,
            otherwise it does nothing. Note that the effect of
            <a class="link" href="class-gdkwindow.html#method-gdkwindow--beep" title="gtk.gdk.Window.beep"><code class="methodname">gtk.gdk.Window.beep</code>()</a>
            can be configured in many ways, depending on the windowing backend and
            the desktop environment or window manager that is used.
        </p></div><div class="refsect2" title="gtk.Widget.get_has_tooltip"><a name="method-gtkwidget--get-has-tooltip"></a><h3>gtk.Widget.get_has_tooltip</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_has_tooltip</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the current value of has-tooltip on widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">get_has_tooltip</code>() method
            returns the current value of the has-tooltip property.
            See <a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">GtkWidget:has-tooltip</a>
            for more information.
        </p></div><div class="refsect2" title="gtk.Widget.get_tooltip_markup"><a name="method-gtkwidget--get-tooltip-markup"></a><h3>gtk.Widget.get_tooltip_markup</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_tooltip_markup</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the tooltip text, or
                        <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">get_tooltip_markup</code>() method
            gets the contents of the tooltip for widget.
        </p></div><div class="refsect2" title="gtk.Widget.get_tooltip_text"><a name="method-gtkwidget--get-tooltip-text"></a><h3>gtk.Widget.get_tooltip_text</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_tooltip_text</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the tooltip text, or
                        <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">get_tooltip_text</code>() method
            gets the contents of the tooltip for widget.
        </p></div><div class="refsect2" title="gtk.Widget.get_tooltip_window"><a name="method-gtkwidget--get-tooltip-window"></a><h3>gtk.Widget.get_tooltip_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_tooltip_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code>
                        </a> of the current tooltip.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">get_tooltip_window</code>() method
            returns the <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
            of the current tooltip. This can be the
            <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
            created by default, or the custom tooltip window set using
            <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-tooltip-window" title="gtk.Widget.set_tooltip_window"><code class="methodname">gtk.Widget.set_tooltip_window</code></a>().
        </p></div><div class="refsect2" title="gtk.Widget.keynav_failed"><a name="method-gtkwidget--keynav-failed"></a><h3>gtk.Widget.keynav_failed</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">keynav_failed</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>direction</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>direction</code></strong> :</span></p></td><td>direction of focus movement.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if stopping keyboard
                        navigation is fine, <code class="literal">False</code>  if the emitting
                        widget should try to handle the keyboard navigation
                        attempt in its parent container(s).</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">keynav_failed</code>() should be called whenever keyboard
            navigation within a single widget hits a boundary. The function emits
            the GtkWidget::keynav-changed signal on the widget and its return value
            should be interpreted in a way similar to the return value of
            <code class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--child-focus" title="gtk.Widget.child_focus">gtk.Widget.child_focus</a></code>():
        </p><p>
            When <code class="literal">True</code> is returned, stay in the widget, the failed
            keyboard navigation is Ok and/or there is nowhere we can/should move the focus to.
        </p><p>
            When <code class="literal">False</code> is returned, the caller should continue with
            keyboard navigation outside the widget, e.g. by calling gtk_widget_child_focus()
            on the widget's toplevel.
        </p><p>
            The default ::keynav-failed handler returns <code class="literal">True</code> for
            gtk.DIR_TAB_FORWARD and gtk.DIR_TAB_BACKWARD. For the other values of
            GtkDirectionType, it looks at the GtkSettings:gtk-keynav-cursor-only"
            setting and returns <code class="literal">False</code> if the setting is <code class="literal">True</code>
            This way the entire user interface becomes cursor-navigatable on input
            devices such as mobile phones which only have cursor keys but no tab key.
        </p><p>
            Whenever the default handler returns <code class="literal">True</code>, it also
            calls <code class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--error-bell" title="gtk.Widget.error_bell">gtk.Widget.error_bell</a></code>()
            to notify the user of the failed keyboard navigation.
        </p><p>
            A use case for providing an own implementation of ::keynav-failed (either
            by connecting to it or by overriding it) would be a row of GtkEntry
            widgets where the user should be able to navigate the entire row with
            the cursor keys, as e.g. known from user interfaces that require entering license keys.
        </p></div><div class="refsect2" title="gtk.Widget.modify_cursor"><a name="method-gtkwidget--modify-cursor"></a><h3>gtk.Widget.modify_cursor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">modify_cursor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>primary</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>secondary</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>primary</code></strong> :</span></p></td><td>the color to use for primary cursor (does not
                        need to be allocated), or <code class="literal">None</code> to undo the effect
                        of previous calls to of
                        <code class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-cursor" title="gtk.Widget.modify_cursor">gtk.Widget.modify_cursor</a>
                        </code>().</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>secondary</code></strong> :</span></p></td><td>the color to use for secondary cursor (does not
                        need to be allocated), or <code class="literal">None</code> to undo the effect
                        of previous calls to of
                        <code class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-cursor" title="gtk.Widget.modify_cursor">gtk.Widget.modify_cursor</a>
                        </code>().</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">modify_cursor</code>() sets the cursor color to
            use in a widget, overriding the GtkWidget:cursor-color and
            GtkWidget:secondary-cursor-color style properties. All other style
            values are left untouched. See also <code class="methodname">
            <a class="link" href="class-gtkwidget.html#method-gtkwidget--modify-style" title="gtk.Widget.modify_style">gtk.Widget.modify_style</a></code>().
        </p></div><div class="refsect2" title="gtk.Widget.set_has_tooltip"><a name="method-gtkwidget--set-has-tooltip"></a><h3>gtk.Widget.set_has_tooltip</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_has_tooltip</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>has_tooltip</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>has_tooltip</code></strong> :</span></p></td><td>whether or not widget has a tooltip.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">set_has_tooltip</code>() sets the has-tooltip
            property on widget to <em class="parameter"><code>has_tooltip</code></em>. See
            GtkWidget:has-tooltip for more information.
        </p></div><div class="refsect2" title="gtk.Widget.set_tooltip_markup"><a name="method-gtkwidget--set-tooltip-markup"></a><h3>gtk.Widget.set_tooltip_markup</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_tooltip_markup</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>markup</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>markup</code></strong> :</span></p></td><td>the contents of the tooltip for widget, or
                        <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">set_tooltip_markup</code>() sets markup as the
            contents of the tooltip, which is marked up with the Pango text markup language.
            This function will take care of setting GtkWidget:has-tooltip to
            <code class="literal">True</code> and of the default handler for the GtkWidget::query-tooltip signal.
            See also the GtkWidget:tooltip-markup property and
            <code class="methodname"><a class="link" href="class-gtktooltip.html#method-gtktooltip--set-markup" title="gtk.Tooltip.set_markup">gtk.Tooltip.set_markup</a></code>().
        </p></div><div class="refsect2" title="gtk.Widget.set_tooltip_text"><a name="method-gtkwidget--set-tooltip-text"></a><h3>gtk.Widget.set_tooltip_text</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_tooltip_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>the contents of the tooltip for widget, or
                        <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">set_tooltip_text</code>() sets <em class="parameter"><code>text</code></em>
            as the contents of the tooltip. This function will take care of setting
            GtkWidget:has-tooltip to <code class="literal">True</code> and of the default handler
            for the GtkWidget::query-tooltip signal. See also the GtkWidget:tooltip-text
            property and <code class="methodname"><a class="link" href="class-gtktooltip.html#method-gtktooltip--set-text" title="gtk.Tooltip.set_text">gtk.Tooltip.set_text</a></code>().
        </p></div><div class="refsect2" title="gtk.Widget.set_tooltip_window"><a name="method-gtkwidget--set-tooltip-window"></a><h3>gtk.Widget.set_tooltip_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_tooltip_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>custom_window</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>custom_window</code></strong> :</span></p></td><td>a
                        <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>,
                        or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">set_tooltip_window</code>() replaces the
            default, usually yellow, window used for displaying tooltips with
            <em class="parameter"><code>custom_window</code></em>. GTK+ will take care of showing
            and hiding custom_window at the right moment, to behave likewise as
            the default tooltip window. If custom_window is <code class="literal">None</code>,
            the default tooltip window will be used.            
        </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
	  You have to connect to the <a class="link" href="class-gtkwidget.html#signal-gtkwidget--query-tooltip" title='The "query-tooltip" gtk.Widget Signal'>"query-tooltip"</a>
	  signal a callback to decide if the custom_window should be shown or not, return <code class="literal">True</code>
	  if you want to show the custom_window, False otherwise.
	  You have also to set the property "has-tooltip" to <code class="literal">True</code> or the "query-tooltip"
	  signal will not be emitted.
	</div></div><div class="refsect2" title="gtk.Widget.trigger_tooltip_query"><a name="method-gtkwidget--trigger-tooltip-query"></a><h3>gtk.Widget.trigger_tooltip_query</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">trigger_tooltip_query</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">trigger_tooltip_query</code>() triggers a tooltip
            query on the display where the toplevel of widget is located. See
            <code class="methodname"><a class="link" href="class-gtktooltip.html#function-gtk--tooltip-trigger-tooltip-query" title="gtk.tooltip_trigger_tooltip_query">gtk.tooltip_trigger_tooltip_query</a>
            </code>() for more information.
        </p></div><div class="refsect2" title="gtk.Widget.get_snapshot"><a name="method-gtkwidget--get-snapshot"></a><h3>gtk.Widget.get_snapshot</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_snapshot</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>clip_rect</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>clip_rect</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
			or <code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The <a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap">
			<code class="classname">gtk.gdk.PixmapWindow</code></a>
			snapshot of the widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
            The <code class="methodname">get_snapshot</code>() method
            creates a <a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><code class="classname">gtk.gdk.Pixmap</code></a>
            of the contents of the widget and its children.
	</p><p>
	    Works even if the widget is obscured. The depth and visual of the resulting pixmap
	    is dependent on the widget being snapshot and likely differs from those of a
	    target widget displaying the pixmap. The function
	    <a class="link" href="class-gdkpixbuf.html#method-gdkpixbuf--get-from-drawable" title="gtk.gdk.Pixbuf.get_from_drawable"><code class="methodname">gtk.gdk.Pixbuf.get_from_drawable</code></a>()
	    can be used to convert the pixmap to a visual independant representation.
        </p><p>
	    The snapshot area used by this function is the widget's allocation
	    plus any extra space occupied by additional windows belonging to
	    this widget (such as the arrows of a spin button). Thus, the resulting
	    snapshot pixmap is possibly larger than the allocation.
	</p><p>
	    If clip_rect is non-<code class="literal">None</code>, the resulting pixmap is shrunken
	    to match the specified clip_rect. The (x,y) coordinates of clip_rect are
	    interpreted widget relative. If width or height of clip_rect are 0 or negative,
	    the width or height of the resulting pixmap will be shrunken by the respective amount.
	    For instance a clip_rect { +5, +5, -10, -10 } will chop off 5 pixels at each side
	    of the snapshot pixmap. If non-NULL, clip_rect will contain the exact widget-relative
	    snapshot coordinates upon return. A clip_rect of { -1, -1, 0, 0 } can be used to preserve
	    the auto-grown snapshot area and use clip_rect as a pure output parameter.
	</p><p>
	    The returned pixmap can be <code class="literal">None</code>, if the resulting clip_area was empty.
	</p></div><div class="refsect2" title="gtk.Widget.get_window"><a name="method-gtkwidget--get-window"></a><h3>gtk.Widget.get_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the widget's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code>
                        </a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
            The <code class="methodname">get_window</code>() method
            returns the widget's <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
	    if it is realized, <code class="literal">None</code> otherwise.
        </p></div><div class="refsect2" title="gtk.Widget.send_focus_change"><a name="method-gtkwidget--send-focus-change"></a><h3>gtk.Widget.send_focus_change</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">send_focus_change</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>a FOCUS_CHANGE <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the return value from the event signal emission: <code class="literal">True</code> if the event was handled, and <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">send_focus_change</code>() method ends the focus change
      <em class="parameter"><code>event</code></em> to the widget.</p><p>This method is not meant to be used by applications. The only time it should be used is when it is necessary for a
      <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to assign focus to a widget that is semantically
      owned by the first widget even though it's not a direct child - for instance, a search entry in a floating window similar
      to the quick search in <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>.</p></div><div class="refsect2" title="gtk.Widget.set_realized"><a name="method-gtkwidget--set-realized"></a><h3>gtk.Widget.set_realized</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_realized</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>realized</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>realized</code></strong> :</span></p></td><td><code class="literal">True</code> to mark the widget as realized, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_realized</code>() method marks the widget as being realized.</p><p>This method should only ever be called in a derived widget's "realize" or "unrealize" implementation.</p></div><div class="refsect2" title="gtk.Widget.get_realized"><a name="method-gtkwidget--get-realized"></a><h3>gtk.Widget.get_realized</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_realized</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if widget is realized, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_realized</code>() method determines whether widget is realized.</p></div><div class="refsect2" title="gtk.Widget.set_mapped"><a name="method-gtkwidget--set-mapped"></a><h3>gtk.Widget.set_mapped</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_mapped</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mapped</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mapped</code></strong> :</span></p></td><td><code class="literal">True</code> to mark the widget as mapped, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_mapped</code>() method marks the widget as being mapped.</p></div><div class="refsect2" title="gtk.Widget.get_mapped"><a name="method-gtkwidget--get-mapped"></a><h3>gtk.Widget.get_mapped</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_mapped</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is mapped, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_mapped</code>() method determines whether
      the widget is mapped.</p></div><div class="refsect2" title="gtk.Widget.get_requisition"><a name="method-gtkwidget--get-requisition"></a><h3>gtk.Widget.get_requisition</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_requisition</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>requisition</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gtkrequisition.html" title="gtk.Requisition"><code class="classname">gtk.Requisition</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_requisition</code>() method retrieves the widget's requisition.</p><p>This method should only be used by widget implementations in order to figure whether the widget's
      requisition has actually changed after some internal state change (so that they can call
      <a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-resize" title="gtk.Widget.queue_resize"><code class="methodname">queue_resize</code></a>()
      instead of
      <a class="link" href="class-gtkwidget.html#method-gtkwidget--queue-draw" title="gtk.Widget.queue_draw"><code class="methodname">gtk.Widget.queue_draw</code></a>()).</p></div><div class="refsect2" title="gtk.Widget.style_attach"><a name="method-gtkwidget--style-attach"></a><h3>gtk.Widget.style_attach</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">style_attach</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">style_attach</code>() method attaches the widget's
      <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a> to the widget's
      <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>. It is a
      replacement for the <a class="link" href="class-gtkstyle.html#method-gtkstyle--attach" title="gtk.Style.attach"><code class="methodname">gtk.Style.attach</code></a>()
      method and should only ever be called in a derived widget's "realize" implementation which
      does not chain up to its parent class' "realize" implementation, because one of the parent
      classes (finally <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>)
      would attach the style itself.</p></div><div class="refsect2" title="gtk.Widget.has_rc_style"><a name="method-gtkwidget--has-rc-style"></a><h3>gtk.Widget.has_rc_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_rc_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code>if the widget has been looked up through the rc mechanism, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">has_rc_style</code>() method determines
      if the widget style has been looked up through the rc mechanism.</p></div><div class="refsect2" title="gtk.Widget.get_app_paintable"><a name="method-gtkwidget--get-app-paintable"></a><h3>gtk.Widget.get_app_paintable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_app_paintable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is app paintable, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_app_paintable</code>() method determines
      whether the application intends to draw on the widget in an "expose-event"
      handler.</p></div><div class="refsect2" title="gtk.Widget.set_can_default"><a name="method-gtkwidget--set-can-default"></a><h3>gtk.Widget.set_can_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_can_default</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>can_default</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>can_default</code></strong> :</span></p></td><td><code class="literal">True</code> if the widget can be a default widget, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_can_default</code>() method specifies whether
      the widget can be a default widget. See <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-default" title="gtk.Widget.grab_default"><code class="methodname">gtk.Widget.grab_default</code>()</a>
      for details about the meaning of "default".</p></div><div class="refsect2" title="gtk.Widget.get_can_default"><a name="method-gtkwidget--get-can-default"></a><h3>gtk.Widget.get_can_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_can_default</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if widget can be a default widget, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_can_default</code>() method determines whether
      widget can be a default widget.</p></div><div class="refsect2" title="gtk.Widget.set_can_focus"><a name="method-gtkwidget--set-can-focus"></a><h3>gtk.Widget.set_can_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_can_focus</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>can_focus</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>can_focus</code></strong> :</span></p></td><td><code class="literal">True</code> if the widget can own the input focus, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_can_focus</code>() method specifies whether
      the widget can own the input focus. See
      <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">grab_focus</code>()</a>
      for actually setting the input focus on a widget.</p></div><div class="refsect2" title="gtk.Widget.get_can_focus"><a name="method-gtkwidget--get-can-focus"></a><h3>gtk.Widget.get_can_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_can_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget can own the input focus, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_can_focus</code>() method determines whether
      widget can own the input focus.</p></div><div class="refsect2" title="gtk.Widget.get_double_buffered"><a name="method-gtkwidget--get-double-buffered"></a><h3>gtk.Widget.get_double_buffered</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_double_buffered</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is double buffered, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_double_buffered</code>() method determines whether
      the widget is double buffered.</p></div><div class="refsect2" title="gtk.Widget.set_has_window"><a name="method-gtkwidget--set-has-window"></a><h3>gtk.Widget.set_has_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_has_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>has_window</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>has_window</code></strong> :</span></p></td><td><code class="literal">True</code> if the widget has a window, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_has_window</code>() method specifies whether
      the widget has a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
      of its own. Note that all realized widgets have a non-<code class="literal">None</code> "window"
      (<a class="link" href="class-gtkwidget.html#method-gtkwidget--get-window" title="gtk.Widget.get_window"><code class="methodname">get_window</code></a>()
      never returns a <code class="literal">None</code> window when a widget is realized), but for many of them it's
      actually the <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> of one
      of its parent widgets. Widgets that do not create a window for themselves in their "realize" implementation
      must announce this by calling this function with <em class="parameter"><code>has_window</code></em> = <code class="literal">False</code>.</p></div><div class="refsect2" title="gtk.Widget.get_has_window"><a name="method-gtkwidget--get-has-window"></a><h3>gtk.Widget.get_has_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_has_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if widget has a window, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_has_window</code>() method determines whether
      widget has a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> of its own.</p></div><div class="refsect2" title="gtk.Widget.set_receives_default"><a name="method-gtkwidget--set-receives-default"></a><h3>gtk.Widget.set_receives_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_receives_default</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>receives_default</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>receives_default</code></strong> :</span></p></td><td><code class="literal">True</code> if the widget can be a default widget, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_receives_default</code>() method specifies whether
      the widget will be treated as the default widget within its toplevel when it has the
      focus, even if another widget is the default.</p></div><div class="refsect2" title="gtk.Widget.get_receives_default"><a name="method-gtkwidget--get-receives-default"></a><h3>gtk.Widget.get_receives_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_receives_default</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if widget acts as default widget when focussed, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_receives_default</code>() method determines whether
      the widget is alyways treated as default widget withing its toplevel when it has the
      focus, even if another widget is the default.</p><p>The effective sensitivity of a widget is however determined by both its own and
      its parent widget's sensitivity. See 
      <a class="link" href="class-gtkaction.html#method-gtkaction--is-sensitive" title="gtk.Action.is_sensitive"><code class="methodname">is_sensitive</code></a>().</p></div><div class="refsect2" title="gtk.Widget.get_sensitive"><a name="method-gtkwidget--get-sensitive"></a><h3>gtk.Widget.get_sensitive</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_sensitive</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is sensitive, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_sensitive</code>() method returns the widget's sensitivity
      (in the sense of returning the value that has been set using
      <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-sensitive" title="gtk.Widget.set_sensitive"><code class="methodname">set_sensitive</code>()</a>).</p></div><div class="refsect2" title="gtk.Widget.get_state"><a name="method-gtkwidget--get-state"></a><h3>gtk.Widget.get_state</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_state</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the state of the widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_state</code>() method returns the widget's state.</p></div><div class="refsect2" title="gtk.Widget.set_visible"><a name="method-gtkwidget--set-visible"></a><h3>gtk.Widget.set_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_visible</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>visible</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>visible</code></strong> :</span></p></td><td><code class="literal">True</code> if the widget should be shown, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_visible</code>() method sets the visibility
      state of the widget. Note that setting this to <code class="literal">True</code> doesn't
      mean the widget is actually viewable, see
      <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-visible" title="gtk.Widget.get_visible"><code class="methodname">get_visible</code></a>().</p></div><div class="refsect2" title="gtk.Widget.get_visible"><a name="method-gtkwidget--get-visible"></a><h3>gtk.Widget.get_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_visible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is visible, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_visible</code>() method determines whether
      the widget is visible. Note that this doesn't take into account whether the
      widget's parent is also visible or the widget is obscured in any way.</p></div><div class="refsect2" title="gtk.Widget.set_window"><a name="method-gtkwidget--set-window"></a><h3>gtk.Widget.set_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>window</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_window</code>() method sets the widget's
      window. This method should only be used in a widget's "realize" implementation.
      The window passed is usually either a new window or the window of its parent widget as returned by
      <a class="link" href="class-gtkwidget.html#method-gtkwidget--get-parent-window" title="gtk.Widget.get_parent_window"><code class="methodname">get_parent_window</code></a>().</p><p>Widgets must indicate whether they will create their own
      <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
      by calling <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-has-window" title="gtk.Widget.set_has_window"><code class="methodname">set_has_window</code></a>().
      This is usually done in the widget's init() method.</p></div><div class="refsect2" title="gtk.Widget.has_default"><a name="method-gtkwidget--has-default"></a><h3>gtk.Widget.has_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_default</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if widget is the current default widget within its toplevel, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">has_default</code>() method determines whether
      widget is the current default widget within its toplevel.</p></div><div class="refsect2" title="gtk.Widget.has_focus"><a name="method-gtkwidget--has-focus"></a><h3>gtk.Widget.has_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget has the global input focus, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">has_focus</code>() method determines
      if the widget has the global input focus.</p></div><div class="refsect2" title="gtk.Widget.has_grab"><a name="method-gtkwidget--has-grab"></a><h3>gtk.Widget.has_grab</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_grab</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is in the grab_widgets stack, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">has_grab</code>() method determines whether
      the widget is currently grabbing events, so it is the only widget
      receiving input events (keyboard and mouse).</p></div><div class="refsect2" title="gtk.Widget.is_sensitive"><a name="method-gtkwidget--is-sensitive"></a><h3>gtk.Widget.is_sensitive</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_sensitive</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is effectively sensitive, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">is_sensitive</code>() method returns the
      widget's effective sensitivity, which means it is sensitive itself and
      also its parent widget is sensntive.</p></div><div class="refsect2" title="gtk.Widget.is_toplevel"><a name="method-gtkwidget--is-toplevel"></a><h3>gtk.Widget.is_toplevel</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_toplevel</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is a toplevel, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">is_toplevel</code>() method determines whether
      widget is a toplevel widget. Toplevel widgets have no parent widget.</p></div><div class="refsect2" title="gtk.Widget.is_drawable"><a name="method-gtkwidget--is-drawable"></a><h3>gtk.Widget.is_drawable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_drawable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the widget is drawable, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">is_drawable</code>() method determines whether
      the widget can be drawn to. A widget can be drawn to if it is mapped and visible.</p></div></div><div class="refsect1" title="Functions"><a name="id4108111"></a><h2>Functions</h2><div class="refsect2" title="gtk.widget_push_colormap"><a name="function-gtk--widget-push-colormap"></a><h3>gtk.widget_push_colormap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_push_colormap</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cmap</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cmap</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a></td></tr></tbody></table><p>The <code class="function">gtk.widget_push_colormap</code>() function
pushes the <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
specified by <em class="parameter"><code>cmap</code></em> onto a global stack of colormaps.
The topmost colormap on the stack will be used when creating widgets. Remove
<em class="parameter"><code>cmap</code></em> with the <a class="link" href="class-gtkwidget.html#function-gtk--widget-pop-colormap" title="gtk.widget_pop_colormap"><code class="function">gtk.widget_pop_colormap</code>()</a> 
function. There's little reason to use this function.</p></div><div class="refsect2" title="gtk.widget_push_composite_child"><a name="function-gtk--widget-push-composite-child"></a><h3>gtk.widget_push_composite_child</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_push_composite_child</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="function">gtk.widget_push_composite_child</code>()
function creates all new widgets as composite children until the
corresponding <a class="link" href="class-gtkwidget.html#function-gtk--widget-pop-composite-child" title="gtk.widget_pop_composite_child"><code class="function">gtk.widget_pop_composite_child</code>()</a> 
function call. A composite child is a child that's an implementation detail
of the container it's inside and should not be visible to people using the
container. Composite children aren't treated differently (but see the <a class="link" href="class-gtkcontainer.html#method-gtkcontainer--foreach" title="gtk.Container.foreach"><code class="methodname">gtk.Container.foreach</code>()</a> 
method vs. the <a class="link" href="class-gtkcontainer.html#method-gtkcontainer--forall" title="gtk.Container.forall"><code class="methodname">gtk.Container.forall</code>()</a> 
method), but e.g. GUI builders might want to treat them in a different
way.</p></div><div class="refsect2" title="gtk.widget_pop_composite_child"><a name="function-gtk--widget-pop-composite-child"></a><h3>gtk.widget_pop_composite_child</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_pop_composite_child</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="function">gtk.widget_pop_composite_child</code>()
function cancels the effect of a previous call to the <a class="link" href="class-gtkwidget.html#function-gtk--widget-push-composite-child" title="gtk.widget_push_composite_child"><code class="function">gtk.widget_push_composite_child</code>()</a> 
function.</p></div><div class="refsect2" title="gtk.widget_pop_colormap"><a name="function-gtk--widget-pop-colormap"></a><h3>gtk.widget_pop_colormap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_pop_colormap</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="function">gtk.widget_pop_colormap</code>() function
removes the <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
on the top of the global stack of colormaps. This function reverses the
effect of the <a class="link" href="class-gtkwidget.html#function-gtk--widget-push-colormap" title="gtk.widget_push_colormap"><code class="function">gtk.widget_push_colormap</code>()</a>
function.</p></div><div class="refsect2" title="gtk.widget_get_default_style"><a name="function-gtk--widget-get-default-style"></a><h3>gtk.widget_get_default_style</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_get_default_style</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the default <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a></td></tr></tbody></table><p>The <code class="function">gtk.widget_get_default_style</code>() function
returns the default <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a> used by all
newly created widgets</p></div><div class="refsect2" title="gtk.widget_set_default_colormap"><a name="function-gtk--widget-set-default-colormap"></a><h3>gtk.widget_set_default_colormap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_set_default_colormap</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>colormap</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
object</td></tr></tbody></table><p>The <code class="function">gtk.widget_set_default_colormap</code>()
function sets the default <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
to use when creating widgets to the value specified by
<em class="parameter"><code>colormap</code></em>. The <a class="link" href="class-gtkwidget.html#function-gtk--widget-push-colormap" title="gtk.widget_push_colormap"><code class="function">gtk.widget_push_colormap</code>()</a> 
function is a better function to use if you only want to affect a few
widgets, rather than all widgets.</p></div><div class="refsect2" title="gtk.widget_get_default_colormap"><a name="function-gtk--widget-get-default-colormap"></a><h3>gtk.widget_get_default_colormap</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_get_default_colormap</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the default <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
object</td></tr></tbody></table><p>The <code class="function">gtk.widget_get_default_colormap</code>()
function returns the default <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
used when creating new widgets.</p></div><div class="refsect2" title="gtk.widget_get_default_visual"><a name="function-gtk--widget-get-default-visual"></a><h3>gtk.widget_get_default_visual</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_get_default_visual</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the default <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a>
object</td></tr></tbody></table><p>The <code class="function">gtk.widget_get_default_visual</code>()
function returns the default <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a> of
the default <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>.</p></div><div class="refsect2" title="gtk.widget_set_default_direction"><a name="function-gtk--widget-set-default-direction"></a><h3>gtk.widget_set_default_direction</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_set_default_direction</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dir</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>dir</code></strong> :</span></p></td><td>the new default direction - either
<code class="literal">gtk.TEXT_DIR_RTL</code> or
<code class="literal">gtk.TEXT_DIR_LTR</code>.</td></tr></tbody></table><p>The <code class="function">gtk.widget_set_default_direction</code>()
function sets the default text direction to the value specified by
<em class="parameter"><code>dir</code></em>. The value of <em class="parameter"><code>dir</code></em> must be
either <code class="literal">gtk.TEXT_DIR_RTL</code> or
<code class="literal">gtk.TEXT_DIR_LTR</code>. The default text direction is used for
widgets that have not had a text direction set by the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-direction" title="gtk.Widget.set_direction"><code class="methodname">set_direction</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.widget_get_default_direction"><a name="function-gtk--widget-get-default-direction"></a><h3>gtk.widget_get_default_direction</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_get_default_direction</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the default text direction</td></tr></tbody></table><p>The <code class="function">gtk.widget_get_default_direction</code>()
function returns the default text direction as set by the <a class="link" href="class-gtkwidget.html#function-gtk--widget-set-default-direction" title="gtk.widget_set_default_direction"><code class="function">gtk.widget_set_default_direction</code>()</a> 
function.</p></div><div class="refsect2" title="gtk.widget_class_find_style_property"><a name="function-gtk--widget-class-find-style-property"></a><h3>gtk.widget_class_find_style_property</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_class_find_style_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>property_name</code></strong> :</span></p></td><td>a style property name</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the style property as a GParam
	  object</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.4 and above.</p></div><p>The <code class="function">gtk.widget_class_find_style_property</code>()
     function returns the GParam object corresponding to the style
     property specified by <em class="parameter"><code>property_name</code></em> of the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
     specified by <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title="gtk.widget_class_list_style_properties"><a name="function-gtk--widget-class-list-style-properties"></a><h3>gtk.widget_class_list_style_properties</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_class_list_style_properties</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of style properties as GParam objects </td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.4 and above.</p></div><p>The <code class="function">gtk.widget_class_list_style_properties</code>()
function returns a list of the style properties of the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> specified
by <em class="parameter"><code>widget</code></em>. The list contains a GParam object for each
style property.</p></div><div class="refsect2" title="gtk.widget_class_install_style_property"><a name="function-gtk--widget-class-install-style-property"></a><h3>gtk.widget_class_install_style_property</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.widget_class_install_style_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pspec</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pspec</code></strong> :</span></p></td><td>a tuple containing a parameter specifications</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.4 and above.</p></div><p>The <code class="function">gtk.widget_class_install_style_property</code>() function
      installs the style property specified by <em class="parameter"><code>pspec</code></em> on the
      <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
      specified by <em class="parameter"><code>widget</code></em>. <em class="parameter"><code>pspec</code></em> is
      a tuple containing at least 5 items. The first 4 items contain the
      following parameter specification items:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">a string specifying the name of the property</li><li class="listitem">an object specifying the property type</li><li class="listitem">a string specifying the nickname for the property or <code class="literal">None</code></li><li class="listitem">a string specifying the short description for the property or <code class="literal">None</code></li></ul></div><p>The last item must be a integer containing a combination of the
      <PYGTKDOCLINK HREF="gobject-param-constants">GObject Param Flag
      Constants</PYGTKDOCLINK>. Additional tuple items (if needed) are inserted
      between the fourth item and the last item depending on the property
      type:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">gobject.TYPE_CHAR</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_CHAR</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_BOOLEAN</code></span></p></td><td>default value</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_INT</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_UINT</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_LONG</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_ULONG</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_INT64</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_UINT64</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_ENUM</code></span></p></td><td>default value</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_FLAGS</code></span></p></td><td>default value</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_FLOAT</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_DOUBLE</code></span></p></td><td>minimum, maximum and default values</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_STRING</code></span></p></td><td>default value</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_PARAM</code></span></p></td><td>Not applicable</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_BOXED</code></span></p></td><td>Not applicable</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_POINTER</code></span></p></td><td>Not applicable</td></tr><tr><td><p><span class="term"><code class="literal">gobject.TYPE_OBJECT</code></span></p></td><td>Not applicable</td></tr></tbody></table></div></div><div class="refsect1" title="Signals"><a name="id4109782"></a><h2>Signals</h2><div class="refsect2" title='The "accel-closures-changed" gtk.Widget Signal'><a name="signal-gtkwidget--accel-closures-changed"></a><h3>The "accel-closures-changed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "accel-closures-changed" signal is emitted when an
accelerator is added to or removed from the <a class="link" href="class-gtkaccelgroup.html" title="gtk.AccelGroup"><code class="classname">gtk.AccelGroup</code></a>
for <em class="parameter"><code>widget</code></em> or an accelerator path is setup.</p></div><div class="refsect2" title='The "button-press-event" gtk.Widget Signal'><a name="signal-gtkwidget--button-press-event"></a><h3>The "button-press-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "button-press-event" signal is emitted when a mouse button
is pressed.</p></div><div class="refsect2" title='The "button-release-event" gtk.Widget Signal'><a name="signal-gtkwidget--button-release-event"></a><h3>The "button-release-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "button-release-event" signal is emitted when a mouse button
is released.</p></div><div class="refsect2" title='The "can-activate-accel" gtk.Widget Signal'><a name="signal-gtkwidget--can-activate-accel"></a><h3>The "can-activate-accel" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>signal_id</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td><td> the ID of a signal installed on
	  <em class="parameter"><code>widget</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in GTK+ 2.4 and above.</p></div><p>The "can-activate-accel" signal is emitted when an accelerator
is about to activate <em class="parameter"><code>widget</code></em>. The handler determines
if the accelerator that activates the signal identified by
<em class="parameter"><code>signal_id</code></em> can currently be activated. This signal is
present to allow applications and derived widgets to override the default
GtkWidget handling for determining whether an accelerator can be
activated.</p></div><div class="refsect2" title='The "child-notify" gtk.Widget Signal'><a name="signal-gtkwidget--child-notify"></a><h3>The "child-notify" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>child_property</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>child_property</code></em> :</span></p></td><td>the name of a child property</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "child-notify" signal is emitted when
<em class="parameter"><code>child_property</code></em> is changed.</p><p>Child properties are available with objects derived from <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>. Those
properties are not specific to either the container or the child widget but
to their relation. For example, the "pack-type" property of <a class="link" href="class-gtkbox.html" title="gtk.Box"><code class="classname">gtk.Box</code></a> or the
"menu-label" property of <a class="link" href="class-gtknotebook.html" title="gtk.Notebook"><code class="classname">gtk.Notebook</code></a> are
child properties.</p></div><div class="refsect2" title='The "client-event" gtk.Widget Signal'><a name="signal-gtkwidget--client-event"></a><h3>The "client-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "client-event" signal is emitted when another application
has sent an event to <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "composited-changed" gtk.Widget Signal'><a name="signal-gtkwidget--composited-changed"></a><h3>The "composited-changed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the object which received the signal.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
          with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
          method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table></div><div class="refsect2" title='The "configure-event" gtk.Widget Signal'><a name="signal-gtkwidget--configure-event"></a><h3>The "configure-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "configure-event" signal is emitted when the widget's window
is allocated a size and width.</p></div><div class="refsect2" title='The "damage-event" gtk.Widget Signal'><a name="signal-gtkwidget--damage-event"></a><h3>The "damage-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>
	The "damage-event" signal is emitted when a redirected window belonging
	to widget gets drawn into. The region/area members of the event shows
	what area of the redirected drawable was drawn into.
      </p></div><div class="refsect2" title='The "delete-event" gtk.Widget Signal'><a name="signal-gtkwidget--delete-event"></a><h3>The "delete-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "delete-event" signal is emitted when a request is made to
delete <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "destroy-event" gtk.Widget Signal'><a name="signal-gtkwidget--destroy-event"></a><h3>The "destroy-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "destroy-event" signal is emitted when a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> is
destroyed.  You rarely get this signal, because most widgets disconnect
themselves from their window before they destroy it, so no widget owns the
window at destroy time.</p></div><div class="refsect2" title='The "direction-changed" gtk.Widget Signal'><a name="signal-gtkwidget--direction-changed"></a><h3>The "direction-changed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td><td>the previous direction:
<code class="literal">gtk.TEXT_DIR_NONE</code>, <code class="literal">gtk.TEXT_DIR_LTR</code> or
<code class="literal">gtk.TEXT_DIR_RTL</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "direction-changed" signal is emitted when the reading
direction of <em class="parameter"><code>widget</code></em> is changed (usually with the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--set-direction" title="gtk.Widget.set_direction"><code class="methodname">set_direction</code>()</a> 
method)</p></div><div class="refsect2" title='The "drag-begin" gtk.Widget Signal'><a name="signal-gtkwidget--drag-begin"></a><h3>The "drag-begin" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "drag-begin" signal is emitted when the user initiates a
drag operation on <em class="parameter"><code>widget</code></em>. A typical reason to connect
to this signal is to set up a custom drag icon with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-source-set-icon" title="gtk.Widget.drag_source_set_icon"><code class="methodname">drag_source_set_icon</code>()</a>
method.</p></div><div class="refsect2" title='The "drag-data-delete" gtk.Widget Signal'><a name="signal-gtkwidget--drag-data-delete"></a><h3>The "drag-data-delete" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "drag-data-delete" signal is emitted when the drag completes
a move operation and requires the source data to be deleted. The signal
handler is responsible for deleting the data that has been dropped.</p></div><div class="refsect2" title='The "drag-data-get" gtk.Widget Signal'><a name="signal-gtkwidget--drag-data-get"></a><h3>The "drag-data-get" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>info</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td><td>a <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a> object</td></tr><tr><td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td><td>an integer ID for the drag</td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time of the drag event</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "drag-data-get" signal is emitted when a drag operation
completes that copies data or when a drag drop occurs using the
<code class="literal">gtk.gdk.DRAG_PROTO_ROOTWIN</code> protocol. The drag source
revceives this signal when the drag destination requests the data using the
<a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-get-data" title="gtk.Widget.drag_get_data"><code class="methodname">drag_get_data</code>()</a>
method. The handler needs to fill <em class="parameter"><code>selection_data</code></em> with
the data in the format specified by the target associated with
<em class="parameter"><code>info</code></em>.</p></div><div class="refsect2" title='The "drag-data-received" gtk.Widget Signal'><a name="signal-gtkwidget--drag-data-received"></a><h3>The "drag-data-received" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>info</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td><td>the X position of the drop</td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td><td>the Y position of the drop</td></tr><tr><td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td><td>a <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a> 
object</td></tr><tr><td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td><td>an integer ID for the drag</td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time of the drag event</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "drag-data-received" signal is emitted when the drag
destination receives the data from the drag operation. If the data was
received in order to determine whether the drop will be accepted, the
handler is expected to call the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-status" title="gtk.gdk.DragContext.drag_status"><code class="methodname">gtk.gdk.DragContext.drag_status</code>()</a>
method and not finish the drag. If the data was received in response to a
"drag-drop" signal (and this is the last target to be received), the handler
for this signal is expected to process the received data and then call the
<a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--finish" title="gtk.gdk.DragContext.finish"><code class="methodname">gtk.gdk.DragContext.finish</code>()</a>
method, setting the <em class="parameter"><code>success</code></em> parameter to
<code class="literal">True</code> if the data was processed successfully.</p></div><div class="refsect2" title='The "drag-drop" gtk.Widget Signal'><a name="signal-gtkwidget--drag-drop"></a><h3>The "drag-drop" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td><td>the X position of the drop</td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td><td>the Y position of the drop</td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time of the drag event</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the cursor is in a
	drop zone</td></tr></tbody></table><p>The "drag-drop" signal is emitted when the drag initiates a drop
operation on the destination <em class="parameter"><code>widget</code></em>. The signal
handler must determine whether the cursor position is in a drop zone or
not. If it is not in a drop zone, it returns <code class="literal">False</code> and no
further processing is necessary. Otherwise, the handler returns
<code class="literal">True</code>. In this case, the handler must ensure that the
<a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--finish" title="gtk.gdk.DragContext.finish"><code class="methodname">gtk.gdk.DragContext.finish</code>()</a>
method is called to let the source know that the drop is done. The call to
the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--finish" title="gtk.gdk.DragContext.finish"><code class="methodname">gtk.gdk.DragContext.finish</code>()</a>
method can be done either directly or in a "drag-data-received" handler that
gets triggered by calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-get-data" title="gtk.Widget.drag_get_data"><code class="methodname">drag_get_data</code>()</a>
method to receive the data for one or more of the supported targets.</p></div><div class="refsect2" title='The "drag-end" gtk.Widget Signal'><a name="signal-gtkwidget--drag-end"></a><h3>The "drag-end" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "drag-end" signal is emitted when the drag operation is
completed. A typical reason to connect to this signal is to undo things done
in a "drag-begin" handler.</p></div><div class="refsect2" title='The "drag-failed" gtk.Widget Signal'><a name="signal-gtkwidget--drag-failed"></a><h3>The "drag-failed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>result</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td><td>the result of the drag operation.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the failed drag operation
    has been already handled.</td></tr></tbody></table><p>The "drag-failed" signal is emitted on the drag source when a drag has failed.
      The signal handler may hook custom code to handle a failed DND operation based
      on the type of error, it returns <code class="literal">True</code> is the failure has been
      already handled (not showing the default "drag operation failed" animation),
      otherwise it returns <code class="literal">False</code>.</p></div><div class="refsect2" title='The "drag-leave" gtk.Widget Signal'><a name="signal-gtkwidget--drag-leave"></a><h3>The "drag-leave" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time of the drag event</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "drag-leave" signal is emitted when the drag operation moves
off of a drop target widget. A typical reason to connect to this signal is
to undo things done in a "drag-motion" handler, e.g. undo highlighting with
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-unhighlight" title="gtk.Widget.drag_unhighlight"><code class="methodname">drag_unhighlight</code>()</a>
method.</p></div><div class="refsect2" title='The "drag-motion" gtk.Widget Signal'><a name="signal-gtkwidget--drag-motion"></a><h3>The "drag-motion" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>drag_context</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>drag_context</code></em> :</span></p></td><td>the <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td><td>the X position of the drop</td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td><td>the Y position of the drop</td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time of the drag event</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the cursor is in a
	drop zone</td></tr></tbody></table><p>The "drag-motion" signal is emitted when the drag operation
moves over a drop target widget. The signal handler must determine if the
cursor position is in a drop zone or not. If it is not in a drop zone, it
should return <code class="literal">False</code> and no further processing is
necessary. Otherwise, the handler should return <code class="literal">True</code>. In
this case, the handler is responsible for providing the necessary
information for displaying feedback to the user, by calling the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-status" title="gtk.gdk.DragContext.drag_status"><code class="methodname">gtk.gdk.DragContext.drag_status</code>()</a>
method. If the decision to accept or reject the drop can't be made based
solely on the cursor position and the type of the data, the handler may
inspect the dragged data by calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-get-data" title="gtk.Widget.drag_get_data"><code class="methodname">drag_get_data</code>()</a>
method and defer the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-status" title="gtk.gdk.DragContext.drag_status"><code class="methodname">gtk.gdk.DragContext.drag_status</code>()</a>
method call to the "drag-data-received" handler.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>There is no "drag-enter" signal. The drag receiver has to keep
track of any "drag-motion" signals received since the last "drag-leave"
signal. The first "drag-motion" signal received after a "drag_leave" signal
should be treated as an "enter" signal. Upon an "enter", the handler will
typically highlight the drop site with the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-highlight" title="gtk.Widget.drag_highlight"><code class="methodname">drag_highlight</code>()</a>
method.</p></div></div><div class="refsect2" title='The "enter-notify-event" gtk.Widget Signal'><a name="signal-gtkwidget--enter-notify-event"></a><h3>The "enter-notify-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "enter-notify-event" signal is emitted when the mouse
pointer enters <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "event" gtk.Widget Signal'><a name="signal-gtkwidget--event"></a><h3>The "event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "event" signal is emitted when any <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a> occurs
on <em class="parameter"><code>widget</code></em>. The "event" signal is emitted before any
of the specific <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a> signals
are emitted.</p></div><div class="refsect2" title='The "event-after" gtk.Widget Signal'><a name="signal-gtkwidget--event-after"></a><h3>The "event-after" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "event-after" signal is emitted after any other event
handling has occurred for <em class="parameter"><code>widget</code></em></p></div><div class="refsect2" title='The "expose-event" gtk.Widget Signal'><a name="signal-gtkwidget--expose-event"></a><h3>The "expose-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "expose-event" signal is emitted when
<em class="parameter"><code>widget</code></em> needs to be repainted because it is first
displayed or has been partially or fully obscured by another window.</p></div><div class="refsect2" title='The "focus" gtk.Widget Signal'><a name="signal-gtkwidget--focus"></a><h3>The "focus" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td><td>the direction:
<code class="literal">gtk.DIR_TAB_FORWARD</code>,
<code class="literal">gtk.DIR_TAB_BACKWARD</code>, <code class="literal">gtk.DIR_UP</code>,
<code class="literal">gtk.DIR_DOWN</code>, <code class="literal">gtk.DIR_LEFT</code> or
<code class="literal">gtk.DIR_RIGHT</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "focus" signal is emitted when <em class="parameter"><code>widget</code></em>
receives the focus.</p></div><div class="refsect2" title='The "focus-in-event" gtk.Widget Signal'><a name="signal-gtkwidget--focus-in-event"></a><h3>The "focus-in-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "focus-in-event" signal is emitted when the focus changes to
<em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "focus-out-event" gtk.Widget Signal'><a name="signal-gtkwidget--focus-out-event"></a><h3>The "focus-out-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "focus-out-event" signal is emitted when the focus leaves
<em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "grab-broken-event" gtk.Widget Signal'><a name="signal-gtkwidget--grab-broken-event"></a><h3>The "grab-broken-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the object which received the
          signal.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the gtk.gdk.EventGrabBroken
          event</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
          with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
          method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
          from being invoked for the event.  <code class="literal">False</code> to
          propagate the event further.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in GTK+ 2.8 and above.</p></div><p>Emitted when a pointer or keyboard grab on a window belonging to
      <em class="parameter"><code>widget</code></em> gets broken. </p><p>On X11, this happens when the grab window becomes unviewable
      (i.e. it or one of its ancestors is unmapped), or if the same
      application grabs the pointer or keyboard again.</p></div><div class="refsect2" title='The "grab-focus" gtk.Widget Signal'><a name="signal-gtkwidget--grab-focus"></a><h3>The "grab-focus" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "grab-focus" signal is emitted when
<em class="parameter"><code>widget</code></em> grabs the focus usually by calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">grab_focus</code>()</a> 
method or by the user using a mnemonic accelerator..</p></div><div class="refsect2" title='The "grab-notify" gtk.Widget Signal'><a name="signal-gtkwidget--grab-notify"></a><h3>The "grab-notify" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>was_grabbed</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>was_grabbed</code></em> :</span></p></td><td>if <code class="literal">True</code>
<em class="parameter"><code>widget</code></em> had grabbed the focus</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "grab-notify" signal is emitted when widget (or its
ancestor) either is grabbing the focus or has the focus grabbed from
it.</p></div><div class="refsect2" title='The "hide" gtk.Widget Signal'><a name="signal-gtkwidget--hide"></a><h3>The "hide" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "hide" signal is emitted when <em class="parameter"><code>widget</code></em>
is hidden usually by calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--hide" title="gtk.Widget.hide"><code class="methodname">hide</code>()</a>
method.</p></div><div class="refsect2" title='The "hierarchy-changed" gtk.Widget Signal'><a name="signal-gtkwidget--hierarchy-changed"></a><h3>The "hierarchy-changed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>previous_toplevel</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>previous_toplevel</code></em> :</span></p></td><td>the toplevel widget in the previous hierarchy
containing <em class="parameter"><code>widget</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "hierarchy-changed" signal is emitted when
<em class="parameter"><code>widget</code></em> is unparented or has a new parent set.</p></div><div class="refsect2" title='The "key-press-event" gtk.Widget Signal'><a name="signal-gtkwidget--key-press-event"></a><h3>The "key-press-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "key-press-event" signal is emitted when the user presses a
key on the keyboard.</p></div><div class="refsect2" title='The "keynav-failed" gtk.Widget Signal'><a name="signal-gtkwidget--keynav-failed"></a><h3>The "keynav-failed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td><td>the direction of movement.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if stopping keyboard navigation is fine,
    <code class="literal">False</code> if the emitting widget should try to handle the keyboard
    navigation attempt in its parent container(s).</td></tr></tbody></table><p>The "key-press-event" signal gets emitted if keyboard navigation fails.
      See <code class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--keynav-failed" title="gtk.Widget.keynav_failed">gtk.Widget.keynav_failed</a>
      </code>() for details.</p></div><div class="refsect2" title='The "key-release-event" gtk.Widget Signal'><a name="signal-gtkwidget--key-release-event"></a><h3>The "key-release-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "key-release-event" signal is emitted when the user releases
a key on the keyboard.</p></div><div class="refsect2" title='The "leave-notify-event" gtk.Widget Signal'><a name="signal-gtkwidget--leave-notify-event"></a><h3>The "leave-notify-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "leave-notify-event" signal is emitted when the mouse
pointer leaves the area of <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "map" gtk.Widget Signal'><a name="signal-gtkwidget--map"></a><h3>The "map" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "map" signal is emitted when <em class="parameter"><code>widget</code></em>
requests to be mapped onto the display usually by calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show"><code class="methodname">show</code>()</a> or
<a class="link" href="class-gtkwidget.html#method-gtkwidget--map" title="gtk.Widget.map"><code class="methodname">map</code>()</a>
methods.</p></div><div class="refsect2" title='The "map-event" gtk.Widget Signal'><a name="signal-gtkwidget--map-event"></a><h3>The "map-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "map-event" signal is emitted when
<em class="parameter"><code>widget</code></em> has been mapped onto the display.</p></div><div class="refsect2" title='The "mnemonic-activate" gtk.Widget Signal'><a name="signal-gtkwidget--mnemonic-activate"></a><h3>The "mnemonic-activate" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>group_cycling</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>group_cycling</code></em> :</span></p></td><td>if <code class="literal">True</code> shifts the focus instead of activating <em class="parameter"><code>widget</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "mnemonic-activate" signal is emitted when the user uses a
mnemonic accelerator to activate <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "motion-notify-event" gtk.Widget Signal'><a name="signal-gtkwidget--motion-notify-event"></a><h3>The "motion-notify-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "motion-notify-event" signal is emitted when the mouse
pointer moves while over <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "no-expose-event" gtk.Widget Signal'><a name="signal-gtkwidget--no-expose-event"></a><h3>The "no-expose-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr></tbody></table><p>The "no-expose-event" signal is emitted when a no expose event
occurs.</p></div><div class="refsect2" title='The "parent-set" gtk.Widget Signal'><a name="signal-gtkwidget--parent-set"></a><h3>The "parent-set" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>old_parent</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>old_parent</code></em> :</span></p></td><td>the previous parent of
<em class="parameter"><code>widget</code></em></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "parent-set" signal is emitted when the parent of
<em class="parameter"><code>widget</code></em> is set or unset.</p></div><div class="refsect2" title='The "popup-menu" gtk.Widget Signal'><a name="signal-gtkwidget--popup-menu"></a><h3>The "popup-menu" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if a menu was
	activated</td></tr></tbody></table><p>The "popup-menu" signal is emitted when the user presses the
<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>F10</strong></span> or
<span class="keycap"><strong>Menu</strong></span> keys when <em class="parameter"><code>widget</code></em> has the focus
to popup a menu.</p></div><div class="refsect2" title='The "property-notify-event" gtk.Widget Signal'><a name="signal-gtkwidget--property-notify-event"></a><h3>The "property-notify-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "property-notify-event" signal is emitted when a window
property value has changed. This is used for selection data
retrieval.</p></div><div class="refsect2" title='The "proximity-in-event" gtk.Widget Signal'><a name="signal-gtkwidget--proximity-in-event"></a><h3>The "proximity-in-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "proximity-in-event" (available for devices like touch
screens or graphics tablets) is emitted when the pen touches the tablet or
when the user's finger touches the screen.</p></div><div class="refsect2" title='The "proximity-out-event" gtk.Widget Signal'><a name="signal-gtkwidget--proximity-out-event"></a><h3>The "proximity-out-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "proximity-out-event" (available for devices like touch
screens or graphics tablets) is emitted when the pen leaves the tablet or
when the user's finger leaves the screen.</p></div><div class="refsect2" title='The "query-tooltip" gtk.Widget Signal'><a name="signal-gtkwidget--query-tooltip"></a><h3>The "query-tooltip" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>x</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>y</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>keyboard_mode</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>tooltip</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td><td>the x coordinate of the cursor position where the request
      has been emitted, relative to widget-&gt;window</td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td><td>the y coordinate of the cursor position where the request
      has been emitted, relative to widget-&gt;window</td></tr><tr><td><p><span class="term"><em class="parameter"><code>keyboard_mode</code></em> :</span></p></td><td><code class="literal">True</code> if the tooltip was trigged
      using the keyboard</td></tr><tr><td><p><span class="term"><em class="parameter"><code>tooltip</code></em> :</span></p></td><td>a <a class="link" href="class-gtktooltip.html" title="gtk.Tooltip"><code class="classname">gtk.Tooltip</code>
      </a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if tooltip should be shown right now,
    <code class="literal">False</code> otherwise.</td></tr></tbody></table><p>The "query-tooltip" signal is emitted when the GtkSettings:gtk-tooltip-timeout
      has expired with the cursor hovering "above" widget; or emitted when widget
      got focus in keyboard mode.
      Using the given coordinates, the signal handler should determine whether a
      tooltip should be shown for widget. If this is the case <code class="literal">True</code>
      should be returned, <code class="literal">False</code> otherwise. Note that if
      <em class="parameter"><code>keyboard_mode</code></em> is <code class="literal">True</code>, the values
      of x and y are undefined and should not be used.
      The signal handler is free to manipulate tooltip with the therefore destined function calls.</p></div><div class="refsect2" title='The "realize" gtk.Widget Signal'><a name="signal-gtkwidget--realize"></a><h3>The "realize" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "realize" signal is emitted when
<em class="parameter"><code>widget</code></em> requests to be realized by calling the <a class="link" href="class-gtkwidget.html#method-gtkwidget--realize" title="gtk.Widget.realize"><code class="methodname">realize</code>()</a> 
method.</p></div><div class="refsect2" title='The "screen-changed" gtk.Widget Signal'><a name="signal-gtkwidget--screen-changed"></a><h3>The "screen-changed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>screen</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in GTK+ 2.4 and above.</p></div><p>The "screen-changed" signal is emitted when
<em class="parameter"><code>screen</code></em> becomes the new <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a> for
<em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "scroll-event" gtk.Widget Signal'><a name="signal-gtkwidget--scroll-event"></a><h3>The "scroll-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "scroll-event" signal is emitted when widget receives a
scroll event.</p></div><div class="refsect2" title='The "selection-clear-event" gtk.Widget Signal'><a name="signal-gtkwidget--selection-clear-event"></a><h3>The "selection-clear-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "selection-clear-event" signal is emitted when the selection
needs to be cleared.</p></div><div class="refsect2" title='The "selection-get" gtk.Widget Signal'><a name="signal-gtkwidget--selection-get"></a><h3>The "selection-get" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>info</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td><td>a <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a> 
object</td></tr><tr><td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td><td>an integer ID for the
selection</td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time the event
occurred</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "selection-get" signal is emitted when the selection data is
requested from <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "selection-notify-event" gtk.Widget Signal'><a name="signal-gtkwidget--selection-notify-event"></a><h3>The "selection-notify-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "selection-notify-event" signal is emitted when the
selection owner has responded to the selection conversion request.</p></div><div class="refsect2" title='The "selection-received" gtk.Widget Signal'><a name="signal-gtkwidget--selection-received"></a><h3>The "selection-received" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>selection_data</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>timestamp</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td><td>a <a class="link" href="class-gtkselectiondata.html" title="gtk.SelectionData"><code class="classname">gtk.SelectionData</code></a> 
object</td></tr><tr><td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td><td>the time the event
occurred</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "selection-received" signal is emitted when the selection
owner has responded to the request for the selection data.</p></div><div class="refsect2" title='The "selection-request-event" gtk.Widget Signal'><a name="signal-gtkwidget--selection-request-event"></a><h3>The "selection-request-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "selection-request-event" signal is emitted when a selection
request is made on <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title='The "show" gtk.Widget Signal'><a name="signal-gtkwidget--show"></a><h3>The "show" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "show" signal is emitted when <em class="parameter"><code>widget</code></em>
requests to be displayed using either the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show"><code class="methodname">show</code>()</a> or
<a class="link" href="class-gtkwidget.html#method-gtkwidget--show-all" title="gtk.Widget.show_all"><code class="methodname">show_all</code>()</a> 
method.</p></div><div class="refsect2" title='The "show-help" gtk.Widget Signal'><a name="signal-gtkwidget--show-help"></a><h3>The "show-help" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>help_type</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>help_type</code></em> :</span></p></td><td>the help type; either
<code class="literal">gtk.WIDGET_HELP_TOOLTIP</code> or
<code class="literal">gtk.WIDGET_HELP_WHATS_THIS</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked.</td></tr></tbody></table><p>The "show-help" signal is emitted when the user presses the
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>F1</strong></span> key
combination.</p></div><div class="refsect2" title='The "size-allocate" gtk.Widget Signal'><a name="signal-gtkwidget--size-allocate"></a><h3>The "size-allocate" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>allocation</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>allocation</code></em> :</span></p></td><td>the widget's space allocation in a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "size-allocate" signal is emitted when widget is given a new
space allocation.</p></div><div class="refsect2" title='The "size-request" gtk.Widget Signal'><a name="signal-gtkwidget--size-request"></a><h3>The "size-request" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>requisition</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>requisition</code></em> :</span></p></td><td>the widget's requested size as a <a class="link" href="class-gtkrequisition.html" title="gtk.Requisition"><code class="classname">gtk.Requisition</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "size-request" signal is emitted when a new size is
requested for <em class="parameter"><code>widget</code></em> using the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-size-request" title="gtk.Widget.set_size_request"><code class="methodname">set_size_request</code>()</a> 
method.</p></div><div class="refsect2" title='The "state-changed" gtk.Widget Signal'><a name="signal-gtkwidget--state-changed"></a><h3>The "state-changed" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>state</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td><td>the previous widget state:
<code class="literal">gtk.STATE_NORMAL</code>, <code class="literal">gtk.STATE_ACTIVE</code>,
<code class="literal">gtk.STATE_PRELIGHT</code>, <code class="literal">gtk.STATE_SELECTED</code>
or <code class="literal">gtk.STATE_INSENSITIVE</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "state-changed" signal is emitted when the state of
<em class="parameter"><code>widget</code></em> changes.</p></div><div class="refsect2" title='The "style-set" gtk.Widget Signal'><a name="signal-gtkwidget--style-set"></a><h3>The "style-set" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>previous_style</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>previous_style</code></em> :</span></p></td><td>the previous widget <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "style-set" signal is emitted when the <a class="link" href="class-gtkstyle.html" title="gtk.Style"><code class="classname">gtk.Style</code></a> of
<em class="parameter"><code>widget</code></em> is set.</p></div><div class="refsect2" title='The "unmap" gtk.Widget Signal'><a name="signal-gtkwidget--unmap"></a><h3>The "unmap" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "unmap" signal is emitted when <em class="parameter"><code>widget</code></em>
requests to be unmapped from the display.</p></div><div class="refsect2" title='The "unmap-event" gtk.Widget Signal'><a name="signal-gtkwidget--unmap-event"></a><h3>The "unmap-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "unmap-event" signal is emitted when
<em class="parameter"><code>widget</code></em> has been unmapped from the display.</p></div><div class="refsect2" title='The "unrealize" gtk.Widget Signal'><a name="signal-gtkwidget--unrealize"></a><h3>The "unrealize" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "unrealize" signal is emitted when
<em class="parameter"><code>widget</code></em> requests to be unrealized (i.e. have all its
resources released).</p></div><div class="refsect2" title='The "visibility-notify-event" gtk.Widget Signal'><a name="signal-gtkwidget--visibility-notify-event"></a><h3>The "visibility-notify-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "visibility-notify-event" signal is emitted when the
visibility of <em class="parameter"><code>widget</code></em> changes i.e. it has been
obscured or unobscured.</p></div><div class="refsect2" title='The "window-state-event" gtk.Widget Signal'><a name="signal-gtkwidget--window-state-event"></a><h3>The "window-state-event" gtk.Widget Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
	from being invoked for the event. <code class="literal">False</code> to
	propagate the event further.</td></tr></tbody></table><p>The "window-state-event" signal is emitted when window state of
widget changes. For example, for a toplevel window this event is signaled
when the window is iconified, deiconified, minimized, maximized, made
sticky, made not sticky, shaded or unshaded.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkviewport.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkwindow.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.Viewport </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.Window</td></tr></table></div></body></html>
python-gtk2-doc 2.24.0-4 / usr / share / gtk-doc / html / pygtk / class-gtkwidget.html
