PyGobject（三十二）布局容器之Window

Gtk.Window

Gtk.Window是一个可以包含其他部件一个顶层窗口。允许用户操作窗口（调整其大小，移动它，关闭它，…）

继承关系

Gtk.Window是Gtk.Bin的直接子类

Methods

方法修饰词	方法名及参数
static	get_default_icon_list ()
static	get_default_icon_name ()
static	list_toplevels ()
static	new (type)
static	set_auto_startup_notification (setting)
static	set_default_icon (icon)
static	set_default_icon_from_file (filename)
static	set_default_icon_list (list)
static	set_default_icon_name (name)
static	set_interactive_debugging (enable)
	activate_default ()
	activate_focus ()
	activate_key (event)
	add_accel_group (accel_group)
	add_mnemonic (keyval, target)
	begin_move_drag (button, root_x, root_y, timestamp)
	begin_resize_drag (edge, button, root_x, root_y, timestamp)
	close ()
	deiconify ()
	fullscreen ()
	fullscreen_on_monitor (screen, monitor)
	get_accept_focus ()
	get_application ()
	get_attached_to ()
	get_decorated ()
	get_default_size ()
	get_default_widget ()
	get_deletable ()
	get_destroy_with_parent ()
	get_focus ()
	get_focus_on_map ()
	get_focus_visible ()
	get_gravity ()
	get_group ()
	get_has_resize_grip ()
	get_hide_titlebar_when_maximized ()
	get_icon ()
	get_icon_list ()
	get_icon_name ()
	get_mnemonic_modifier ()
	get_mnemonics_visible ()
	get_modal ()
	get_opacity ()
	get_position ()
	get_resizable ()
	get_resize_grip_area ()
	get_role ()
	get_screen ()
	get_size ()
	get_skip_pager_hint ()
	get_skip_taskbar_hint ()
	get_title ()
	get_titlebar ()
	get_transient_for ()
	get_type_hint ()
	get_urgency_hint ()
	get_window_type ()
	has_group ()
	has_toplevel_focus ()
	iconify ()
	is_active ()
	is_maximized ()
	maximize ()
	mnemonic_activate (keyval, modifier)
	move (x, y)
	parse_geometry (geometry)
	present ()
	present_with_time (timestamp)
	propagate_key_event (event)
	remove_accel_group (accel_group)
	remove_mnemonic (keyval, target)
	reshow_with_initial_size ()
	resize (width, height)
	resize_grip_is_visible ()
	resize_to_geometry (width, height)
	set_accept_focus (setting)
	set_application (application)
	set_attached_to (attach_widget)
	set_decorated (setting)
	set_default (default_widget)
	set_default_geometry (width, height)
	set_default_size (width, height)
	set_deletable (setting)
	set_destroy_with_parent (setting)
	set_focus (focus)
	set_focus_on_map (setting)
	set_focus_visible (setting)
	set_geometry_hints (geometry_widget, geometry, geom_mask)
	set_gravity (gravity)
	set_has_resize_grip (value)
	set_has_user_ref_count (setting)
	set_hide_titlebar_when_maximized (setting)
	set_icon (icon)
	set_icon_from_file (filename)
	set_icon_list (list)
	set_icon_name (name)
	set_keep_above (setting)
	set_keep_below (setting)
	set_mnemonic_modifier (modifier)
	set_mnemonics_visible (setting)
	set_modal (modal)
	set_opacity (opacity)
	set_position (position)
	set_resizable (resizable)
	set_role (role)
	set_screen (screen)
	set_skip_pager_hint (setting)
	set_skip_taskbar_hint (setting)
	set_startup_id (startup_id)
	set_title (title)
	set_titlebar (titlebar)
	set_transient_for (parent)
	set_type_hint (hint)
	set_urgency_hint (setting)
	set_wmclass (wmclass_name, wmclass_class)
	stick ()
	unfullscreen ()
	unmaximize ()
	unstick ()

---

static get_default_icon_list ()

获取由Gtk.Window.set_default_icon_list()设置的值.一次性设置所有窗口的默认图标，包含各种分辨率的图标

static get_default_icon_name ()

获取由Gtk.Window.set_default_icon_name，默认图标的名称

static list_toplevels ()

获取已经存在的顶层窗口列表

static new (type)

    Parameters: type (Gtk.WindowType) – 窗口类型

static set_auto_startup_notification (setting)

static set_default_icon (icon)

设置应用程序的默认图标，目前发现在Gtk.AboutDialog中有用到

static set_default_icon_from_file (filename)

