~ubuntu-branches/ubuntu/natty/pygtk/natty-proposed

« back to all changes in this revision

Viewing changes to docs/html/class-gtkwindow.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-01-07 11:08:47 UTC
  • mfrom: (1.2.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20100107110847-f5av7e1ttudh7ra6
Tags: 2.17.0-0ubuntu1
New upstream version

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Window</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" 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-gtkwidget.html" title="gtk.Widget"><link rel="next" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"></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.Window</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkwidget.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkwindowgroup.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gtkwindow"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Window</h2><p>gtk.Window — a top-level window that holds one child widget.</p></div><div class="refsect1" lang="en"><a name="id3892913"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Window</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a></span></span>):
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Window</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><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-gtkwidget.html" title="gtk.Widget"><link rel="next" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"></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.Window</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkwidget.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkwindowgroup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.Window"><a name="class-gtkwindow"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Window</h2><p>gtk.Window — a top-level window that holds one child widget.</p></div><div class="refsect1" title="Synopsis"><a name="id4203016"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Window</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a></span></span>):
2
2
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtkwindow.html#constructor-gtkwindow" title="Constructor">gtk.Window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span><span class="initializer">=gtk.WINDOW_TOPLEVEL</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-title" title="gtk.Window.set_title">set_title</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-title" title="gtk.Window.get_title">get_title</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-wmclass" title="gtk.Window.set_wmclass">set_wmclass</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_class</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role">set_role</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>role</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-role" title="gtk.Window.get_role">get_role</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--add-accel-group" title="gtk.Window.add_accel_group">add_accel_group</a></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-gtkwindow.html#method-gtkwindow--remove-accel-group" title="gtk.Window.remove_accel_group">remove_accel_group</a></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-gtkwindow.html#method-gtkwindow--set-position" title="gtk.Window.set_position">set_position</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--activate-focus" title="gtk.Window.activate_focus">activate_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-focus" title="gtk.Window.set_focus">set_focus</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-focus" title="gtk.Window.get_focus">get_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default" title="gtk.Window.set_default">set_default</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_widget</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--activate-default" title="gtk.Window.activate_default">activate_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for">set_transient_for</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-gtkwindow.html#method-gtkwindow--get-transient-for" title="gtk.Window.get_transient_for">get_transient_for</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-type-hint" title="gtk.Window.set_type_hint">set_type_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hint</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-type-hint" title="gtk.Window.get_type_hint">get_type_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-destroy-with-parent" title="gtk.Window.set_destroy_with_parent">set_destroy_with_parent</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-destroy-with-parent" title="gtk.Window.get_destroy_with_parent">get_destroy_with_parent</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-resizable" title="gtk.Window.set_resizable">set_resizable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-resizable" title="gtk.Window.get_resizable">get_resizable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-gravity" title="gtk.Window.set_gravity">set_gravity</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>gravity</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-gravity" title="gtk.Window.get_gravity">get_gravity</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-geometry-hints" title="gtk.Window.set_geometry_hints">set_geometry_hints</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_aspect</code></strong></span><span class="initializer">=-1.0</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_aspect</code></strong></span><span class="initializer">=-1.0</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-screen" title="gtk.Window.set_screen">set_screen</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-screen" title="gtk.Window.get_screen">get_screen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--is-active" title="gtk.Window.is_active">is_active</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--has-toplevel-focus" title="gtk.Window.has_toplevel_focus">has_toplevel_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame">set_has_frame</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-has-frame" title="gtk.Window.get_has_frame">get_has_frame</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions">set_frame_dimensions</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>left</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>top</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>right</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bottom</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-frame-dimensions" title="gtk.Window.get_frame_dimensions">get_frame_dimensions</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated">set_decorated</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-decorated" title="gtk.Window.get_decorated">get_decorated</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list">set_icon_list</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-icon-list" title="gtk.Window.get_icon_list">get_icon_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon">set_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-from-file" title="gtk.Window.set_icon_from_file">set_icon_from_file</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-icon" title="gtk.Window.get_icon">get_icon</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-modal" title="gtk.Window.set_modal">set_modal</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modal</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-modal" title="gtk.Window.get_modal">get_modal</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--add-mnemonic" title="gtk.Window.add_mnemonic">add_mnemonic</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--remove-mnemonic" title="gtk.Window.remove_mnemonic">remove_mnemonic</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--mnemonic-activate" title="gtk.Window.mnemonic_activate">mnemonic_activate</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier">set_mnemonic_modifier</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-mnemonic-modifier" title="gtk.Window.get_mnemonic_modifier">get_mnemonic_modifier</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--activate-key" title="gtk.Window.activate_key">activate_key</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-gtkwindow.html#method-gtkwindow--propagate-key-event" title="gtk.Window.propagate_key_event">propagate_key_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-gtkwindow.html#method-gtkwindow--present" title="gtk.Window.present">present</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--iconify" title="gtk.Window.iconify">iconify</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--deiconify" title="gtk.Window.deiconify">deiconify</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--stick" title="gtk.Window.stick">stick</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--unstick" title="gtk.Window.unstick">unstick</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--maximize" title="gtk.Window.maximize">maximize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--unmaximize" title="gtk.Window.unmaximize">unmaximize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--fullscreen" title="gtk.Window.fullscreen">fullscreen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--unfullscreen" title="gtk.Window.unfullscreen">unfullscreen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-keep-above" title="gtk.Window.set_keep_above">set_keep_above</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-keep-below" title="gtk.Window.set_keep_below">set_keep_below</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--begin-resize-drag" title="gtk.Window.begin_resize_drag">begin_resize_drag</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>edge</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>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--begin-move-drag" title="gtk.Window.begin_move_drag">begin_move_drag</a></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>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size">set_default_size</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-gtkwindow.html#method-gtkwindow--get-default-size" title="gtk.Window.get_default_size">get_default_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--resize" title="gtk.Window.resize">resize</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-gtkwindow.html#method-gtkwindow--get-size" title="gtk.Window.get_size">get_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move">move</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>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-position" title="gtk.Window.get_position">get_position</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--parse-geometry" title="gtk.Window.parse_geometry">parse_geometry</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--reshow-with-initial-size" title="gtk.Window.reshow_with_initial_size">reshow_with_initial_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--tooltips-get-info-from-tip-window" title="gtk.Window.tooltips_get_info_from_tip_window">tooltips_get_info_from_tip_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-focus-on-map" title="gtk.Window.set_focus_on_map">set_focus_on_map</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-focus-on-map" title="gtk.Window.get_focus_on_map">get_focus_on_map</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-name" title="gtk.Window.set_icon_name">set_icon_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-gtkwindow.html#method-gtkwindow--get-icon-name" title="gtk.Window.get_icon_name">get_icon_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-urgency-hint" title="gtk.Window.set_urgency_hint">set_urgency_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>urgency_hint</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-urgency-hint" title="gtk.Window.get_urgency_hint">get_urgency_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--present-with-time" title="gtk.Window.present_with_time">present_with_time</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-deletable" title="gtk.Window.set_deletable">set_deletable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-deletable" title="gtk.Window.get_deletable">get_deletable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-group" title="gtk.Window.get_group">get_group</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-opacity" title="gtk.Window.set_opacity">set_opacity</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>opacity</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-opacity" title="gtk.Window.get_opacity">get_opacity</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-startup-id" title="gtk.Window.set_startup_id">set_startup_id</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>startup_id</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-default-widget" title="gtk.Window.get_default_widget">get_default_widget</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table><pre class="programlisting">
3
3
<span class="bold"><strong>Functions</strong></span>
4
4
 
5
 
<code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon" title="gtk.window_set_default_icon">gtk.window_set_default_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-from-file" title="gtk.window_set_default_icon_from_file">gtk.window_set_default_icon_from_file</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list">gtk.window_set_default_icon_list</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-get-default-icon-list" title="gtk.window_get_default_icon_list">gtk.window_get_default_icon_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-auto-startup-notification" title="gtk.window_set_auto_startup_notification">gtk.window_set_auto_startup_notification</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-list-toplevels" title="gtk.window_list_toplevels">gtk.window_list_toplevels</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-name" title="gtk.window_set_default_icon_name">gtk.window_set_default_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre></div><div class="refsect1" lang="en"><a name="id3895579"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
 
5
<code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon" title="gtk.window_set_default_icon">gtk.window_set_default_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-from-file" title="gtk.window_set_default_icon_from_file">gtk.window_set_default_icon_from_file</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list">gtk.window_set_default_icon_list</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-get-default-icon-list" title="gtk.window_get_default_icon_list">gtk.window_get_default_icon_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-auto-startup-notification" title="gtk.window_set_auto_startup_notification">gtk.window_set_auto_startup_notification</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-list-toplevels" title="gtk.window_list_toplevels">gtk.window_list_toplevels</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-name" title="gtk.window_set_default_icon_name">gtk.window_set_default_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id4205682"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
6
6
  +-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
7
7
    +-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
8
8
      +-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
9
9
        +-- <a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a>
10
10
          +-- <a class="link" href="class-gtkwindow.html" title="gtk.Window">gtk.Window</a>
11
 
</pre></div><div class="refsect1" lang="en"><a name="id3895630"></a><h2>Implemented Interfaces</h2><p>
 
11
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id4205733"></a><h2>Implemented Interfaces</h2><p>
12
12
                        <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
13
13
                        implements 
14
14
                        <a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
15
 
                </p></div><div class="refsect1" lang="en"><a name="properties-gtkwindow"></a><h2>gtk.Window Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container 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><col><col></colgroup><tbody><tr valign="top"><td valign="top">"accept-focus"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should receive
 
15
                </p></div><div class="refsect1" title="gtk.Window Properties"><a name="properties-gtkwindow"></a><h2>gtk.Window Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container 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">"accept-focus"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should receive
16
16
the input focus. Default value: <code class="literal">True</code>. Available in GTK+
17
17
2.4 and above.</td></tr><tr valign="top"><td valign="top">"allow-grow"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the user can expand the
18
18
window beyond its minimum size. Default value: <code class="literal">True</code>.</td></tr><tr valign="top"><td valign="top">"allow-shrink"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window has no minimum
65
65
and above.</td></tr><tr valign="top"><td valign="top">"urgency-hint"</td><td valign="top">Read-Write</td><td valign="top">If True the window should be brought to the users
66
66
attention. Default value: <code class="literal">False</code>. Available in GTK+ 2.8
67
67
and above.</td></tr><tr valign="top"><td valign="top">"window-position"</td><td valign="top">Read-Write</td><td valign="top">The initial position of the window. Default value:
68
 
<code class="literal">gtk.WIN_POS_NONE</code></td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="style-properties-gtkwindow"></a><h2>gtk.Window Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" lang="en"><a name="id3896530"></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><col><col></colgroup><tbody><tr valign="top"><td valign="top">"allow_grow"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, users can expand the window
 
68
<code class="literal">gtk.WIN_POS_NONE</code></td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Window Style Properties"><a name="style-properties-gtkwindow"></a><h2>gtk.Window Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" title="Attributes"><a name="id4206632"></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">"allow_grow"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, users can expand the window
69
69
beyond its minimum size.</td></tr><tr valign="top"><td valign="top">"allow_shrink"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, the window has no minimum
70
70
size.</td></tr><tr valign="top"><td valign="top">"configure_notify_received"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> a window resize
71
71
configuration event has been received.</td></tr><tr valign="top"><td valign="top">"configure_request_count"</td><td valign="top">Read</td><td valign="top">The number of outstanding configuration
110
110
method.</td></tr><tr valign="top"><td valign="top">"wmclass_class"</td><td valign="top">Read</td><td valign="top">The window system class hint. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-wmclass" title="gtk.Window.set_wmclass"><code class="methodname">set_wmclass</code>()</a> 
111
111
method.</td></tr><tr valign="top"><td valign="top">"wmclass_name"</td><td valign="top">Read</td><td valign="top">The window system name hint. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-wmclass" title="gtk.Window.set_wmclass"><code class="methodname">set_wmclass</code>()</a> 
112
112
method.</td></tr><tr valign="top"><td valign="top">"wm_role"</td><td valign="top">Read</td><td valign="top">The unique identifier for the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role"><code class="methodname">set_role</code>()</a> 
113
 
