类

GtkDialog

已弃用：4.10

说明 [src]

class Gtk.Dialog : Gtk.Window
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
  /* No available fields */
}

对话框是一种以少量方式提示用户输入数据的便利方式。

An example GtkDialog

典型用途包括显示消息、提问或任何其他不需要用户投入大量精力的事情。

GtkDialog 的主区域称为“内容区域”，你可以用诸如 GtkLabel 或 GtkEntry 之类的窗口小组件来填充该区域，以便将你的信息、问题或任务展示给用户。

此外，对话框允许你添加“操作窗口小组件”。通常，操作窗口小组件是按钮。根据平台的不同，操作窗口小组件可能显示在窗口顶部的标题栏中，也可能显示在窗口的底部。要添加操作窗口小组件，请使用 gtk_dialog_new_with_buttons() 创建 GtkDialog，或使用 gtk_dialog_add_button()、gtk_dialog_add_buttons() 或 gtk_dialog_add_action_widget()。

GtkDialogs 使用一些启发式方法来决定是否在窗口装饰中添加一个关闭按钮。如果任何操作按钮使用响应 ID GTK_RESPONSE_CLOSE 或 GTK_RESPONSE_CANCEL，则省略关闭按钮。

点击作为操作窗口小组件添加的按钮时，将使用你指定的响应 ID 发送 GtkDialog::response 信号。 GTK 永远不会为正响应 ID 分配一个含义；这些都是用户完全自己定义的。但为了方便起见，你可以在 GtkResponseType 枚举中使用响应 ID（这些全部为小于零的值）。如果一个对话框收到一个删除事件，则 GtkDialog::response 信号将连同 GTK_RESPONSE_DELETE_EVENT 响应 ID 发送。

使用对 gtk_dialog_new() 或 gtk_dialog_new_with_buttons() 的调用来创建对话框。建议使用后者；它允许你设置对话框标题、一些方便的标志，并添加按钮。

可以通过在对话框上调用 gtk_window_set_modal() 来创建“模态”对话框（即，冻结用户输入的其余应用程序）。使用 gtk_dialog_new_with_buttons() 时，你还可以传递 GTK_DIALOG_MODAL 标志来使对话框成为模态对话框。

对于以下示例中的简单对话框，GtkMessageDialog 会省去一些工作。但是，如果你的对话框中的内容不仅仅是一个简单的消息的话，那么你需要手动创建对话框内容。

GtkDialog 的简单用法示例

// Function to open a dialog box with a message
void
quick_message (GtkWindow *parent, char *message)
{
 GtkWidget *dialog, *label, *content_area;
 GtkDialogFlags flags;

 // Create the widgets
 flags = GTK_DIALOG_DESTROY_WITH_PARENT;
 dialog = gtk_dialog_new_with_buttons ("Message",
                                       parent,
                                       flags,
                                       _("_OK"),
                                       GTK_RESPONSE_NONE,
                                       NULL);
 content_area = gtk_dialog_get_content_area (GTK_DIALOG (dialog));
 label = gtk_label_new (message);

 // Ensure that the dialog box is destroyed when the user responds

 g_signal_connect_swapped (dialog,
                           "response",
                           G_CALLBACK (gtk_window_destroy),
                           dialog);

 // Add the label, and show everything we’ve added

 gtk_box_append (GTK_BOX (content_area), label);
 gtk_widget_show (dialog);
}

GtkDialog as GtkBuildable

GtkDialog 的 GtkBuildable 接口实现将 content_area 作为一个内部子项公开，其名称为“content_area”。

GtkDialog 支持自定义 <action-widgets> 元素，其中可包含多个 <action-widget> 元素。该 “response” 属性指定一个数字响应，且该元素的内容是该小组件的 ID（应为该对话框 action_area 的一个子项）。要将一个响应标记为默认响应，请将该 <action-widget> 元素的 “default” 属性设置为 true。

GtkDialog 支持通过指定 <child> 元素的 “type” 属性为 “action”，添加操作小组件。小组件将被添加到对话框的动作区域或标题栏中，具体取决于 “use-header-bar” 属性。要使用 <action-widgets> 元素将响应 ID 与操作小组件关联起来。

GtkDialog 的一个 UI 定义片段示例

<object class="GtkDialog" id="dialog1">
  <child type="action">
    <object class="GtkButton" id="button_cancel"/>
  </child>
  <child type="action">
    <object class="GtkButton" id="button_ok">
    </object>
  </child>
  <action-widgets>
    <action-widget response="cancel">button_cancel</action-widget>
    <action-widget response="ok" default="true">button_ok</action-widget>
  </action-widgets>
</object>

辅助功能

GtkDialog 使用 GTK_ACCESSIBLE_ROLE_DIALOG 角色。

已弃用：4.10

改用 GtkWindow。

层次结构

父代

子代

实现

构造函数

gtk_dialog_new

新建一个 dialog 框。

已弃用：4.10

gtk_dialog_new_with_buttons

使用给定的标题和瞬态父项创建一个新的 GtkDialog。

已弃用：4.10

继承自 GtkWindow 的方法（55）

有关方法的完整列表，请参阅 GtkWindow 。

继承自 GtkWidget 的方法（162）

有关方法的完整列表，请参阅 GtkWidget 。

继承自 GObject 的方法（43）

有关方法的完整列表，请参阅 GObject 。

从 GtkBuildable (1) 继承的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

属性

Gtk.Dialog:use-header-bar

如果对话框使用 headerbar 来代替操作区域来操作按钮，则为 TRUE。

已弃用：4.10

从 GtkAccessible 继承的属性（1）

GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问角色。

信号

Gtk.Dialog::close

在用户使用键盘绑定关闭对话框时发出。

已弃用：4.10

Gtk.Dialog::response

在单击操作小部件时发出。

已弃用：4.10

从 GObject (1) 继承的信号

GObject::notify

当对象其中一个属性通过 g_object_set_property()、g_object_set() 等设置其值时，就会在该对象上发出 notify 信号。

类结构

struct GtkDialogClass {
  GtkWindowClass parent_class;
  void (* response) (
    GtkDialog* dialog,
    int response_id
  );
  void (* close) (
    GtkDialog* dialog
  );
  
}

无可用说明。

类成员

父类：GtkWindowClass: 父类。
响应：void (* 响应) (GtkDialog* 对话框，int 响应 ID): 当触发操作小组件时发出的信号。
关闭：void (* 关闭) (GtkDialog* 对话框): 当用户使用键盘绑定关闭对话框时发出的信号。

虚拟方法

Gtk.DialogClass.close

当用户使用键盘绑定关闭对话框时发出的信号。

Gtk.DialogClass.response

发出带有给定响应 ID 的 ::response 信号。

已弃用：4.10

说明 [src]

GtkDialog as GtkBuildable

辅助功能

层次结构

父代

子代

实现

构造函数

实例方法

继承自 GtkWindow 的方法（55）

继承自 GtkWidget 的方法（162）

继承自 GObject 的方法（43）

继承自 GtkAccessible 的方法（19）

从 GtkBuildable (1) 继承的方法

从 GtkNative (5) 继承的方法

从 GtkRoot (3) 继承的方法

属性

从 GtkWindow (25) 继承的属性

从 GtkWidget 继承的属性（34）

从 GtkAccessible 继承的属性（1）

信号

从 GtkWindow 继承的信号（5）

从 GtkWidget (13) 继承的信号