作用同上，不过这个是从给定的路径中加载图片

static set_default_icon_list (list)

设置图标列表，包含各种分辨率的

static set_default_icon_name (name)

设置默认图标名称

static set_interactive_debugging (enable)

显示交互式的Debug界面

activate_default ()

激活窗口中的默认部件，如果成功返回True

activate_focus ()

激活窗口中获得焦点的部件，如果成功返回True

activate_key (event)

如果一个助记符或者绑定的快捷键被发现，返回True

add_accel_group (accel_group)

    Parameters: accel_group (Gtk.AccelGroup) – a Gtk.AccelGroup
添加快捷键组
参见PyGobject（五十九）布局容器之Menu例三

add_mnemonic (keyval, target)

    Parameters:
       keyval (int) – 助记符
       target (Gtk.Widget) – 绑定的部件
添加助记符

begin_move_drag (button, root_x, root_y, timestamp)

开始拖动窗口

begin_resize_drag (edge, button, root_x, root_y, timestamp)

开始调整窗口大小

close ()

关闭窗口

deiconify ()

取消窗口图标化

fullscreen ()

全屏

fullscreen_on_monitor (screen, monitor)

在指定的一个显示器上全屏

get_accept_focus ()

设置窗口是否可以获得输入焦点

get_application ()

获取窗口所绑定的Gtk.Application

get_attached_to ()

获取窗口所依附的部件

get_decorated ()

获取窗口是使用titlebar来装饰窗口

get_default_size ()

获取窗口默认大小

get_default_widget ()

获取默认部件

get_deletable ()

获取是否已经取消关闭按钮

get_destroy_with_parent ()

获取是否允许当父窗口销毁时自动销毁自己

get_focus ()

获取当前窗口获得焦点的部件

get_focus_on_map ()

当窗口映射后，窗口是否获得能够获得输入焦点

get_focus_visible ()

是否显示焦点矩形框

get_gravity ()

get_group ()

get_has_resize_grip ()

Deprecated

get_hide_titlebar_when_maximized ()

当最大化时是否隐藏titlebar

get_icon ()

获取图标

get_icon_list ()

获取图标列表

get_icon_name ()

获取图标名称

get_mnemonic_modifier ()

get_mnemonics_visible ()

助记符是否可见

get_modal ()

get_opacity ()

获取窗口透明度

get_position ()

获取窗口位置

get_resizable ()

获取是否可调整窗口大小

get_resize_grip_area ()

get_role ()

get_screen ()

get_size ()

获取窗口宽高

get_skip_pager_hint ()

get_skip_taskbar_hint ()

get_title ()

获取标题

get_titlebar ()

获取titlebar

get_transient_for ()

get_type_hint ()

get_urgency_hint ()

get_window_type ()

获取窗口类型

has_group ()

has_toplevel_focus ()

iconify ()

只显示图片，不显示窗口

is_active ()

窗口是否激活

is_maximized ()

窗口是否已经最大化

maximize ()

窗口最大化

mnemonic_activate (keyval, modifier)

move (x, y)

将窗口移动到某个位置

parse_geometry (geometry)

present ()

显示窗口

present_with_time (timestamp)

propagate_key_event (event)

remove_accel_group (accel_group)

移除快捷键组

remove_mnemonic (keyval, target)

移除部件的助记符

reshow_with_initial_size ()

resize (width, height)

调整窗口大小

resize_grip_is_visible ()

resize_to_geometry (width, height)

set_accept_focus (setting)

set_application (application)

set_attached_to (attach_widget)

set_decorated (setting)

默认使用titlebar装饰窗口，包括最大化最小化。
如果设置False，则不显示

set_default (default_widget)

设置默认部件

set_default_geometry (width, height)

Deprecated ，使用set_default_size代替

set_default_size (width, height)

设置窗口的固定大小

set_deletable (setting)

在某些窗口管理系统中取消关闭按钮

set_destroy_with_parent (setting)

当父窗口销毁时，自己是否销毁，常用在Dialog中

set_focus (focus)

设置获取焦点的部件

set_focus_on_map (setting)

set_focus_visible (setting)

set_geometry_hints (geometry_widget, geometry, geom_mask)

set_gravity (gravity)

set_has_resize_grip (value)

set_has_user_ref_count (setting)

set_hide_titlebar_when_maximized (setting)

当最大化的时候，是否隐藏titlebar

set_icon (icon)

设置图标

set_icon_from_file (filename)

设置图标，已给定的文件路径

set_icon_list (list)

设置图标列表

set_icon_name (name)