method.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="signal-prototypes-gtkwindow"></a><h2>gtk.Window 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><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container 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-gtkwindow.html#signal-gtkwindow--activate-default" title='The "activate-default" gtk.Window Signal'>activate-default</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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-gtkwindow.html#signal-gtkwindow--activate-focus" title='The "activate-focus" gtk.Window Signal'>activate-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>window</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-gtkwindow.html#signal-gtkwindow--frame-event" title='The "frame-event" gtk.Window Signal'>frame-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>window</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-gtkwindow.html#signal-gtkwindow--keys-changed" title='The "keys-changed" gtk.Window Signal'>keys-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>window</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-gtkwindow.html#signal-gtkwindow--move-focus" title='The "move-focus" gtk.Window Signal'>move-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>window</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-gtkwindow.html#signal-gtkwindow--set-focus" title='The "set-focus" gtk.Window Signal'>set-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>window</code></em></span></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></tbody></table></div><div class="refsect1" lang="en"><a name="id3897969"></a><h2>Description</h2><p>A <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> provides
 
113
method.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Window Signal Prototypes"><a name="signal-prototypes-gtkwindow"></a><h2>gtk.Window 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><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container 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-gtkwindow.html#signal-gtkwindow--activate-default" title='The "activate-default" gtk.Window Signal'>activate-default</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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-gtkwindow.html#signal-gtkwindow--activate-focus" title='The "activate-focus" gtk.Window Signal'>activate-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>window</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-gtkwindow.html#signal-gtkwindow--frame-event" title='The "frame-event" gtk.Window Signal'>frame-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>window</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-gtkwindow.html#signal-gtkwindow--keys-changed" title='The "keys-changed" gtk.Window Signal'>keys-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>window</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-gtkwindow.html#signal-gtkwindow--move-focus" title='The "move-focus" gtk.Window Signal'>move-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>window</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-gtkwindow.html#signal-gtkwindow--set-focus" title='The "set-focus" gtk.Window Signal'>set-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>window</code></em></span></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></tbody></table></div><div class="refsect1" title="Description"><a name="id4208071"></a><h2>Description</h2><p>A <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> provides
114
114
a widget that users commonly think of as a window. That is, an area of the
115
115
display that is managed by the window manager and usually decorated with a
116
116
title bar, and items to allow the user to close, resize and move the
121
121
application window and dialogs.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.WINDOW_POPUP</code></span></p></td><td>A window that is ignored by the window manager and has no
122
122
frame or decorations. A popup window is used for menus and
123
123
tooltips.</td></tr></tbody></table><p>Typically, applications only directly create and use toplevel
124
 
windows.</p><p>A <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> is a container (subclass of <a class="link" href="class-gtkbin.html" title="gtk.Bin"><code class="classname">gtk.Bin</code></a>) holding one child widget.</p></div><div class="refsect1" lang="en"><a name="constructor-gtkwindow"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.Window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span><span class="initializer">=gtk.WINDOW_TOPLEVEL</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>type</code></strong> :</span></p></td><td>the type of window:
 
124
windows.</p><p>A <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> is a container (subclass of <a class="link" href="class-gtkbin.html" title="gtk.Bin"><code class="classname">gtk.Bin</code></a>) holding one child widget.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkwindow"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.Window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span><span class="initializer">=gtk.WINDOW_TOPLEVEL</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>type</code></strong> :</span></p></td><td>the type of window:
125
125
<code class="literal">gtk.WINDOW_TOPLEVEL</code> or
126
126
<code class="literal">gtk.WINDOW_POPUP</code></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-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>, which is
127
127
a toplevel window that can contain other widgets. Nearly always, the type of
130
130
pop-up tooltip. On X11, popup windows are not controlled by the window
131
131
manager. If you simply want an undecorated window (no window borders), use
132
132
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a>
133
 
method with a toplevel window, don't use a popup window.</p></div><div class="refsect1" lang="en"><a name="id3898218"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtkwindow--set-title"></a><h3>gtk.Window.set_title</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_title</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</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>title</code></strong> :</span></p></td><td>the title of the window</td></tr></tbody></table><p>The <code class="methodname">set_title</code>() method sets the "title" property
 
133
method with a toplevel window, don't use a popup window.</p></div><div class="refsect1" title="Methods"><a name="id4208321"></a><h2>Methods</h2><div class="refsect2" title="gtk.Window.set_title"><a name="method-gtkwindow--set-title"></a><h3>gtk.Window.set_title</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_title</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</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>title</code></strong> :</span></p></td><td>the title of the window</td></tr></tbody></table><p>The <code class="methodname">set_title</code>() method sets the "title" property
134
134
of the <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> to the
135
135
value specified by <em class="parameter"><code>title</code></em>. The title of a window will
136
136
be displayed in its title bar. On the X Window System, the title bar is
138
138
may vary according to a user's exact configuration. The title should help a
139
139
user distinguish this window from other windows they may have open. A good
140
140
title might include the application name and current document
141
 
filename.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-title"></a><h3>gtk.Window.get_title</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_title</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 title of the window, or
 
141
filename.</p></div><div class="refsect2" title="gtk.Window.get_title"><a name="method-gtkwindow--get-title"></a><h3>gtk.Window.get_title</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_title</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 title of the window, or
142
142
<code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">get_title</code>() method returns the
143
143
value of the "title" property of the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-title" title="gtk.Window.set_title"><code class="methodname">set_title</code>()</a> 
144
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-wmclass"></a><h3>gtk.Window.set_wmclass</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_wmclass</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_class</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>wmclass_name</code></strong> :</span></p></td><td>the window name hint</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>wmclass_class</code></strong> :</span></p></td><td>the window class hint</td></tr></tbody></table><p>The <code class="methodname">set_wmclass</code>() method sets the X
 
144
method.</p></div><div class="refsect2" title="gtk.Window.set_wmclass"><a name="method-gtkwindow--set-wmclass"></a><h3>gtk.Window.set_wmclass</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_wmclass</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_class</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>wmclass_name</code></strong> :</span></p></td><td>the window name hint</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>wmclass_class</code></strong> :</span></p></td><td>the window class hint</td></tr></tbody></table><p>The <code class="methodname">set_wmclass</code>() method sets the X
145
145
Window System "class" and "name" hints for a window. Applications should not
146
146
call this method. According to the ICCCM, you should always set these to the
147
147
same value for all windows in an application, and <code class="literal">PyGTK</code>
149
149
pointless. However, you may want to call the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role"><code class="methodname">set_role</code>()</a> 
150
150
method on each window in your application, for the benefit of the session
151
151
manager. Setting the role allows the window manager to restore window
152
 
positions when loading a saved session.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-role"></a><h3>gtk.Window.set_role</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_role</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>role</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>role</code></strong> :</span></p></td><td>a unique identifier for the
 
152
positions when loading a saved session.</p></div><div class="refsect2" title="gtk.Window.set_role"><a name="method-gtkwindow--set-role"></a><h3>gtk.Window.set_role</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_role</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>role</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>role</code></strong> :</span></p></td><td>a unique identifier for the
153
153
window</td></tr></tbody></table><p>The <code class="methodname">set_role</code>() method sets a unique
154
154
identifier (specified by <em class="parameter"><code>role</code></em>) for the window to be
155
155
used when restoring a session. This method is only useful on X11. In
159
159
that when the user restarts their session, the window manager can put the
160
160
toolbox back in the same place. If a window already has a unique title, you
161
161
don't need to set the role, since the WM can use the title to identify the
162
 
window when restoring the session.d</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-role"></a><h3>gtk.Window.get_role</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_role</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 role of the window if set, or
 
162
window when restoring the session.d</p></div><div class="refsect2" title="gtk.Window.get_role"><a name="method-gtkwindow--get-role"></a><h3>gtk.Window.get_role</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_role</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 role of the window if set, or
163
163
<code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">get_role</code>() method returns the role
164
164
of the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role"><code class="methodname">set_role</code>()</a> 
165
 
method for further explanation.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--add-accel-group"></a><h3>gtk.Window.add_accel_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_accel_group</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_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">add_accel_group</code>() method associates
 
165
method for further explanation.</p></div><div class="refsect2" title="gtk.Window.add_accel_group"><a name="method-gtkwindow--add-accel-group"></a><h3>gtk.Window.add_accel_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_accel_group</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_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">add_accel_group</code>() method associates
166
166
the accelerator group specified by <em class="parameter"><code>accel_group</code></em> with
167
 
the window.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--remove-accel-group"></a><h3>gtk.Window.remove_accel_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_accel_group</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_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">remove_accel_group</code>() method
 
167
the window.</p></div><div class="refsect2" title="gtk.Window.remove_accel_group"><a name="method-gtkwindow--remove-accel-group"></a><h3>gtk.Window.remove_accel_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_accel_group</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_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">remove_accel_group</code>() method
168
168
dissociates the accelerator group specified by
169
169
<em class="parameter"><code>accel_group</code></em> from the widget. This method reverses the
170
170
effects of the <a class="link" href="class-gtkwindow.html#method-gtkwindow--add-accel-group" title="gtk.Window.add_accel_group"><code class="methodname">add_accel_group</code>()</a> 
171
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-position"></a><h3>gtk.Window.set_position</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_position</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</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>position</code></strong> :</span></p></td><td>a position constraint.</td></tr></tbody></table><p>The <code class="methodname">set_position</code>() method sets the
 
171
method.</p></div><div class="refsect2" title="gtk.Window.set_position"><a name="method-gtkwindow--set-position"></a><h3>gtk.Window.set_position</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_position</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</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>position</code></strong> :</span></p></td><td>a position constraint.</td></tr></tbody></table><p>The <code class="methodname">set_position</code>() method sets the
172
172
"window-position" property to the value of <em class="parameter"><code>position</code></em>.
173
173
The value of <em class="parameter"><code>position</code></em> must be one of the <a class="xref" href="gtk-constants.html#gtk-window-position-constants" title="GTK Window Position Constants">GTK Window Position Constants</a>.</p><p>If the old or new window position constraint is
174
174
<code class="literal">gtk.WIN_POS_CENTER_ALWAYS</code>, this will also cause the
175
 
window to be repositioned to satisfy the new constraint.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--activate-focus"></a><h3>gtk.Window.activate_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate_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 window has a
 
175
window to be repositioned to satisfy the new constraint.</p></div><div class="refsect2" title="gtk.Window.activate_focus"><a name="method-gtkwindow--activate-focus"></a><h3>gtk.Window.activate_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate_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 window has a
176
176
focus widget</td></tr></tbody></table><p>The <code class="methodname">activate_focus</code>() method activates
177
177
the child widget with the focus. This method returns <code class="literal">True</code>
178
 
if the window has a widget with the focus.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-focus"></a><h3>gtk.Window.set_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_focus</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>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>focus</code></strong> :</span></p></td><td>the widget to be the new focus
 
178
if the window has a widget with the focus.</p></div><div class="refsect2" title="gtk.Window.set_focus"><a name="method-gtkwindow--set-focus"></a><h3>gtk.Window.set_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_focus</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>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>focus</code></strong> :</span></p></td><td>the widget to be the new focus
179
179
widget or <code class="literal">None</code> to unset a focus widget</td></tr></tbody></table><p>The <code class="methodname">set_focus</code>() method sets the widget
180
180
specified by <em class="parameter"><code>focus</code></em> to be the focus widget for the
181
181
window. If <em class="parameter"><code>focus</code></em> is <code class="literal">None</code> the
182
182
window's focus widget is unset. To set the focus to a particular widget in
183
183
the toplevel, it is usually more convenient to use the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">gtk.Widget.grab_focus</code>()</a> 
184
 
method instead of this method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-focus"></a><h3>gtk.Window.get_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_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>the currently focused
 
