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>
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>
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
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
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>
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.
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>
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,
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
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
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
793
793
or any equivalent function generating a window map event.
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>,