设置图标名称

set_keep_above (setting)

窗口置顶，永远显示在其他窗口之上

set_keep_below (setting)

窗口在其它窗口之下

set_mnemonic_modifier (modifier)

set_mnemonics_visible (setting)

set_modal (modal)

set_opacity (opacity)

设置透明度

set_position (position)

set_resizable (resizable)

设置是否可调整大小

set_role (role)

set_screen (screen)

set_skip_pager_hint (setting)

set_skip_taskbar_hint (setting)

set_startup_id (startup_id)

set_title (title)

设置标题

set_titlebar (titlebar)

设置Titlebar

set_transient_for (parent)

set_type_hint (hint)

set_urgency_hint (setting)

set_wmclass (wmclass_name, wmclass_class)

stick ()

unfullscreen ()

取消全屏

unmaximize ()

取消最大化

unstick ()

Virtual Methods

do_activate_default ()
do_activate_focus ()
do_enable_debugging (toggle)
do_keys_changed ()
do_set_focus (focus)

Properties

Name	Type	Flags	Short Description
accept-focus	bool	r/w/en	True if the window should receive the input focus.
application	Gtk.Application	r/w/en	The Gtk.Application for the window
attached-to	Gtk.Widget	r/w/c/en	The widget where the window is attached
decorated	bool	r/w/en	Whether the window should be decorated by the window manager
default-height	int	r/w/en	The default height of the window, used when initially showing the window
default-width	int	r/w/en	The default width of the window, used when initially showing the window
deletable	bool	r/w/en	Whether the window frame should have a close button
destroy-with-parent	bool	r/w/en	If this window should be destroyed when the parent is destroyed
focus-on-map	bool	r/w/en	True if the window should receive the input focus when mapped.
focus-visible	bool	r/w/en	Whether focus rectangles are currently visible in this window
gravity	Gdk.Gravity	r/w/en	The window gravity of the window
has-resize-grip	bool	d/r/w/en	Specifies whether the window should have a resize grip deprecated
has-toplevel-focus	bool	r	Whether the input focus is within this Gtk.Window
hide-titlebar-when-maximized	bool	r/w/en	If this window’s titlebar should be hidden when the window is maximized
icon	GdkPixbuf.Pixbuf	r/w/en	Icon for this window
icon-name	str	r/w/en	Name of the themed icon for this window
is-active	bool	r	Whether the toplevel is the current active window
is-maximized	bool	r	Whether the window is maximized
mnemonics-visible	bool	r/w/en	Whether mnemonics are currently visible in this window
modal	bool	r/w/en	If True, the window is modal (other windows are not usable while this one is up)
resizable	bool	r/w/en	If True, users can resize the window
resize-grip-visible	bool	d/r	Specifies whether the window’s resize grip is visible. deprecated
role	str	r/w	Unique identifier for the window to be used when restoring a session
screen	Gdk.Screen	r/w/en	The screen where this window will be displayed
skip-pager-hint	bool	r/w/en	True if the window should not be in the pager.
skip-taskbar-hint	bool	r/w/en	True if the window should not be in the task bar.
startup-id	str	w	Unique startup identifier for the window used by startup-notification
title	str	r/w	The title of the window
transient-for	Gtk.Window	r/w/c/en	The transient parent of the dialog
type	Gtk.WindowType	r/w/co	The type of the window
type-hint	Gdk.WindowTypeHint	r/w/en	Hint to help the desktop environment understand what kind of window this is and how to treat it.
urgency-hint	bool	r/w/en	True if the window should be brought to the user’s attention.
window-position	Gtk.WindowPosition	r/w/en	The initial position of the window

Signals

Name	Short Description
activate-default	The ::activate-default signal is a keybinding signal which gets emitted when the user activates the default widget of window.
activate-focus	The ::activate-focus signal is a keybinding signal which gets emitted when the user activates the currently focused widget of window.
enable-debugging	The ::enable-debugging signal is a keybinding signal which gets emitted when the user enables or disables interactive debugging.
keys-changed	The ::keys-changed signal gets emitted when the set of accelerators or mnemonics that are associated with window changes.
set-focus

附录

Gtk.WindowType

class Gtk.WindowType
Bases: GObject.GEnum

设置窗口的类型，一般来说，窗口都是作为一个顶层窗口来呈现的。在某些特殊的情景（如在菜单中），才会作为一个气泡提示框等

TOPLEVEL = 0

顶层窗口

POPUP = 1

气泡提示框

代码下载地址：http://download.youkuaiyun.com/detail/a87b01c14/9594728