184
method instead of this method.</p></div><div class="refsect2" title="gtk.Window.get_focus"><a name="method-gtkwindow--get-focus"></a><h3>gtk.Window.get_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_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>the currently focused
185
185
widget.</td></tr></tbody></table><p>The <code class="methodname">get_focus</code>() method returns the
186
186
current focused widget within the window. The focus widget is the widget
187
 
that would have the focus if the toplevel window is focused.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-default"></a><h3>gtk.Window.set_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_default</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_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>default_widget</code></strong> :</span></p></td><td>the widget to be the default, or
 
187
that would have the focus if the toplevel window is focused.</p></div><div class="refsect2" title="gtk.Window.set_default"><a name="method-gtkwindow--set-default"></a><h3>gtk.Window.set_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_default</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_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>default_widget</code></strong> :</span></p></td><td>the widget to be the default, or
188
188
<code class="literal">None</code> to unset the default widget.</td></tr></tbody></table><p>The <code class="methodname">set_default</code>() method sets the
189
189
window's default widget to the value specified by
190
190
<em class="parameter"><code>default_widget</code></em>. If
196
196
method on the widget. Before making a widget the default widget, you must
197
197
set the <code class="literal">gtk.CAN_DEFAULT</code> flag on the widget you'd like to
198
198
make the default using 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> 
199
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--activate-default"></a><h3>gtk.Window.activate_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate_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 the window has a
 
199
method.</p></div><div class="refsect2" title="gtk.Window.activate_default"><a name="method-gtkwindow--activate-default"></a><h3>gtk.Window.activate_default</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate_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 the window has a
200
200
default widget or a focus widget.</td></tr></tbody></table><p>The <code class="methodname">activate_default</code>() method activates
201
201
the default widget. If there is no default widget or the default widget
202
202
cannot be activated, the window's focus widget (if any) is activated. This
203
203
method returns <code class="literal">False</code> if no default widget could be
204
 
activated or there is no focus widget.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-transient-for"></a><h3>gtk.Window.set_transient_for</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_transient_for</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>the parent window or <code class="literal">None</code> to
 
204
activated or there is no focus widget.</p></div><div class="refsect2" title="gtk.Window.set_transient_for"><a name="method-gtkwindow--set-transient-for"></a><h3>gtk.Window.set_transient_for</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_transient_for</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>the parent window or <code class="literal">None</code> to
205
205
remove the transient parent</td></tr></tbody></table><p>The <code class="methodname">set_transient_for</code>() method sets the
206
206
window as a transient window for the window specified by
207
207
<em class="parameter"><code>parent</code></em>. Dialog windows should be set transient for
212
212
<code class="methodname">set_transient_for</code>() method on your behalf.
213
213
</p><p>
214
214
On Windows, this method will and put the child window on top of the parent,
215
 
much as the window manager would have done on X.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-transient-for"></a><h3>gtk.Window.get_transient_for</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_transient_for</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 transient parent for this window, or
 
215
much as the window manager would have done on X.</p></div><div class="refsect2" title="gtk.Window.get_transient_for"><a name="method-gtkwindow--get-transient-for"></a><h3>gtk.Window.get_transient_for</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_transient_for</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 transient parent for this window, or
216
216
<code class="literal">None</code> if no transient parent has been
217
217
set.</td></tr></tbody></table><p>The <code class="methodname">get_transient_for</code>() method returns
218
218
the transient parent for this window or <code class="literal">None</code> if no
219
219
transient window is set. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a> 
220
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-type-hint"></a><h3>gtk.Window.set_type_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_type_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hint</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>hint</code></strong> :</span></p></td><td>the window type</td></tr></tbody></table><p>The <code class="methodname">set_type_hint</code>() method sets the
 
220
method.</p></div><div class="refsect2" title="gtk.Window.set_type_hint"><a name="method-gtkwindow--set-type-hint"></a><h3>gtk.Window.set_type_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_type_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hint</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>hint</code></strong> :</span></p></td><td>the window type</td></tr></tbody></table><p>The <code class="methodname">set_type_hint</code>() method sets the
221
221
window type hint for the window to the value specified by
222
222
<em class="parameter"><code>hint</code></em>. The value of <em class="parameter"><code>hint</code></em> must
223
223
be one of the <a class="xref" href="gdk-constants.html#gdk-window-type-hint-constants" title="GDK Window Type Hint Constants">GDK Window Type Hint Constants</a>.</p><p>By setting the type hint for the window, you allow the window
225
225
method of the window in your application. This method should be called
226
226
before the window becomes visible. The <a class="link" href="class-gtkdialog.html#constructor-gtkdialog" title="Constructor">gtk.Dialog</a>() constructor and other
227
227
convenience functions in <code class="literal">PyGTK</code> will sometimes call this
228
 
method on your behalf.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-type-hint"></a><h3>gtk.Window.get_type_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_type_hint</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 type hint for the
 
228
method on your behalf.</p></div><div class="refsect2" title="gtk.Window.get_type_hint"><a name="method-gtkwindow--get-type-hint"></a><h3>gtk.Window.get_type_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_type_hint</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 type hint for the
229
229
window.</td></tr></tbody></table><p>The <code class="methodname">get_type_hint</code>() method returns the
230
230
type hint for this window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-type-hint" title="gtk.Window.set_type_hint">s<code class="methodname">et_type_hint</code>()</a> 
231
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-destroy-with-parent"></a><h3>gtk.Window.set_destroy_with_parent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_destroy_with_parent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> destroy the window
 
231
method.</p></div><div class="refsect2" title="gtk.Window.set_destroy_with_parent"><a name="method-gtkwindow--set-destroy-with-parent"></a><h3>gtk.Window.set_destroy_with_parent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_destroy_with_parent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> destroy the window
232
232
with its transient parent</td></tr></tbody></table><p>The <code class="methodname">set_destroy_with_parent</code>() method
233
233
sets the "destroy-with-parent" property to the value specified by
234
234
<em class="parameter"><code>setting</code></em>. If <em class="parameter"><code>setting</code></em> is
235
235
<code class="literal">True</code>, destroying the transient parent of the window will
236
236
also destroy the window itself. This is useful for dialogs that shouldn't
237
237
persist beyond the lifetime of the main window they're associated
238
 
with.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-destroy-with-parent"></a><h3>gtk.Window.get_destroy_with_parent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_destroy_with_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><code class="literal">True</code> if the window will be
 
238
with.</p></div><div class="refsect2" title="gtk.Window.get_destroy_with_parent"><a name="method-gtkwindow--get-destroy-with-parent"></a><h3>gtk.Window.get_destroy_with_parent</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_destroy_with_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><code class="literal">True</code> if the window will be
239
239
destroyed with its transient parent.</td></tr></tbody></table><p>The <code class="methodname">get_destroy_with_parent</code>() method
240
240
returns the value of the "destroy-with-parent" property that determines if
241
241
the window will be destroyed with its transient parent. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-destroy-with-parent" title="gtk.Window.set_destroy_with_parent"><code class="methodname">set_destroy_with_parent</code>()</a> 
242
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-resizable"></a><h3>gtk.Window.set_resizable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_resizable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</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>resizable</code></strong> :</span></p></td><td>if <code class="literal">True</code> the user can resize
 
242
method.</p></div><div class="refsect2" title="gtk.Window.set_resizable"><a name="method-gtkwindow--set-resizable"></a><h3>gtk.Window.set_resizable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_resizable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</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>resizable</code></strong> :</span></p></td><td>if <code class="literal">True</code> the user can resize
243
243
this window</td></tr></tbody></table><p>The <code class="methodname">set_resizable</code>() method sets the
244
244
"resizable" property to  the value of <em class="parameter"><code>resizable</code></em>. If
245
245
<em class="parameter"><code>resizable</code></em> is <code class="literal">True</code> the user can
246
 
resize the window. Windows are user resizable by default.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-resizable"></a><h3>gtk.Window.get_resizable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_resizable</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 user can resize
 
246
resize the window. Windows are user resizable by default.</p></div><div class="refsect2" title="gtk.Window.get_resizable"><a name="method-gtkwindow--get-resizable"></a><h3>gtk.Window.get_resizable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_resizable</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 user can resize
247
247
the window</td></tr></tbody></table><p>The <code class="methodname">get_resizable</code>() method returns the
248
248
value of the "resizable" property. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-resizable" title="gtk.Window.set_resizable"><code class="methodname">set_resizable</code>()</a> 
249
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-gravity"></a><h3>gtk.Window.set_gravity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_gravity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>gravity</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>gravity</code></strong> :</span></p></td><td>the window gravity</td></tr></tbody></table><p>The <code class="methodname">set_gravity</code>() method sets the
 
249
method.</p></div><div class="refsect2" title="gtk.Window.set_gravity"><a name="method-gtkwindow--set-gravity"></a><h3>gtk.Window.set_gravity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_gravity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>gravity</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>gravity</code></strong> :</span></p></td><td>the window gravity</td></tr></tbody></table><p>The <code class="methodname">set_gravity</code>() method sets the
250
250
gravity of the window to the value specified by
251
251
<em class="parameter"><code>gravity</code></em>. The window gravity defines the meaning of
252
252
coordinates passed to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
253
253
method. The value of gravity must be one of the <a class="xref" href="gdk-constants.html#gdk-gravity-constants" title="GDK Gravity Constants">GDK Gravity Constants</a>.</p><p>The default window gravity is
254
254
<code class="literal">gtk.gdk.GRAVITY_NORTH_WEST</code> which will typically "do what
255
 
you want."</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-gravity"></a><h3>gtk.Window.get_gravity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_gravity</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 window gravity</td></tr></tbody></table><p>The <code class="methodname">get_gravity</code>() method returns window
 
255
you want."</p></div><div class="refsect2" title="gtk.Window.get_gravity"><a name="method-gtkwindow--get-gravity"></a><h3>gtk.Window.get_gravity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_gravity</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 window gravity</td></tr></tbody></table><p>The <code class="methodname">get_gravity</code>() method returns window
256
256
gravity. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-gravity" title="gtk.Window.set_gravity"><code class="methodname">set_gravity</code>()</a> 
257
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-geometry-hints"></a><h3>gtk.Window.set_geometry_hints</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_geometry_hints</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_aspect</code></strong></span><span class="initializer">=-1.0</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_aspect</code></strong></span><span class="initializer">=-1.0</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>geometry_widget</code></strong> :</span></p></td><td>the widget the geometry hints will be applied
 
257
method.</p></div><div class="refsect2" title="gtk.Window.set_geometry_hints"><a name="method-gtkwindow--set-geometry-hints"></a><h3>gtk.Window.set_geometry_hints</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_geometry_hints</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_aspect</code></strong></span><span class="initializer">=-1.0</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_aspect</code></strong></span><span class="initializer">=-1.0</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>geometry_widget</code></strong> :</span></p></td><td>the widget the geometry hints will be applied
258
258
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>min_width</code></strong> :</span></p></td><td>the minimum width of window (or -1 to use
259
259
requisition)</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>min_height</code></strong> :</span></p></td><td>the minimum height of window (or -1 to use
260
260
requisition)</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>max_width</code></strong> :</span></p></td><td>the maximum width of window (or -1 to use
271
271
resize by the size of a character), and the minimum and maximum aspect
272
272
ratios. If <em class="parameter"><code>geometry_widget</code></em> is not
273
273
<code class="literal">None</code> it specifies the widget to figure the geometry
274
 
on.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-screen"></a><h3>gtk.Window.set_screen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_screen</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</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>screen</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>.</td></tr></tbody></table><div class="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">set_screen</code>() method sets the
 
274
on.</p></div><div class="refsect2" title="gtk.Window.set_screen"><a name="method-gtkwindow--set-screen"></a><h3>gtk.Window.set_screen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_screen</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</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>screen</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</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.2 and above.</p></div><p>The <code class="methodname">set_screen</code>() method sets the
275
275
"screen" property to the <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
276
276
specified by <em class="parameter"><code>screen</code></em>. The "screen" property contains
277
277
the screen that the window is displayed on. If the window is already mapped,
278
 
it will be unmapped, and then remapped on the new screen.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-screen"></a><h3>gtk.Window.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>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>.</td></tr></tbody></table><div class="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
 
