类
GtkMessageDialog
已弃用：4.10
说明 [src]
final class Gtk.MessageDialog : Gtk.Dialog
implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
/* No available fields */
}GtkMessageDialog 会提供一个带有消息文本的对话框。
它仅仅是一个便捷组件；无需花费太多精力，你就可以根据 GtkDialog 构建一个与 GtkMessageDialog 等效的组件，但 GtkMessageDialog 可以节省输入。
执行模态消息对话框的最简单方法是使用 GTK_DIALOG_MODAL 标志，这样会内部调用 gtk_window_set_modal()。在被隐藏或销毁之前，该对话框将阻止与父窗口的交互。你可以使用 GtkDialog::response 信号在用户关闭该对话框时获悉。
使用模态对话框的一个示例
GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT | GTK_DIALOG_MODAL;
dialog = gtk_message_dialog_new (parent_window,
flags,
GTK_MESSAGE_ERROR,
GTK_BUTTONS_CLOSE,
"Error reading “%s”: %s",
filename,
g_strerror (errno));
// Destroy the dialog when the user responds to it
// (e.g. clicks a button)
g_signal_connect (dialog, "response",
G_CALLBACK (gtk_window_destroy),
NULL);
你可以仅仅通过忽略 GTK_DIALOG_MODAL 标志，来执行一个非模态 GtkMessageDialog
GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
dialog = gtk_message_dialog_new (parent_window,
flags,
GTK_MESSAGE_ERROR,
GTK_BUTTONS_CLOSE,
"Error reading “%s”: %s",
filename,
g_strerror (errno));
// Destroy the dialog when the user responds to it
// (e.g. clicks a button)
g_signal_connect (dialog, "response",
G_CALLBACK (gtk_window_destroy),
NULL);
作为 GtkBuildable 的 GtkMessageDialog
GtkMessageDialog 实现的 GtkBuildable 接口，会 将消息区域显示为一个内部子项，名称为 “message_area”。
自版本 4.10 起弃用
改用 GtkAlertDialog 。
实例方法
从 GtkDialog 继承的方法（10 个）
gtk_dialog_add_action_widget
向 GtkDialog 的操作区域添加一个可激活的组件。
已弃用：4.10
gtk_dialog_add_button
添加文本为给定内容的按钮。
已弃用：4.10
gtk_dialog_add_buttons
添加多个按钮。
已弃用：4.10
gtk_dialog_get_content_area
返回 `dialog` 的内容区域。
已弃用：4.10
gtk_dialog_get_header_bar
返回 `dialog` 的标题栏。
已弃用：4.10
gtk_dialog_get_response_for_widget
获取对话框操作区域中某一窗口部件的响应 ID。
已弃用：4.10
gtk_dialog_get_widget_for_response
获取对话框操作区域中使用给定响应 ID 的窗口部件按钮。
已弃用：4.10
gtk_dialog_response
利用给定的响应 ID 发送 ::response 信号。
已弃用：4.10
gtk_dialog_set_default_response
根据响应 ID 为对话框设置默认窗口部件。
已弃用：4.10
gtk_dialog_set_response_sensitive
一种使对话框按钮敏感/不敏感的便捷方式。
已弃用：4.10
Methods inherited from GtkAccessible (19)
gtk_accessible_announce
请求用户的屏幕阅读器播报给定的信息。
since: 4.14
gtk_accessible_get_accessible_parent
检索可访问对象的父访问对象。
since: 4.10
gtk_accessible_get_accessible_role
检索可访问对象的访问角色。
gtk_accessible_get_at_context
检索给定可访问对象的实现。
since: 4.10
gtk_accessible_get_bounds
查询此可访问对象的坐标和尺寸。
since: 4.10
gtk_accessible_get_first_accessible_child
检索可访问对象的第一个可访问子项。
since: 4.10
gtk_accessible_get_next_accessible_sibling
检索可访问对象的下一个可访问兄弟项。
since: 4.10
gtk_accessible_get_platform_state
查询平台状态，例如焦点。
since: 4.10
gtk_accessible_reset_property
重置可访问属性为其默认值。
gtk_accessible_reset_relation
重置可访问关系为其默认值。
gtk_accessible_reset_state
重置可访问状态为其默认值。
gtk_accessible_set_accessible_parent
设置可访问对象的父项和兄弟项。
since: 4.10
gtk_accessible_update_next_accessible_sibling
更新下一个可访问兄弟项。
since: 4.10
gtk_accessible_update_property
更新可访问属性列表。
gtk_accessible_update_property_value
更新可访问属性数组。
gtk_accessible_update_relation
更新可访问关系列表。
gtk_accessible_update_relation_value
更新可访问关系数组。
gtk_accessible_update_state
更新可访问状态列表。
gtk_accessible_update_state_value
更新可访问状态数组。
Methods inherited from GtkBuildable (1)
Methods inherited from GtkNative (5)
gtk_native_get_renderer
返回用于此 GtkNative 的渲染器。
gtk_native_get_surface
返回此 GtkNative 的表面。
gtk_native_get_surface_transform
检索 self 的表面变换。
gtk_native_realize
实现 GtkNative。
gtk_native_unrealize
取消实现 GtkNative。
继承自 GtkRoot 的方法（3 个）
gtk_root_get_display
返回此 GtkRoot 所在的 display。
gtk_root_get_focus
检索 root 内当前获得焦点的窗口小部件。
gtk_root_set_focus
如果 focus 不是当前获得焦点的窗口小部件且可进行焦点设置，则将其设置为 root 的焦点窗口小部件。
属性
继承自 GtkDialog 的属性（1 个）
继承自 GtkWindow 的属性（25 个）
Gtk.Window:application
与窗口关联的 GtkApplication。
Gtk.Window:child
子窗口小部件。
Gtk.Window:decorated
窗口是否应具有边框（也称为“装饰”）。
Gtk.Window:default-height
窗口的默认高度。
Gtk.Window:default-widget
默认窗口小部件。
Gtk.Window:default-width
窗口的默认宽度。
Gtk.Window:deletable
窗口框架是否应具有关闭按钮。
Gtk.Window:destroy-with-parent
如果应在父目录被销毁时销毁此窗口。
Gtk.Window:display
将显示此窗口的 display。
Gtk.Window:focus-visible
‘焦点矩形’当前是否在此窗口中可见。
Gtk.Window:focus-widget
焦点窗口小部件。
Gtk.Window:fullscreened
窗口是否为全屏。
Gtk.Window:handle-menubar-accel
窗口框架是否应处理 F10 以激活菜单栏。
since: 4.2
Gtk.Window:hide-on-close
如果用户单击关闭按钮，是否应隐藏此窗口。
Gtk.Window:icon-name
指定用作窗口图标的主题图标的名称。
Gtk.Window:is-active
顶级窗口是否是当前活动窗口。
Gtk.Window:maximized
窗口是否已最大化。
Gtk.Window:mnemonics-visible
助记符当前是否在此窗口中可见。
Gtk.Window:modal
如果为真，则该窗口为模态窗口。
Gtk.Window:resizable
如果为真，则用户可以调整窗口大小。
Gtk.Window:startup-id
用于设置窗口启动通知标识符的只写属性。
Gtk.Window:suspended
窗口是否已暂停。
since: 4.12
Gtk.Window:title
窗口的标题。
Gtk.Window:titlebar
标题栏窗口小部件。
since: 4.6
Gtk.Window:transient-for
窗口的瞬态父窗口。
继承自 GtkWidget 的属性（34 个）
Gtk.Widget:can-focus
窗口小部件或其任何子窗口小部件是否可以接受输入焦点。
Gtk.Widget:can-target
窗口小部件是否可以接收指针事件。
Gtk.Widget:css-classes
应用于此窗口小部件的一系列 CSS 类。
Gtk.Widget:css-name
在 CSS 树中的此窗口小部件的名称。
Gtk.Widget:cursor
由 widget 使用的指针。
Gtk.Widget:focus-on-click
使用鼠标单击窗口小部件时该窗口小部件是否应获得焦点。
Gtk.Widget:focusable
该部件自身是否会接收输入焦点。
Gtk.Widget:halign
当部件获得额外空间时，如何分配水平空间。
Gtk.Widget:has-default
该部件是否是默认部件。
Gtk.Widget:has-focus
该部件是否具有输入焦点。
Gtk.Widget:has-tooltip
在 widget 上启用或禁用 GtkWidget::query-tooltip 信号的发出。
Gtk.Widget:height-request
重写对部件高度的请求。
Gtk.Widget:hexpand
是否水平扩展。
Gtk.Widget:hexpand-set
是否使用 hexpand 属性。
Gtk.Widget:layout-manager
要用来计算部件的首选大小并分配其子内容的 GtkLayoutManager 实例。
Gtk.Widget:margin-bottom
部件底部的边距。
Gtk.Widget:margin-end
部件末端的边距，水平方向。
Gtk.Widget:margin-start
部件起始处的边距，水平方向。
Gtk.Widget:margin-top
部件顶部的边距。
Gtk.Widget:name
部件的名称。
Gtk.Widget:opacity
该部件请求的不透明度。
Gtk.Widget:overflow
如何处理部件内容区域之外的内容。
Gtk.Widget:parent
此部件的父级部件。
Gtk.Widget:receives-default
当部件获得焦点时，是否会接收默认操作。
Gtk.Widget:root
包含此部件的小组树的 GtkRoot 小组。
Gtk.Widget:scale-factor
部件的缩放比例。
Gtk.Widget:sensitive
部件是否对输入做出响应。
Gtk.Widget:tooltip-markup
将工具提示的文本设置为给定的字符串，该字符串使用 Pango 标记进行标记。
Gtk.Widget:tooltip-text
将工具提示的文本设置为给定的字符串。
Gtk.Widget:valign
当部件获得额外空间时，如何分配垂直空间。
Gtk.Widget:vexpand
是否垂直扩展。
Gtk.Widget:vexpand-set
是否使用 vexpand 属性。
Gtk.Widget:visible
部件是否可见。
Gtk.Widget:width-request
重写部件的宽度请求。
从 GtkAccessible 继承的属性 (1)
信号
从 GtkDialog 继承的信号 (2)
从 GtkWindow 继承的信号 (5)
GtkWindow::activate-default
当用户激活默认部件时发出。
GtkWindow::activate-focus
当用户激活 window 当前聚焦的部件时发出。
GtkWindow::close-request
当用户单击窗口的关闭按钮时发出。
GtkWindow::enable-debugging
当用户启用或禁用交互式调试时发出。
GtkWindow::keys-changed
当与窗口关联的加速器或助记符集发生变化时发出。
已弃用：4.10
从 GtkWidget 继承的信号 (13)
GtkWidget::destroy
表示所有部件引用持有者都应释放其所持有的引用的信号。
GtkWidget::direction-changed
当部件的文本方向发生变化时发出。
GtkWidget::hide
当部件隐藏时发出。
GtkWidget::keynav-failed
如果键盘导航失败，则发出。
GtkWidget::map
当部件即将映射时发出。
GtkWidget::mnemonic-activate
当部件通过助记符激活时发出。
GtkWidget::move-focus
焦点被移动时发出。
GtkWidget::query-tooltip
小部件工具提示即将显示时发出。
GtkWidget::realize
widget 与 GdkSurface 关联时发出。
GtkWidget::show
widget 显示时发出。
GtkWidget::state-flags-changed
小部件状态发生变化时发出。
GtkWidget::unmap
widget 即将被取消映射时发出。
GtkWidget::unrealize
与 widget 关联的 GdkSurface 被销毁时发出。
从 GObject 中继承的信号 (1)
GObject::notify
当对象的某个属性通过 g_object_set_property()、g_object_set() 等方式设置其值时，会在对象上发出通知信号。