构造函数

GtkDialognew_with_buttons

已废弃：4.10

声明 [src]

GtkWidget*
gtk_dialog_new_with_buttons (
  const char* title,
  GtkWindow* parent,
  GtkDialogFlags flags,
  const char* first_button_text,
  ...
)

说明 [src]

创建一个新的带有指定标题和暂时性父级窗口的 GtkDialog。

可以使用 flags 参数来使对话框模态，与暂时性父级窗口一起销毁，或使用标题栏。

按钮文本/响应 ID 组应该成对列出，以 NULL 指针结尾。按钮文本可以是任意文本。响应 ID 可以是任何正数，或者是 GtkResponseType 枚举中的值之一。如果用户点击这些按钮之一，GtkDialog 将发出带有相应响应 ID 的 GtkDialog::response 信号。

如果 GtkDialog 收到一个删除事件，它将发出带有 ID 为 GTK_RESPONSE_DELETE_EVENT 的 ::response 信号。

但是，销毁对话框不会发出 ::response 信号；因此在使用 GTK_DIALOG_DESTROY_WITH_PARENT 标志时，要小心依赖 ::response。

以下是一个简单示例

GtkWindow *main_app_window; // Window the dialog should show up on
GtkWidget *dialog;
GtkDialogFlags flags = GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT;
dialog = gtk_dialog_new_with_buttons ("My dialog",
                                      main_app_window,
                                      flags,
                                      _("_OK"),
                                      GTK_RESPONSE_ACCEPT,
                                      _("_Cancel"),
                                      GTK_RESPONSE_REJECT,
                                      NULL);

自 4.10 起已废弃

请改用 GtkWindow。

此构造函数对语言绑定不可直接访问。

参数

title

类型： const char*

对话框的标题。

该参数可以是 NULL。

数据由函数的调用者所有。

该值是一个以 NUL 终止的 UTF-8 字符串。

parent

类型： GtkWindow

对话框的暂时性父级窗口。

该参数可以是 NULL。

数据由函数的调用者所有。

flags

类型： GtkDialogFlags

来自 GtkDialogFlags。

first_button_text

类型： const char*

放置在第一个按钮中的文本。

该参数可以是 NULL。

数据由函数的调用者所有。

该值是一个以 NUL 终止的 UTF-8 字符串。

...

类型：

第一个按钮的响应 ID，然后是附加按钮，以 NULL 结尾。

返回值

类型： GtkWidget

一个新的 GtkDialog。

数据由被调用的函数所有。