278
it will be unmapped, and then remapped on the new screen.</p></div><div class="refsect2" title="gtk.Window.get_screen"><a name="method-gtkwindow--get-screen"></a><h3>gtk.Window.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>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</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.2 and above.</p></div><p>The <code class="methodname">get_screen</code>() method returns the
279
279
<a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
280
 
that the window is displayed on.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--is-active"></a><h3>gtk.Window.is_active</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_active</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 window is part
281
 
          of the current active window.</td></tr></tbody></table><div class="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">is_active</code>() method returns
 
280
that the window is displayed on.</p></div><div class="refsect2" title="gtk.Window.is_active"><a name="method-gtkwindow--is-active"></a><h3>gtk.Window.is_active</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">is_active</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 window is part
 
281
          of the current active 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.4 and above.</p></div><p>The <code class="methodname">is_active</code>() method returns
282
282
<code class="literal">True</code> if the window is part of the current active
283
283
toplevel, i.e., the toplevel window receiving keystrokes.  The return value
284
284
is <code class="literal">True</code> if the window is active the toplevel itself, or
286
286
the active toplevel. You might use this method if you wanted to draw a
287
287
widget differently in an active window from a widget in an inactive window.
288
288
See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--has-toplevel-focus" title="gtk.Window.has_toplevel_focus"><code class="methodname">has_toplevel_focus()</code></a>
289
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--has-toplevel-focus"></a><h3>gtk.Window.has_toplevel_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_toplevel_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 the input focus
290
 
          is within the window</td></tr></tbody></table><div class="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">has_toplevel_focus</code>() method returns
 
289
method.</p></div><div class="refsect2" title="gtk.Window.has_toplevel_focus"><a name="method-gtkwindow--has-toplevel-focus"></a><h3>gtk.Window.has_toplevel_focus</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">has_toplevel_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 the input focus
 
290
          is within the 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.4 and above.</p></div><p>The <code class="methodname">has_toplevel_focus</code>() method returns
291
291
<code class="literal">True</code> if the input focus is within the window.  For real
292
292
toplevel windows, this is identical to <a class="link" href="class-gtkwindow.html#method-gtkwindow--is-active" title="gtk.Window.is_active"><code class="methodname">is_active()</code></a>,
293
293
but for embedded windows, like a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a>, the results
294
 
will differ.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-has-frame"></a><h3>gtk.Window.set_has_frame</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_has_frame</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> PyGTK draws the
 
294
will differ.</p></div><div class="refsect2" title="gtk.Window.set_has_frame"><a name="method-gtkwindow--set-has-frame"></a><h3>gtk.Window.set_has_frame</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_has_frame</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> PyGTK draws the
295
295
window border</td></tr></tbody></table><p>The <code class="methodname">set_has_frame</code>() method sets the
296
296
flag that causes <code class="literal">PyGTK</code> to draw its own window border for
297
 
the window.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method for the framebuffer port. For
 
297
the window.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method for the framebuffer port. For
298
298
most applications, you want the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a> 
299
299
method instead,that tells the window manager whether to draw the window
300
300
border.</p></div><p>If this method is called on a window with setting of
303
303
accessible in the window's frame. Using the signal "frame-event" you can
304
304
receive all events targeted at the frame. This method is used by the
305
305
linux-fb port to implement managed windows, but it could conceivably be used
306
 
by X-programs that want to do their own window decorations.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-has-frame"></a><h3>gtk.Window.get_has_frame</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_has_frame</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 a frame has been
 
306
by X-programs that want to do their own window decorations.</p></div><div class="refsect2" title="gtk.Window.get_has_frame"><a name="method-gtkwindow--get-has-frame"></a><h3>gtk.Window.get_has_frame</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_has_frame</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 a frame has been
307
307
added to the window via the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a> 
308
308
method.</td></tr></tbody></table><p>The <code class="methodname">get_has_frame</code>() method returns the
309
309
value of the window's "has_frame" flag that determines if the window has a
310
310
frame window exterior to its <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>. See
311
311
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a> 
312
 
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-frame-dimensions"></a><h3>gtk.Window.set_frame_dimensions</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_frame_dimensions</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>left</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>top</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>right</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bottom</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>left</code></strong> :</span></p></td><td>the width of the left
 
312
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_frame_dimensions"><a name="method-gtkwindow--set-frame-dimensions"></a><h3>gtk.Window.set_frame_dimensions</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_frame_dimensions</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>left</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>top</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>right</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bottom</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>left</code></strong> :</span></p></td><td>the width of the left
313
313
border</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>top</code></strong> :</span></p></td><td>the height of the top
314
314
border</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>right</code></strong> :</span></p></td><td>the width of the right
315
315
border</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>bottom</code></strong> :</span></p></td><td>the height of the bottom
316
316
border</td></tr></tbody></table><p>The <code class="methodname">set_frame_dimensions</code>() method sets
317
317
the size of the frame around the window to the values specified by
318
318
<em class="parameter"><code>left</code></em>, <em class="parameter"><code>top</code></em>,
319
 
<em class="parameter"><code>bottom</code></em> and <em class="parameter"><code>right</code></em>.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method intended for the framebuffer
 
319
<em class="parameter"><code>bottom</code></em> and <em class="parameter"><code>right</code></em>.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method intended for the framebuffer
320
320
port. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a> 
321
321
method. It will have no effect on the window border drawn by the window
322
322
manager, which is the normal case when using the X Window system.</p></div><p>For windows with frames (see the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a> 
323
323
method) this method can be used to change the size of the frame
324
 
border.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-frame-dimensions"></a><h3>gtk.Window.get_frame_dimensions</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_frame_dimensions</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 frame dimensions: the
 
324
border.</p></div><div class="refsect2" title="gtk.Window.get_frame_dimensions"><a name="method-gtkwindow--get-frame-dimensions"></a><h3>gtk.Window.get_frame_dimensions</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_frame_dimensions</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 frame dimensions: the
325
325
width of the frame at the left; the height of the frame at the top; the
326
326
width of the frame at the right; and, the height of the frame at the
327
327
bottom.</td></tr></tbody></table><p>The <code class="methodname">get_frame_dimensions</code>() method
328
328
returns a tuple containing the frame dimensions:  the width of the frame at
329
329
the left; the height of the frame at the top; the width of the frame at the
330
 
right; and, the height of the frame at the bottom.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method intended for the framebuffer
 
330
right; and, the height of the frame at the bottom.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method intended for the framebuffer
331
331
port See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a> 
332
332
method. It will not return the size of the window border drawn by the window
333
333
manager, which is the normal case when using a windowing system.  See the
334
334
<a class="link" href="class-gdkwindow.html#method-gdkwindow--get-frame-extents" title="gtk.gdk.Window.get_frame_extents"><code class="methodname">get_frame_extents</code>()</a> 
335
335
to get the standard window border extents.</p></div><p>See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a> 
336
336
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a> 
337
 
methods for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-decorated"></a><h3>gtk.Window.set_decorated</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_decorated</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> decorate the
 
337
methods for more information.</p></div><div class="refsect2" title="gtk.Window.set_decorated"><a name="method-gtkwindow--set-decorated"></a><h3>gtk.Window.set_decorated</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_decorated</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> decorate the
338
338
window</td></tr></tbody></table><p>The <code class="methodname">set_decorated</code>() method sets the
339
339
decorated flag to the value specified by <em class="parameter"><code>setting</code></em>. If
340
340
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code> the window will be
344
344
to <code class="literal">False</code> using this method, <code class="literal">PyGTK</code> will
345
345
do its best to convince the window manager not to decorate the window. On
346
346
Windows, this method always works, since there's no window manager policy
347
 
involved.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-decorated"></a><h3>gtk.Window.get_decorated</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_decorated</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 window has been
 
347
involved.</p></div><div class="refsect2" title="gtk.Window.get_decorated"><a name="method-gtkwindow--get-decorated"></a><h3>gtk.Window.get_decorated</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_decorated</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 window has been
348
348
set to have decorations</td></tr></tbody></table><p>The <code class="methodname">get_decorated</code>() method returns the
349
349
value of the decorated flag that determines if the window has been set to
350
350
have decorations such as a title bar. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a> 
351
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-icon-list"></a><h3>gtk.Window.set_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon_list</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>...</code></em> :</span></p></td><td>zero or more <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
 
351
method.</p></div><div class="refsect2" title="gtk.Window.set_icon_list"><a name="method-gtkwindow--set-icon-list"></a><h3>gtk.Window.set_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon_list</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>...</code></em> :</span></p></td><td>zero or more <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
352
352
objects</td></tr></tbody></table><p>The <code class="methodname">set_icon_list</code>() method sets up the
353
353
icon representing the window using the set of <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
354
354
objects passed as arguments. If no <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
368
368
that transient windows (those who have been set transient for another window
369
369
using the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a> 
370
370
method) will inherit their icon from their transient parent. So there's no
371
 
need to explicitly set the icon on transient windows.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-icon-list"></a><h3>gtk.Window.get_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_icon_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>a copy of the window's icon
 
371
need to explicitly set the icon on transient windows.</p></div><div class="refsect2" title="gtk.Window.get_icon_list"><a name="method-gtkwindow--get-icon-list"></a><h3>gtk.Window.get_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_icon_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>a copy of the window's icon
372
372
list</td></tr></tbody></table><p>The <code class="methodname">get_icon_list</code>() method returns the
373
373
list of icons set by the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a> 
374
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-icon"></a><h3>gtk.Window.set_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</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</code></strong> :</span></p></td><td>an icon image, or
 
374
method.</p></div><div class="refsect2" title="gtk.Window.set_icon"><a name="method-gtkwindow--set-icon"></a><h3>gtk.Window.set_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</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</code></strong> :</span></p></td><td>an icon image, or
375
375
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">set_icon</code>() method sets the "icon"
376
376
property to the value specified by <em class="parameter"><code>icon</code></em>. This icon is
377
377
used when the window is minimized (also known as iconified). Some window
384
384
method. Then the best size will be used.</p><p>This method is equivalent to calling the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a> 
385
385
method with a 1-element list. See the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list"><code class="methodname">gtk.window_set_default_icon_list</code>()</a> 
386
386
function to set the icon for all windows in your application in one
387
 
go.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-icon-from-file"></a><h3>gtk.Window.set_icon_from_file</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon_from_file</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</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>filename</code></strong> :</span></p></td><td>the name of a file containing an icon
 
387
go.</p></div><div class="refsect2" title="gtk.Window.set_icon_from_file"><a name="method-gtkwindow--set-icon-from-file"></a><h3>gtk.Window.set_icon_from_file</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon_from_file</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</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>filename</code></strong> :</span></p></td><td>the name of a file containing an icon
388
388
          image</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 icon was
389
389
          loaded.</td></tr></tbody></table><p>The <code class="methodname">set_icon_from_file</code>() method sets
390
390
the "icon" property to the icon loaded from the file specified by
393
393
method for more information. This method is equivalent to calling the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
394
394
method with a pixbuf created by loading the image from
395
395
<em class="parameter"><code>filename</code></em>.</p><p>The GError exception is raised if an error occurs while loading
396
 
the pixbuf from <em class="parameter"><code>filename</code></em>.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-icon"></a><h3>gtk.Window.get_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_icon</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 icon for window</td></tr></tbody></table><p>The <code class="methodname">get_icon</code>() method returns the value
 
396
the pixbuf from <em class="parameter"><code>filename</code></em>.</p></div><div class="refsect2" title="gtk.Window.get_icon"><a name="method-gtkwindow--get-icon"></a><h3>gtk.Window.get_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_icon</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 icon for window</td></tr></tbody></table><p>The <code class="methodname">get_icon</code>() method returns the value
397
397
of the "icon" property set by the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a> 
398
398
(or if you've called the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a> 
399
 
method, returns the first icon in the icon list).</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-modal"></a><h3>gtk.Window.set_modal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_modal</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modal</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>modal</code></strong> :</span></p></td><td>if <code class="literal">True</code> the window is
 
