GtkMessageDialog


在程式中常出現一些簡單的對話或訊息方塊，有GTK中，它們都是GtkDialog的子類，在這邊先介紹一些GTK內建的對話方塊，常見類型之一是GtkMessageDialog，首先看個簡單的範例，改寫 自 訂 callback 函式 中的例子，按下按鈕後會出現訊息方塊：
  • message_dialog_demo.c
#include <gtk/gtk.h>

void button_clicked(GtkWidget *button, gpointer data) {
    GtkWidget *dialog = gtk_message_dialog_new(GTK_WINDOW(data), 
                             GTK_DIALOG_MODAL, GTK_MESSAGE_INFO, 
                             GTK_BUTTONS_OK, "良葛格學習筆記");
    gtk_window_set_title(GTK_WINDOW(dialog), "GtkMessageDialog");
    gtk_message_dialog_format_secondary_text(
         GTK_MESSAGE_DIALOG(dialog), "http://caterpillar.onlyfun.net");
    gtk_dialog_run(GTK_DIALOG(dialog));
    gtk_widget_destroy(dialog);
}

int main(int argc, char *argv[]) {
    GtkWidget *window;
    GtkWidget *button;

    gtk_init(&argc, &argv);
    window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title(GTK_WINDOW(window), "GtkMessageDialog");

    button = gtk_button_new_with_label("按我");
    gtk_container_add(GTK_CONTAINER(window), button);

    g_signal_connect(GTK_OBJECT(window), "destroy",
                     G_CALLBACK(gtk_main_quit), NULL);
    g_signal_connect(GTK_OBJECT(button), "clicked",
                     G_CALLBACK(button_clicked), window);

    gtk_widget_show(window);
    gtk_widget_show(button);

    gtk_main();

    return 0;
}

gtk_message_dialog_new()的宣告如下：
GtkWidget* gtk_message_dialog_new(GtkWindow *parent,
                                  GtkDialogFlags flags,
                                  GtkMessageType type,
                                  GtkButtonsType buttons,
                                  const gchar *message_format,
                                  ...);

設定parent，當訊息方塊是獨佔式（Modal）時，若不回應訊息方塊，則無法操作其父視窗，GtkDialogFlags則可以設定：
  • GTK_DIALOG_MODAL：設定為獨佔視窗。
  • GTK_DIALOG_DESTROY_WITH_PARENT：如果parent被銷毀，則一併銷毀對話方塊。
  • GTK_DIALOG_NO_SEPARATOR：在對話方塊中不出現分隔線，在 使用 GtkDialog 自訂對話方塊 中會再介紹。

GtkMessageType則指定這是哪個類型的訊息：
  • GTK_MESSAGE_INFO
  • GTK_MESSAGE_WARNING
  • GTK_MESSAGE_QUESTION
  • GTK_MESSAGE_ERROR
  • GTK_MESSAGE_OTHER
   
GtkButtonsType則可以設定幾個預設的按鈕類型：
  • GTK_BUTTONS_NONE
  • GTK_BUTTONS_OK
  • GTK_BUTTONS_CLOSE
  • GTK_BUTTONS_CANCEL
  • GTK_BUTTONS_YES_NO
  • GTK_BUTTONS_OK_CANCEL

message_format的設定，其實是類似printf()的字串格式，例如可以這麼設定：
GtkWidget *dialog = gtk_message_dialog_new(GTK_WINDOW(data),
                             GTK_DIALOG_MODAL, GTK_MESSAGE_INFO,
                             GTK_BUTTONS_OK, "%s 已刪除", filename);

要顯示對話方塊，方法之一是使用gtk_dialog_run()，這會將對話方塊以獨佔模式顯示，無論其GtkDialogFlags設定為何，因為這 會呼叫gtk_window_set_modal()函式，將對話方塊設定為獨佔模式，當回應對話方塊之後，您要使用 gtk_widget_destroy()銷毀對話方塊。

以下是一個執行時對話方塊的參考畫面：



gtk_dialog_run()結束後會傳回一個response id，為 GtkResponseType 的enum值，代表使用者按下的按鈕，如果對話方塊只是被關閉（按下X），則會傳回GTK_RESPONSE_NONE，您可以依這個傳回值來決定回應對話方塊後的下一步動作，例如GtkDialog的說明文件中有這麼一段範例程式：
 gint result = gtk_dialog_run (GTK_DIALOG (dialog));
 switch (result)
   {
     case GTK_RESPONSE_ACCEPT:
        do_application_specific_something ();
        break;
     default:
        do_nothing_since_dialog_was_cancelled ();
        break;
   }
 gtk_widget_destroy (dialog);