399
method, returns the first icon in the icon list).</p></div><div class="refsect2" title="gtk.Window.set_modal"><a name="method-gtkwindow--set-modal"></a><h3>gtk.Window.set_modal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_modal</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modal</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>modal</code></strong> :</span></p></td><td>if <code class="literal">True</code> the window is
400
400
modal</td></tr></tbody></table><p>The <code class="methodname">set_modal</code>() method sets the "modal"
401
401
property to the value of <em class="parameter"><code>modal</code></em>. If
402
402
<em class="parameter"><code>modal</code></em> is <code class="literal">True</code> the window becomes
405
405
that require a user response before the application can continue. To keep
406
406
modal dialogs on top of the main application windows, use the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a> 
407
407
method to make the dialog transient for the parent - most window managers
408
 
will then disallow lowering the dialog below the parent.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-modal"></a><h3>gtk.Window.get_modal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_modal</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 window is set to
 
408
will then disallow lowering the dialog below the parent.</p></div><div class="refsect2" title="gtk.Window.get_modal"><a name="method-gtkwindow--get-modal"></a><h3>gtk.Window.get_modal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_modal</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 window is set to
409
409
be modal and establishes a grab when shown</td></tr></tbody></table><p>The <code class="methodname">get_modal</code>() method returns the
410
410
value of the "modal" property. If "modal" is <code class="literal">True</code> the
411
411
window is modal. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-modal" title="gtk.Window.set_modal"><code class="methodname">set_modal</code>()</a> 
412
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--add-mnemonic"></a><h3>gtk.Window.add_mnemonic</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_mnemonic</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</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>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>the widget that gets activated by the
 
412
method.</p></div><div class="refsect2" title="gtk.Window.add_mnemonic"><a name="method-gtkwindow--add-mnemonic"></a><h3>gtk.Window.add_mnemonic</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_mnemonic</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</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>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>the widget that gets activated by the
413
413
mnemonic</td></tr></tbody></table><p>The <code class="methodname">add_mnemonic</code>() method adds a
414
414
mnemonic key specified by <em class="parameter"><code>keyval</code></em> to this window. When
415
415
the mnemonic key is pressed the widget specified by
416
 
<em class="parameter"><code>target</code></em> will be activated.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--remove-mnemonic"></a><h3>gtk.Window.remove_mnemonic</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_mnemonic</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</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>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>the widget that gets activated by the
 
416
<em class="parameter"><code>target</code></em> will be activated.</p></div><div class="refsect2" title="gtk.Window.remove_mnemonic"><a name="method-gtkwindow--remove-mnemonic"></a><h3>gtk.Window.remove_mnemonic</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">remove_mnemonic</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</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>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>the widget that gets activated by the
417
417
mnemonic</td></tr></tbody></table><p>The <code class="methodname">remove_mnemonic</code>() method removes
418
418
the mnemonic specified by <em class="parameter"><code>keyval</code></em> for the widget
419
 
specified by <em class="parameter"><code>target</code></em> from this window.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--mnemonic-activate"></a><h3>gtk.Window.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>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</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>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>modifier</code></strong> :</span></p></td><td>the modifiers</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>True if the activation was
 
419
specified by <em class="parameter"><code>target</code></em> from this window.</p></div><div class="refsect2" title="gtk.Window.mnemonic_activate"><a name="method-gtkwindow--mnemonic-activate"></a><h3>gtk.Window.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>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</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>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>modifier</code></strong> :</span></p></td><td>the modifiers</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>True if the activation was
420
420
done</td></tr></tbody></table><p>The<code class="methodname"> mnemonic_activate</code>() method
421
421
activates the targets associated with the mnemonic specified by
422
422
<em class="parameter"><code>keyval</code></em>. The window's mnemonic modifier must match
423
423
<em class="parameter"><code>modifier</code></em> to allow the activation to proceed. See the
424
424
<a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier"><code class="methodname">set_mnemonic_modifier</code>()</a> 
425
 
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-mnemonic-modifier"></a><h3>gtk.Window.set_mnemonic_modifier</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_mnemonic_modifier</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</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>modifier</code></strong> :</span></p></td><td>the modifier mask used to activate mnemonics on
 
425
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_mnemonic_modifier"><a name="method-gtkwindow--set-mnemonic-modifier"></a><h3>gtk.Window.set_mnemonic_modifier</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_mnemonic_modifier</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</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>modifier</code></strong> :</span></p></td><td>the modifier mask used to activate mnemonics on
426
426
this window.</td></tr></tbody></table><p>The <code class="methodname">set_mnemonic_modifier</code>() method sets
427
427
the mnemonic modifier for this window to the value specified by
428
428
<em class="parameter"><code>modifier</code></em>. The value of
429
429
<em class="parameter"><code>modifier</code></em> is one of:</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">gtk.gdk.SHIFT_MASK</code></span></p></td><td>The Shift key.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.CONTROL_MASK</code></span></p></td><td>The Control key. </td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.MOD1_MASK</code></span></p></td><td>The fourth modifier key (it depends on the modifier
430
430
mapping of the X server which key is interpreted as this modifier, but
431
 
normally it is the Alt key).</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-mnemonic-modifier"></a><h3>gtk.Window.get_mnemonic_modifier</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_mnemonic_modifier</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 mask used to activate mnemonics on
 
431
normally it is the Alt key).</td></tr></tbody></table><p></p></div><div class="refsect2" title="gtk.Window.get_mnemonic_modifier"><a name="method-gtkwindow--get-mnemonic-modifier"></a><h3>gtk.Window.get_mnemonic_modifier</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_mnemonic_modifier</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 mask used to activate mnemonics on
432
432
this window.</td></tr></tbody></table><p>The <code class="methodname">get_mnemonic_modifier</code>() method
433
433
returns the mnemonic modifier for this window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier"><code class="methodname">set_mnemonic_modifier</code>()</a> 
434
 
method for more detail.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--activate-key"></a><h3>gtk.Window.activate_key</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate_key</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 a mnemonic or
435
 
          accelerator was found and activated.</td></tr></tbody></table><div class="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">activate_key</code>() method activates
 
434
method for more detail.</p></div><div class="refsect2" title="gtk.Window.activate_key"><a name="method-gtkwindow--activate-key"></a><h3>gtk.Window.activate_key</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">activate_key</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 a mnemonic or
 
435
          accelerator was found and 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">activate_key</code>() method activates
436
436
mnemonics and accelerators for the window. This is normally called by the
437
437
default <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-press-event" title='The "key-press-event" gtk.Widget Signal'>key-press-event</a>" signal
438
438
handler for toplevel windows, however in some cases it may be useful to call
439
439
this directly when overriding the standard key handling for a toplevel
440
 
window.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--propagate-key-event"></a><h3>gtk.Window.propagate_key_event</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">propagate_key_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 a widget in the
441
 
          focus chain handled the event.</td></tr></tbody></table><div class="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">propagate_key_event</code>() method
 
440
window.</p></div><div class="refsect2" title="gtk.Window.propagate_key_event"><a name="method-gtkwindow--propagate-key-event"></a><h3>gtk.Window.propagate_key_event</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">propagate_key_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 a widget in the
 
441
          focus chain handled the event.</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">propagate_key_event</code>() method
442
442
propagates a key press or release event to the focus widget and up the focus
443
443
container chain until a widget handles the key event specified by
444
444
<em class="parameter"><code>event</code></em>. This is normally called by the default <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-press-event" title='The "key-press-event" gtk.Widget Signal'>key-press-event</a>" and
445
445
"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-release-event" title='The "key-release-event" gtk.Widget Signal'>key-release-event</a>"
446
446
signal handlers for toplevel windows, however in some cases it may be useful
447
447
to call this directly when overriding the standard key handling for a
448
 
toplevel window.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--present"></a><h3>gtk.Window.present</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">present</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">present</code>() method presents a window
 
448
toplevel window.</p></div><div class="refsect2" title="gtk.Window.present"><a name="method-gtkwindow--present"></a><h3>gtk.Window.present</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">present</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">present</code>() method presents a window
449
449
to the user. This may mean raising the window in the stacking order,
450
450
deiconifying it, moving it to the current desktop, and/or giving it the
451
451
keyboard focus, possibly dependent on the user's platform, window manager,
454
454
window that's already open. Say for example the preferences dialog is
455
455
currently open, and the user chooses <span class="guimenuitem">Preferences</span>
456
456
from the menu a second time; use the <code class="methodname">present</code>()
457
 
method to move the already-open dialog where the user can see it.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--iconify"></a><h3>gtk.Window.iconify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">iconify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">iconify</code>() method asks the window
 
457
method to move the already-open dialog where the user can see it.</p></div><div class="refsect2" title="gtk.Window.iconify"><a name="method-gtkwindow--iconify"></a><h3>gtk.Window.iconify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">iconify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">iconify</code>() method asks the window
458
458
manager to iconify (i.e. minimize) the specified the window. Note that you
459
459
shouldn't assume the window is definitely iconified afterward, because other
460
460
entities (e.g. the user or window manager) could deiconify it again, or
463
463
write code that crashes if not. This method can be called before showing a
464
464
window, in which case the window will be iconified before it ever appears
465
465
on-screen. You can track iconification via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
466
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--deiconify"></a><h3>gtk.Window.deiconify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">deiconify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">deiconify</code>() method asks the window
 
466
signal.</p></div><div class="refsect2" title="gtk.Window.deiconify"><a name="method-gtkwindow--deiconify"></a><h3>gtk.Window.deiconify</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">deiconify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">deiconify</code>() method asks the window
467
467
manager to deiconify (i.e. unminimize) the specified the window. Note that
468
468
you shouldn't assume the window is definitely deiconified afterward, because
469
469
other entities (e.g. the user or window manager) could iconify it again
470
470
before your code which assumes deiconification gets to run. You can track
471
471
iconification via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
472
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--stick"></a><h3>gtk.Window.stick</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">stick</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">stick</code>() method asks the window
 
472
signal.</p></div><div class="refsect2" title="gtk.Window.stick"><a name="method-gtkwindow--stick"></a><h3>gtk.Window.stick</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">stick</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">stick</code>() method asks the window
473
473
manager to stick the window, which means that it will appear on all user
474
474
desktops. Note that you shouldn't assume the window is definitely stuck
475
475
afterward, because other entities (e.g. the user or window manager) could
477
477
But normally the window will end up stuck. Just don't write code that
478
478
crashes if not. This method can be called before showing a window. You can
479
479
track stickiness via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
480
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--unstick"></a><h3>gtk.Window.unstick</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unstick</span>(<span class="methodparam"></span>)</code></pre><p>The unstick() method asks the window manager to unstick the
 
480
signal.</p></div><div class="refsect2" title="gtk.Window.unstick"><a name="method-gtkwindow--unstick"></a><h3>gtk.Window.unstick</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unstick</span>(<span class="methodparam"></span>)</code></pre><p>The unstick() method asks the window manager to unstick the
481
481
window, which means that it will appear on only one of the user's desktops.
482
482
Note that you shouldn't assume the window is definitely unstuck afterward,
483
483
because other entities (e.g. the user or window manager) could stick it
484
484
again. But normally the window will end up stuck. Just don't write code that
485
485
crashes if not. You can track stickiness via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
486
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--maximize"></a><h3>gtk.Window.maximize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">maximize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">maximize</code>() method asks the window
 
486
signal.</p></div><div class="refsect2" title="gtk.Window.maximize"><a name="method-gtkwindow--maximize"></a><h3>gtk.Window.maximize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">maximize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">maximize</code>() method asks the window
487
487
manager to maximize the window, so that it becomes full-screen. Note that
488
488
you shouldn't assume the window is definitely maximized afterward, because
489
489
other entities (e.g. the user or window manager) could unmaximize it again,
491
491
will end up maximized. This method can be called before showing a window, in
492
492
which case the window will be maximized when it appears on-screen initially.
493
493
You can track maximization via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
494
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--unmaximize"></a><h3>gtk.Window.unmaximize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unmaximize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unmaximize</code>() method asks the window
 
494
signal.</p></div><div class="refsect2" title="gtk.Window.unmaximize"><a name="method-gtkwindow--unmaximize"></a><h3>gtk.Window.unmaximize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unmaximize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unmaximize</code>() method asks the window
495
495
manager to unmaximize the window. Note that you shouldn't assume the window
496
496
is definitely unmaximized afterward, because other entities (e.g. the user
497
497
or window manager) could maximize it again, and not all window managers
498
498
honor requests to unmaximize. But normally the window will end up
499
499
unmaximized. You can track maximization via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
500
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--fullscreen"></a><h3>gtk.Window.fullscreen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">fullscreen</span>(<span class="methodparam"></span>)</code></pre><div class="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">fullscreen</code>() method requests the
 
500
signal.</p></div><div class="refsect2" title="gtk.Window.fullscreen"><a name="method-gtkwindow--fullscreen"></a><h3>gtk.Window.fullscreen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">fullscreen</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.2 and above.</p></div><p>The <code class="methodname">fullscreen</code>() method requests the
501
501
window manager to place the window in the fullscreen state. Note you
502
502
shouldn't assume the window is definitely full screen afterward, because
503
503
other entities (e.g. the user or window manager) could unfullscreen it
504
504
again, and not all window managers honor requests to fullscreen windows. But
505
505
normally the window will end up fullscreen. Just don't write code that
506
506
crashes if not.</p><p>You can track the fullscreen state via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
507
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--unfullscreen"></a><h3>gtk.Window.unfullscreen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unfullscreen</span>(<span class="methodparam"></span>)</code></pre><div class="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">unfullscreen</code>() method requests the
 
507
signal.</p></div><div class="refsect2" title="gtk.Window.unfullscreen"><a name="method-gtkwindow--unfullscreen"></a><h3>gtk.Window.unfullscreen</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unfullscreen</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.2 and above.</p></div><p>The <code class="methodname">unfullscreen</code>() method requests the
508
508
window manager to toggle off the fullscreen state for the window. Note that
509
509
you shouldn't assume the window is definitely not full screen afterward,
510
510
because other entities (e.g. the user or window manager) could fullscreen it
511
511
again, and not all window managers honor requests to unfullscreen
512
512
windows. But normally the window will end up restored to its normal
513
513
state. Just don't write code that crashes if not.</p><p>You can track the fullscreen state via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window_state_event</a>"
514
 
signal.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-keep-above"></a><h3>gtk.Window.set_keep_above</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_keep_above</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> keep the window
515
 
          above other windows</td></tr></tbody></table><div class="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_keep_above</code>() method requests
 
514
signal.</p></div><div class="refsect2" title="gtk.Window.set_keep_above"><a name="method-gtkwindow--set-keep-above"></a><h3>gtk.Window.set_keep_above</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_keep_above</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> keep the window
 
515
          above other windows</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_keep_above</code>() method requests
516
516
the window manager to keep the window on top if
517
517
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code>. Note that you
518
518
shouldn't assume the window is definitely above afterward, because other
523
523
signal.</p><p>Note that, according to the <a class="ulink" href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html" target="_top">Extended
524
524
Window Manager Hints</a> specification, the above state is mainly meant
525
525
for user preferences and should not be used by applications e.g. for drawing
526
 
attention to their dialogs.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-keep-below"></a><h3>gtk.Window.set_keep_below</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_keep_below</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</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>setting</code></em> :</span></p></td><td>if <code class="literal">True</code> keep the window
527
 
          below other windows</td></tr></tbody></table><div class="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_keep_below</code>() method requests
 
526
attention to their dialogs.</p></div><div class="refsect2" title="gtk.Window.set_keep_below"><a name="method-gtkwindow--set-keep-below"></a><h3>gtk.Window.set_keep_below</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_keep_below</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</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>setting</code></em> :</span></p></td><td>if <code class="literal">True</code> keep the window
 
527
          below other windows</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_keep_below</code>() method requests
528
528
the window manager to keep the window on the bottom (i.e. below all other
529
529
windows). Note that you shouldn't assume the window is definitely below
530
530
afterward, because other entities (e.g. the user or window manager) could
536
536
signal.</p><p>Note that, according to the <a class="ulink" href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html" target="_top">Extended
537
537
Window Manager Hints</a> specification, the above state is mainly meant
538
538
for user preferences and should not be used by applications e.g. for drawing
539
 
attention to their dialogs.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--begin-resize-drag"></a><h3>gtk.Window.begin_resize_drag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">begin_resize_drag</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>edge</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>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</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>edge</code></strong> :</span></p></td><td>the position of the resize
 
539
attention to their dialogs.</p></div><div class="refsect2" title="gtk.Window.begin_resize_drag"><a name="method-gtkwindow--begin-resize-drag"></a><h3>gtk.Window.begin_resize_drag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">begin_resize_drag</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>edge</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>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</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>edge</code></strong> :</span></p></td><td>the position of the resize
540
540
control</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>button</code></strong> :</span></p></td><td>the mouse button that initiated the
541
541
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_x</code></strong> :</span></p></td><td>the X position where the user clicked to
542
542
initiate the drag, in root window coordinates</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_y</code></strong> :</span></p></td><td>the Y position where the user clicked to
552
552
done using the standard mechanism for the window manager or windowing
553
553
system. Otherwise, <code class="literal">PyGTK</code> will try to emulate window
554
554
resizing, potentially not all that well, depending on the windowing
555
 
system.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--begin-move-drag"></a><h3>gtk.Window.begin_move_drag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">begin_move_drag</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>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</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>button</code></strong> :</span></p></td><td>the mouse button that initiated the
 
555
system.</p></div><div class="refsect2" title="gtk.Window.begin_move_drag"><a name="method-gtkwindow--begin-move-drag"></a><h3>gtk.Window.begin_move_drag</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">begin_move_drag</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>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</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>button</code></strong> :</span></p></td><td>the mouse button that initiated the
556
556
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_x</code></strong> :</span></p></td><td>the X position where the user clicked to
557
557
initiate the drag, in root window coordinates</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_y</code></strong> :</span></p></td><td>the Y position where the user clicked to
558
558
initiate the drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>timestamp</code></strong> :</span></p></td><td>the timestamp from the click event that
565
565
support it, the window movement will be done using the standard mechanism
566
566
for the window manager or windowing system. Otherwise,
567
567
<code class="literal">PyGTK</code> will try to emulate window movement, potentially
568
 
not all that well, depending on the windowing system.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-default-size"></a><h3>gtk.Window.set_default_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_default_size</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 in pixels, or -1 to unset the default
 
568
not all that well, depending on the windowing system.</p></div><div class="refsect2" title="gtk.Window.set_default_size"><a name="method-gtkwindow--set-default-size"></a><h3>gtk.Window.set_default_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_default_size</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 in pixels, or -1 to unset the default
569
569
width</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height</code></strong> :</span></p></td><td>the height in pixels, or -1 to unset the
570
570
default height</td></tr></tbody></table><p>The <code class="methodname">set_default_size</code>() method sets the
571
571
default size of the window to the specified <em class="parameter"><code>width</code></em> and
591
591
hiding, rather than using the default size. Windows can't actually be 0x0 in
592
592
size, they must be at least 1x1, but passing 0 for
593
593
<em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> is OK,
594
 
resulting in a 1x1 default size.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-default-size"></a><h3>gtk.Window.get_default_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_size</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 default width and height
 
594
resulting in a 1x1 default size.</p></div><div class="refsect2" title="gtk.Window.get_default_size"><a name="method-gtkwindow--get-default-size"></a><h3>gtk.Window.get_default_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_size</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 default width and height
595
595
of the window</td></tr></tbody></table><p>The <code class="methodname">get_default_size</code>() method returns a
596
596
tuple containing the default width and height of the window. A value of -1
597
597
for the returned width or height indicates that a default size has not been
598
598
explicitly set for that dimension, so the "natural" size of the window will
599
599
be used. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size"><code class="methodname">set_default_size</code>()</a>
600
 
method for more information</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--resize"></a><h3>gtk.Window.resize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">resize</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 in pixels to resize the window
 
600
method for more information</p></div><div class="refsect2" title="gtk.Window.resize"><a name="method-gtkwindow--resize"></a><h3>gtk.Window.resize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">resize</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 in pixels to resize the window
601
601
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height</code></strong> :</span></p></td><td>the height in pixels to resize the window
602
602
to</td></tr></tbody></table><p>The <code class="methodname">resize</code>() method resizes the window
603
603
to the specified <em class="parameter"><code>width</code></em> and
607
607
method to set the window's request to a smaller value. If the
608
608
<code class="methodname">resize</code>() method is called before showing a window
609
609
for the first time, it overrides any default size set with the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size"><code class="methodname">set_default_size</code>()</a> 
610
 
method. Windows may not be resized smaller than 1 by 1 pixels.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-size"></a><h3>gtk.Window.get_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size</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 width and height of the
 
610
method. Windows may not be resized smaller than 1 by 1 pixels.</p></div><div class="refsect2" title="gtk.Window.get_size"><a name="method-gtkwindow--get-size"></a><h3>gtk.Window.get_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_size</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 width and height of the
611
611
window</td></tr></tbody></table><p>The <code class="methodname">get_size</code>() method returns a tuple
612
612
containing the current width and height of the window. If the window is not
613
613
on-screen, it returns the size <code class="literal">PyGTK</code> will suggest to the
620
620
method then immediately call the <code class="methodname">get_size</code>() method,
621
621
the size won't have taken effect yet. After the window manager processes the
622
622
resize request, PyGTK receives notification that the size has changed via a
623
 
configure event, and the size of the window gets updated.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Nearly any use of this method creates a race condition,
 
623
configure event, and the size of the window gets updated.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Nearly any use of this method creates a race condition,
624
624
because the size of the window may change between the time that you get the
625
625
size and the time that you perform some action assuming that size is the
626
626
current size. To avoid race conditions, connect to "configure_event" on the
641
641
while your application cannot.</p><p>In any case, if you insist on application-specified window
642
642
positioning, there's <span class="emphasis"><em>still</em></span> a better way than doing it
643
643
yourself - the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-position" title="gtk.Window.set_position"><code class="methodname">set_position</code>()</a> 
644
 
method will frequently handle the details for you.</p></div></div><div class="refsect2" lang="en"><a name="method-gtkwindow--move"></a><h3>gtk.Window.move</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">move</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>)</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 to move window
 
644
method will frequently handle the details for you.</p></div></div><div class="refsect2" title="gtk.Window.move"><a name="method-gtkwindow--move"></a><h3>gtk.Window.move</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">move</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>)</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 to move window
645
645
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the Y coordinate to move window
646
646
to</td></tr></tbody></table><p>The <code class="methodname">move</code>() method asks the window
647
647
manager to move the window to the position specified by
673
673
</pre><p>The <a class="ulink" href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html" target="_top">Extended
674
674
Window Manager Hints</a> specification has a nice table of gravities in
675
675
the "implementation notes" section. The <a class="link" href="class-gtkwindow.html#method-gtkwindow--get-position" title="gtk.Window.get_position"><code class="methodname">get_position</code>()</a>
676
 
method documentation may also be relevant.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-position"></a><h3>gtk.Window.get_position</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_position</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
 
676
method documentation may also be relevant.</p></div><div class="refsect2" title="gtk.Window.get_position"><a name="method-gtkwindow--get-position"></a><h3>gtk.Window.get_position</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_position</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
677
677
the gravity-determined reference point</td></tr></tbody></table><p>The <code class="methodname">get_position</code>() method returns a
678
678
tuple containing the x and y coordinates of the window that you would need
679
679
to pass to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
702
702
applications do not have sufficient knowledge of window manager state. The
703
703
correct mechanism is to support the session management protocol (see the
704
704
"GnomeClient" object in the GNOME libraries for example) and allow the
705
 
window manager to save your window sizes and positions.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--parse-geometry"></a><h3>gtk.Window.parse_geometry</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">parse_geometry</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry</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>geometry</code></strong> :</span></p></td><td>the geometry string</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 string was parsed
 
705
window manager to save your window sizes and positions.</p></div><div class="refsect2" title="gtk.Window.parse_geometry"><a name="method-gtkwindow--parse-geometry"></a><h3>gtk.Window.parse_geometry</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">parse_geometry</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry</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>geometry</code></strong> :</span></p></td><td>the geometry string</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 string was parsed
706
706
successfully</td></tr></tbody></table><p>The <code class="methodname">parse_geometry</code>() method parses the
707
707
standard X Window System geometry string specified by
708
708
<em class="parameter"><code>geometry</code></em>. The geometry string has the format
719
719
<code class="literal">gtk.gdk.HINT_USER_POS</code> and
720
720
<code class="literal">gtk.gdk.HINT_USER_SIZE</code> hints indicating to the window
721
721
manager that the size and position of the window was user-specified. This
722
 
causes most window managers to honor the geometry.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--reshow-with-initial-size"></a><h3>gtk.Window.reshow_with_initial_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">reshow_with_initial_size</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">reshow_with_initial_size</code>() method
 
722
causes most window managers to honor the geometry.</p></div><div class="refsect2" title="gtk.Window.reshow_with_initial_size"><a name="method-gtkwindow--reshow-with-initial-size"></a><h3>gtk.Window.reshow_with_initial_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">reshow_with_initial_size</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">reshow_with_initial_size</code>() method
723
723
hides the window, then reshows it, resetting the default size and position
724
 
of the window. Used by GUI builders only.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--tooltips-get-info-from-tip-window"></a><h3>gtk.Window.tooltips_get_info_from_tip_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">tooltips_get_info_from_tip_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>a 2-tuple containing the <a class="link" href="class-gtktooltips.html" title="gtk.Tooltips"><code class="classname">gtk.Tooltips</code></a>
 
724
of the window. Used by GUI builders only.</p></div><div class="refsect2" title="gtk.Window.tooltips_get_info_from_tip_window"><a name="method-gtkwindow--tooltips-get-info-from-tip-window"></a><h3>gtk.Window.tooltips_get_info_from_tip_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">tooltips_get_info_from_tip_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>a 2-tuple containing the <a class="link" href="class-gtktooltips.html" title="gtk.Tooltips"><code class="classname">gtk.Tooltips</code></a>
725
725
          and <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
726
 
          displayed in the window or <code class="literal">None</code>.</td></tr></tbody></table><div class="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">tooltips_get_info_from_tip_window</code>()
 
726
          displayed in the window 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.4 and above.</p></div><p>The <code class="methodname">tooltips_get_info_from_tip_window</code>()
727
727
method returns a 2-tuple containing the <a class="link" href="class-gtktooltips.html" title="gtk.Tooltips"><code class="classname">gtk.Tooltips</code></a> and
728
728
<a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
729
729
displayed in the window. If the window is not displaying tooltips this
730
730
method returns None. This method is mostly intended for use by accessibility
731
 
technologies - applications should have little use for it.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-focus-on-map"></a><h3>gtk.Window.set_focus_on_map</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_focus_on_map</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>If <code class="literal">True</code> this window would
732
 
like to receive focus when mapped.</td></tr></tbody></table><div class="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">set_focus_on_map</code>() method sets the
 
731
technologies - applications should have little use for it.</p></div><div class="refsect2" title="gtk.Window.set_focus_on_map"><a name="method-gtkwindow--set-focus-on-map"></a><h3>gtk.Window.set_focus_on_map</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_focus_on_map</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>If <code class="literal">True</code> this window would
 
732
like to receive focus when mapped.</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">set_focus_on_map</code>() method sets the
733
733
"focus-on-map" property to the value of <em class="parameter"><code>setting</code></em>. If
734
734
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code> a hint is set
735
735
asking the desktop environment to give focus to the window when it is
736
 
mapped.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-focus-on-map"></a><h3>gtk.Window.get_focus_on_map</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_focus_on_map</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 window would
737
 
like to receive focus when mapped.</td></tr></tbody></table><div class="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">get_focus_on_map</code>() method returns
 
736
mapped.</p></div><div class="refsect2" title="gtk.Window.get_focus_on_map"><a name="method-gtkwindow--get-focus-on-map"></a><h3>gtk.Window.get_focus_on_map</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_focus_on_map</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 window would
 
737
like to receive focus when mapped.</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">get_focus_on_map</code>() method returns
738
738
the value of the "focus-on-map" property. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-focus-on-map" title="gtk.Window.set_focus_on_map"><code class="methodname">set_focus_on_map</code>()</a>
739
 
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-icon-name"></a><h3>gtk.Window.set_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon_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 of the themed icon or
740
 
<code class="literal">None</code></td></tr></tbody></table><div class="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">set_icon_name</code>() method sets the
 
739
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_icon_name"><a name="method-gtkwindow--set-icon-name"></a><h3>gtk.Window.set_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_icon_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 of the themed icon or
 
740
<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">set_icon_name</code>() method sets the
741
741
"icon-name" property to the value of <em class="parameter"><code>name</code></em>. If
742
742
<em class="parameter"><code>name</code></em> is <code class="literal">None</code>, then the default
743
743
themed icon will be used. The "icon-name" property contains the name of the
744
744
icon used for the window. See the <a class="link" href="class-gtkicontheme.html" title="gtk.IconTheme"><code class="classname">gtk.IconTheme</code></a>
745
 
reference for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-icon-name"></a><h3>gtk.Window.get_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_icon_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 themed icon used for the
746
 
window icon or <code class="literal">None</code> if no icon is set.</td></tr></tbody></table><div class="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">get_icon_name</code>() method returns the
 
745
reference for more information.</p></div><div class="refsect2" title="gtk.Window.get_icon_name"><a name="method-gtkwindow--get-icon-name"></a><h3>gtk.Window.get_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_icon_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 themed icon used for the
 
746
window icon or <code class="literal">None</code> if no icon is 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">get_icon_name</code>() method returns the
747
747
name of the themed icon for the window, see the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-name" title="gtk.Window.set_icon_name"><code class="methodname">set_icon_name</code>()</a>
748
 
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-urgency-hint"></a><h3>gtk.Window.set_urgency_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_urgency_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>urgency_hint</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>urgency_hint</code></strong> :</span></p></td><td>if <code class="literal">True</code> mark this window
749
 
as needing urgent attention.</td></tr></tbody></table><div class="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_urgency_hint</code>() method sets the
 
748
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_urgency_hint"><a name="method-gtkwindow--set-urgency-hint"></a><h3>gtk.Window.set_urgency_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_urgency_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>urgency_hint</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>urgency_hint</code></strong> :</span></p></td><td>if <code class="literal">True</code> mark this window
 
749
as needing urgent attention.</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_urgency_hint</code>() method sets the
750
750
"urgency-hint" property to the value of
751
751
<em class="parameter"><code>urgency_hint</code></em>. If the "urgency-hint" property is True
752
752
the window sets a hint to the desktop environment to draw the users
753
 
attention to the window.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-urgency-hint"></a><h3>gtk.Window.get_urgency_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_urgency_hint</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 window is marked
754
 
as needing urgent user attention.</td></tr></tbody></table><div class="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">get_urgency_hint</code>() method returns
 
753
attention to the window.</p></div><div class="refsect2" title="gtk.Window.get_urgency_hint"><a name="method-gtkwindow--get-urgency-hint"></a><h3>gtk.Window.get_urgency_hint</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_urgency_hint</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 window is marked
 
754
as needing urgent user attention.</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">get_urgency_hint</code>() method returns
755
755
the value of the "urgency-hint" property. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-urgency-hint" title="gtk.Window.set_urgency_hint"><code class="methodname">set_urgency_hint</code>()</a>
756
 
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--present-with-time"></a><h3>gtk.Window.present_with_time</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">present_with_time</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</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>timestamp</code></strong> :</span></p></td><td>the timestamp of the user interaction (typically
757
 
a button or key press event) which triggered this call</td></tr></tbody></table><div class="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">present_with_time</code>() method presents
 
756
method for more information.</p></div><div class="refsect2" title="gtk.Window.present_with_time"><a name="method-gtkwindow--present-with-time"></a><h3>gtk.Window.present_with_time</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">present_with_time</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</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>timestamp</code></strong> :</span></p></td><td>the timestamp of the user interaction (typically
 
757
a button or key press event) which triggered this call</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">present_with_time</code>() method presents
758
758
a window to the user in response to a user interaction. If you need to
759
759
present a window without a timestamp, use the <a class="link" href="class-gtkwindow.html#method-gtkwindow--present" title="gtk.Window.present"><code class="methodname">present</code>()</a>
760
 
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-deletable"></a><h3>gtk.Window.set_deletable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_deletable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> decorate the window
761
 
          as deletable</td></tr></tbody></table><div class="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>By default, windows have a close button in the window
 
760
method.</p></div><div class="refsect2" title="gtk.Window.set_deletable"><a name="method-gtkwindow--set-deletable"></a><h3>gtk.Window.set_deletable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_deletable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> decorate the window
 
761
          as deletable</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>By default, windows have a close button in the window
762
762
      frame. Some window managers allow GTK+ to disable this button. If you
763
763
      set the deletable property to <code class="literal">False</code> using this
764
764
      method, GTK+ will do its best to convince the window manager not to
766
766
      any effect when called on a window that is already visible, so you
767
767
      should call it before calling
768
768
      <code class="methodname">gtk_window_show</code>().</p><p>On Windows, this method always works, since there's no window
769
 
      manager policy involved.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-deletable"></a><h3>gtk.Window.get_deletable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_deletable</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 window has been
770
 
          set to have a close button</td></tr></tbody></table><div class="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>Returns whether the window has been set to have a close button
 
769
      manager policy involved.</p></div><div class="refsect2" title="gtk.Window.get_deletable"><a name="method-gtkwindow--get-deletable"></a><h3>gtk.Window.get_deletable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_deletable</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 window has been
 
770
          set to have a close button</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>Returns whether the window has been set to have a close button
771
771
      via the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-deletable" title="gtk.Window.set_deletable"><code class="methodname">gtk.Window.set_deletable()</code></a>
772
 
      method.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-group"></a><h3>gtk.Window.get_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_group</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-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
773
 
          for a window or the default group</td></tr></tbody></table><div class="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>Returns the <a class="link" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
 
772
      method.</p></div><div class="refsect2" title="gtk.Window.get_group"><a name="method-gtkwindow--get-group"></a><h3>gtk.Window.get_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_group</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-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
 
773
          for a window or the default group</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>Returns the <a class="link" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
774
774
      or the default group, if the window does not have an explicit window
775
 
      group.</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-opacity"></a><h3>gtk.Window.set_opacity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_opacity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>opacity</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>opacity</code></strong> :</span></p></td><td>desired opacity, between 0 and 1.</td></tr></tbody></table><div class="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>
 
775
      group.</p></div><div class="refsect2" title="gtk.Window.set_opacity"><a name="method-gtkwindow--set-opacity"></a><h3>gtk.Window.set_opacity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_opacity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>opacity</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>opacity</code></strong> :</span></p></td><td>desired opacity, between 0 and 1.</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>
776
776
        Request the windowing system to make window partially transparent, with
777
777
        opacity 0 being fully transparent and 1 fully opaque. (Values of the
778
778
        opacity parameter are clamped to the [0,1] range.) On X11 this has any
781
781
        On Windows it should work always.
782
782
      </p><p>        
783
783
        Note that setting a window's opacity after the window has been shown causes it to flicker once on Windows.
784
 
      </p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-opacity"></a><h3>gtk.Window.get_opacity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_opacity</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 requested opacity for this window.</td></tr></tbody></table><div class="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>Fetches the requested opacity for this window. See
785
 
      <code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-opacity" title="gtk.Window.set_opacity">gtk.Window.set_opacity</a></code>().</p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--set-startup-id"></a><h3>gtk.Window.set_startup_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_startup_id</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>startup_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>startup_id</code></strong> :</span></p></td><td>a string with startup-notification identifier</td></tr></tbody></table><div class="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>
 
784
      </p></div><div class="refsect2" title="gtk.Window.get_opacity"><a name="method-gtkwindow--get-opacity"></a><h3>gtk.Window.get_opacity</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_opacity</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 requested opacity for this 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.12 and above.</p></div><p>Fetches the requested opacity for this window. See
 
785
      <code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-opacity" title="gtk.Window.set_opacity">gtk.Window.set_opacity</a></code>().</p></div><div class="refsect2" title="gtk.Window.set_startup_id"><a name="method-gtkwindow--set-startup-id"></a><h3>gtk.Window.set_startup_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_startup_id</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>startup_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>startup_id</code></strong> :</span></p></td><td>a string with startup-notification identifier</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>
786
786
        Startup notification identifiers are used by desktop environment to track
787
787
        application startup, to provide user feedback and other features. This
788
788
        function changes the corresponding property on the underlying GdkWindow.
793
793
        or any equivalent function generating a window map event.
794
794
      </p><p>        
795
795
        This function is only useful on X11, not with other GTK+ targets.
796
 
      </p></div><div class="refsect2" lang="en"><a name="method-gtkwindow--get-default-widget"></a><h3>gtk.Window.get_default_widget</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_widget</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 widget, or <code class="literal">None</code>
797
 
          if there is none.</td></tr></tbody></table><div class="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>
 
796
      </p></div><div class="refsect2" title="gtk.Window.get_default_widget"><a name="method-gtkwindow--get-default-widget"></a><h3>gtk.Window.get_default_widget</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_widget</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 widget, or <code class="literal">None</code>
 
797
          if there is none.</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>
798
798
        Returns the default widget for window. See
799
799
        <code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default" title="gtk.Window.set_default">gtk.Window.set_default</a></code>()()
800
800
        for more details.
801
 
      </p></div></div><div class="refsect1" lang="en"><a name="id3907370"></a><h2>Functions</h2><div class="refsect2" lang="en"><a name="function-gtk--window-set-default-icon-list"></a><h3>gtk.window_set_default_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon_list</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>...</code></em> :</span></p></td><td>zero or more <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
 
801
      </p></div></div><div class="refsect1" title="Functions"><a name="id4217472"></a><h2>Functions</h2><div class="refsect2" title="gtk.window_set_default_icon_list"><a name="function-gtk--window-set-default-icon-list"></a><h3>gtk.window_set_default_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon_list</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>...</code></em> :</span></p></td><td>zero or more <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
802
802
objects</td></tr></tbody></table><p>The <code class="function">gtk.window_set_default_icon_list</code>()
803
803
function sets an icon list to be used as fallback for windows that haven't
804
804
had the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a> 
805
805
method called on them to set up a window-specific icon list. This function
806
806
allows you to set up the icon for all windows in your app at once. See the
807
807
<a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a> 
808
 
method documentation for more details.</p></div><div class="refsect2" lang="en"><a name="function-gtk--window-set-default-icon"></a><h3>gtk.window_set_default_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</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</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a></td></tr></tbody></table><div class="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.window_set_default_icon</code>() function
 
808
method documentation for more details.</p></div><div class="refsect2" title="gtk.window_set_default_icon"><a name="function-gtk--window-set-default-icon"></a><h3>gtk.window_set_default_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</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</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</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 function is available in PyGTK 2.4 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon</code>() function
809
809
sets an icon specified by <em class="parameter"><code>icon</code></em> to be used as the
810
810
fallback for windows that haven't had the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
811
811
method called on them to set up a window-specific icon. This function allows
812
 
you to set up the icon for all windows in your app at once.</p></div><div class="refsect2" lang="en"><a name="function-gtk--window-set-default-icon-from-file"></a><h3>gtk.window_set_default_icon_from_file</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon_from_file</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</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>filename</code></strong> :</span></p></td><td>an icon file name</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.2 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon_from_file</code>()
 
812
you to set up the icon for all windows in your app at once.</p></div><div class="refsect2" title="gtk.window_set_default_icon_from_file"><a name="function-gtk--window-set-default-icon-from-file"></a><h3>gtk.window_set_default_icon_from_file</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon_from_file</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</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>filename</code></strong> :</span></p></td><td>an icon file 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 function is available in PyGTK 2.2 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon_from_file</code>()
813
813
function sets an icon contained in the file specified by
814
814
<em class="parameter"><code>filename</code></em> to be used as the fallback for windows that
815
815
haven't had the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
816
816
method called on them to set up a window-specific icon. This function allows
817
817
you to set up the icon for all windows in your app at once.</p><p>The GError exception is raised if an error occurs while loading
818
 
the icon pixbuf from <em class="parameter"><code>filename</code></em>.</p></div><div class="refsect2" lang="en"><a name="function-gtk--window-get-default-icon-list"></a><h3>gtk.window_get_default_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_get_default_icon_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>a copy of the applications default icon
 
818
the icon pixbuf from <em class="parameter"><code>filename</code></em>.</p></div><div class="refsect2" title="gtk.window_get_default_icon_list"><a name="function-gtk--window-get-default-icon-list"></a><h3>gtk.window_get_default_icon_list</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_get_default_icon_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>a copy of the applications default icon
819
819
list</td></tr></tbody></table><p>The <code class="function">gtk.window_get_default_icon_list</code>()
820
820
function returns the application's default icon list as set by the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list"><code class="methodname">gtk.window_set_default_icon_list</code>()</a> 
821
821
function. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a> 
822
 
method documentation for more details.</p></div><div class="refsect2" lang="en"><a name="function-gtk--window-set-auto-startup-notification"></a><h3>gtk.window_set_auto_startup_notification</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_auto_startup_notification</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"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code>, automatically do
823
 
          startup notification</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.2 and above.</p></div><p>The
 
822
method documentation for more details.</p></div><div class="refsect2" title="gtk.window_set_auto_startup_notification"><a name="function-gtk--window-set-auto-startup-notification"></a><h3>gtk.window_set_auto_startup_notification</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_auto_startup_notification</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"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code>, automatically do
 
823
          startup notification</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.2 and above.</p></div><p>The
824
824
<code class="function">gtk.window_set_auto_startup_notification</code>() function
825
825
sets the auto startup notification setting to the value of <em class="parameter"><code>setting</code></em>. If <em class="parameter"><code>setting</code></em> is <code class="literal">True</code> startup notification will be done automatically.</p><p>By default, after showing the first <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> for each
826
826
<a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>, GTK+
830
830
notification until after your real main window has been shown. In that
831
831
example, you would disable startup notification temporarily, show your
832
832
splash screen, then re-enable it so that showing the main window would
833
 
automatically result in notification.</p></div><div class="refsect2" lang="en"><a name="function-gtk--window-list-toplevels"></a><h3>gtk.window_list_toplevels</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_list_toplevels</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 list of all the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
 
833
automatically result in notification.</p></div><div class="refsect2" title="gtk.window_list_toplevels"><a name="function-gtk--window-list-toplevels"></a><h3>gtk.window_list_toplevels</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_list_toplevels</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 list of all the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
834
834
widgets</td></tr></tbody></table><p>The <code class="function">gtk.window_list_toplevels</code>() function
835
835
returns a list of all the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> widgets
836
 
in the application.</p></div><div class="refsect2" lang="en"><a name="function-gtk--window-set-default-icon-name"></a><h3>gtk.window_set_default_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon_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"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code>, automatically do
837
 
          startup notification</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.6 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon_name</code>()
 
836
in the application.</p></div><div class="refsect2" title="gtk.window_set_default_icon_name"><a name="function-gtk--window-set-default-icon-name"></a><h3>gtk.window_set_default_icon_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.window_set_default_icon_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"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code>, automatically do
 
837
          startup notification</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.6 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon_name</code>()
838
838
function sets an icon to be used as fallback for windows that haven't had
839
839
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
840
840
method called on them from a named themed icon, see the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-name" title="gtk.Window.set_icon_name"><code class="methodname">set_icon_name</code>()</a>
841
 
method.</p></div></div><div class="refsect1" lang="en"><a name="id3908087"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gtkwindow--activate-default"></a><h3>The "activate-default" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
 
841
method.</p></div></div><div class="refsect1" title="Signals"><a name="id4218189"></a><h2>Signals</h2><div class="refsect2" title='The "activate-default" gtk.Window Signal'><a name="signal-gtkwindow--activate-default"></a><h3>The "activate-default" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
842
842
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
843
843
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
844
844
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
845
845
any)</td></tr></tbody></table><p>The "activate-default" signal is emitted when the default child
846
846
widget of <em class="parameter"><code>window</code></em> is activated usually by the user
847
 
pressing the <span class="keycap"><strong>Return</strong></span> or <span class="keycap"><strong>Enter</strong></span> key.</p></div><div class="refsect2" lang="en"><a name="signal-gtkwindow--activate-focus"></a><h3>The "activate-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
 
847
pressing the <span class="keycap"><strong>Return</strong></span> or <span class="keycap"><strong>Enter</strong></span> key.</p></div><div class="refsect2" title='The "activate-focus" gtk.Window Signal'><a name="signal-gtkwindow--activate-focus"></a><h3>The "activate-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
848
848
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
849
849
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
850
850
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
851
851
any)</td></tr></tbody></table><p>The "activate-focus" signal is emitted when the child widget
852
852
with the focus is activated usually by the user pressing the
853
 
<span class="keycap"><strong>Space</strong></span> key.</p></div><div class="refsect2" lang="en"><a name="signal-gtkwindow--frame-event"></a><h3>The "frame-event" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
 
853
<span class="keycap"><strong>Space</strong></span> key.</p></div><div class="refsect2" title='The "frame-event" gtk.Window Signal'><a name="signal-gtkwindow--frame-event"></a><h3>The "frame-event" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
854
854
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
855
855
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
856
856
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
858
858
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
859
859
          from being invoked for the event. <code class="literal">False</code> to
860
860
          propagate the event further.</td></tr></tbody></table><p>The "frame-event" signal is emitted when an event other than key
861
 
press or release or focus change is received on the window's frame.</p></div><div class="refsect2" lang="en"><a name="signal-gtkwindow--keys-changed"></a><h3>The "keys-changed" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
 
861
press or release or focus change is received on the window's frame.</p></div><div class="refsect2" title='The "keys-changed" gtk.Window Signal'><a name="signal-gtkwindow--keys-changed"></a><h3>The "keys-changed" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
862
862
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
863
863
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
864
864
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
865
865
any)</td></tr></tbody></table><p>The "keys-changed" signal is emitted when a mnemonic accelerator
866
 
is added, removed or changed or the mnemonic modifier is set.</p></div><div class="refsect2" lang="en"><a name="signal-gtkwindow--move-focus"></a><h3>The "move-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
 
866
is added, removed or changed or the mnemonic modifier is set.</p></div><div class="refsect2" title='The "move-focus" gtk.Window Signal'><a name="signal-gtkwindow--move-focus"></a><h3>The "move-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</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>window</code></em> :</span></p></td><td>the window that received the
867
867
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td><td>the move direction:
868
868
<code class="literal">gtk.DIR_TAB_FORWARD</code>,
869
869
<code class="literal">gtk.DIR_TAB_BACKWARD</code>, <code class="literal">gtk.DIR_UP</code>,
875
875
within the window's child widgets. Usually this happens when the user
876
876
presses the <span class="keycap"><strong>Tab</strong></span>, the <span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Tab</strong></span> or the
877
877
<span class="keycap"><strong>Up</strong></span>, <span class="keycap"><strong>Down</strong></span>, <span class="keycap"><strong>Left</strong></span> or
878
 
<span class="keycap"><strong>Right</strong></span> arrow keys.</p></div><div class="refsect2" lang="en"><a name="signal-gtkwindow--set-focus"></a><h3>The "set-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></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>window</code></em> :</span></p></td><td>the window that received the
 
878
<span class="keycap"><strong>Right</strong></span> arrow keys.</p></div><div class="refsect2" title='The "set-focus" gtk.Window Signal'><a name="signal-gtkwindow--set-focus"></a><h3>The "set-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></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>window</code></em> :</span></p></td><td>the window that received the
879
879
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that receives the
880
880
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
881
881
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>