GTK Gossip: GtkUIManager

最新推荐文章于 2025-09-10 03:14:15 发布

转载最新推荐文章于 2025-09-10 03:14:15 发布 · 671 阅读

文章标签：

#gtk #action #manager #callback #ui #null

software 同时被 2 个专栏收录

461 篇文章

订阅专栏

friendly

400 篇文章

订阅专栏

使用撰寫程式的方式來建構選單、工具列等使用者介面，過程有時過於繁瑣，您可以使用GtkUIManager從一個或多個使用者介面定義檔讀取介面定義，並自動建立相對應的Gtk元件，使用者介面定義檔是一個XML檔案。

舉個實際的例子來說，可以改寫一下 GtkMenuBar、GtkMenu 與 GtkMenuItem 中的範例，使用GtkUIManager與XML定義檔來作出相同的效果，若XML定義檔如下所示：

gtk_ui_manager.xml

<ui>

  <menubar name="MenuBar">

    <menu action="File">

      <menuitem action="Open"/>

      <menuitem action="Save"/>

      <separator/>

      <menuitem action="Close"/>

    </menu>

    <menu action="Edit">

      <menuitem action="Cut"/>

      <menuitem action="Copy"/>

      <menuitem action="Paste"/>

    </menu>

    <menu action="Help">

      <menuitem action="About"/>

    </menu>

  </menubar>

</ui>

"name"屬性可以讓您在建構程式的時候，依名稱來取得相對應的Gtk元件，而"action"將對應於GtkAction，您可以使用GtkActionEntry來建構GtkAction，GtkActionEntry的定義如下：

typedef struct {
const gchar     *name;
const gchar     *stock_id;
const gchar     *label;
const gchar     *accelerator;
const gchar     *tooltip;
GCallback callback;
} GtkActionEntry;

第一個name成員即對應定義檔中的"name"屬性，其它則為圖示、文字、快速鍵、提示與callback函式，一個設定範例如下：

static GtkActionEntry entries[] = {
{ "File", NULL, "_File" },
{ "Open", GTK_STOCK_OPEN, "Open",
     "<control>O", "Open File", G_CALLBACK(itemPressed)},
{ "Save", GTK_STOCK_SAVE, "Save",
     "<control>S", "Save File", G_CALLBACK(itemPressed)},
{ "Close", GTK_STOCK_QUIT, "Close",
     "<control>Q", "Close File", G_CALLBACK(gtk_main_quit)},
{ "Edit", NULL, "_Edit" },
{ "Cut", NULL, "Copy"},
{ "Copy", NULL, "Copy"},
{ "Paste", NULL, "Paste"},
{ "Help", NULL, "_Help" },
{ "About", NULL, "About" }
};

GtkAction被組織為GtkActionGrouop，定義了GtkActionEntry之後，您可以使用gtk_action_group_add_actions()函式將之加入GtkActionGroup之中：

gtk_action_group_add_actions(actionGroup, entries, 10, NULL);

接著建構GtkUIManager，並使用 gtk_ui_manager_insert_action_group()加入GtkActionGroup，然後使用 gtk_ui_manager_add_ui_from_file()讀取使用者介面定義檔：

GtkUIManager *ui = gtk_ui_manager_new();
gtk_ui_manager_insert_action_group(ui, actionGroup, 0);
gtk_ui_manager_add_ui_from_file(ui, "gtk_ui_manager.xml", NULL);

GtkUIManager將會自動建構相對應的Gtk元件，並依"action"設定建立相對應的GtkAction。

若要從GtkUIManager中取得元件，則可以使用gtk_ui_manager_get_widget()並依"name"屬性之設定來取得，例如取得"MenuBar"並加入GtkVBox中：

GtkWidget *vbox = gtk_vbox_new(FALSE, 5);
gtk_box_pack_start(GTK_BOX(vbox),
gtk_ui_manager_get_widget(ui, "/MenuBar"), FALSE, FALSE, 2);

下面的程式是個完整的範例：

gtk_ui_manager_demo.c

#include <gtk/gtk.h>



void itemPressed(GtkMenuItem *menuItem, gpointer data) {

    g_print("%s/n", gtk_action_get_name(GTK_ACTION(menuItem)));

}



static GtkActionEntry entries[] = {


  { "File", NULL, "_File" },


  { "Open", GTK_STOCK_OPEN, "Open", 


           "<control>O", "Open File", G_CALLBACK(itemPressed)},


  { "Save", GTK_STOCK_SAVE, "Save", 


           "<control>S", "Save File", G_CALLBACK(itemPressed)},


  { "Close", GTK_STOCK_QUIT, "Close", 


           "<control>Q", "Close File", G_CALLBACK(gtk_main_quit)},


  { "Edit", NULL, "_Edit" },


  { "Cut", NULL, "Copy"},


  { "Copy", NULL, "Copy"},


  { "Paste", NULL, "Paste"},


  { "Help", NULL, "_Help" },


  { "About", NULL, "About" }


};




int main(int argc, char *argv[]) {

    GtkWidget *window;

    GtkActionGroup *actionGroup;


    GtkUIManager *ui;


    GtkWidget *vbox;



    gtk_init(&argc, &argv);



    window = gtk_window_new(GTK_WINDOW_TOPLEVEL);

    gtk_window_set_title(GTK_WINDOW(window), "GtkUIManager");

    gtk_window_set_default_size(GTK_WINDOW(window), 300, 200);



    actionGroup = gtk_action_group_new("Actions");


    gtk_action_group_add_actions(actionGroup, entries, 10, NULL);


   


    ui = gtk_ui_manager_new();


    gtk_ui_manager_insert_action_group(ui, actionGroup, 0);


    gtk_ui_manager_add_ui_from_file(ui, "gtk_ui_manager.xml", NULL);




    vbox = gtk_vbox_new(FALSE, 5);

    gtk_box_pack_start(GTK_BOX(vbox), 


          gtk_ui_manager_get_widget(ui, "/MenuBar"), FALSE, FALSE, 2);




    gtk_container_add(GTK_CONTAINER(window), vbox);



    g_signal_connect(GTK_OBJECT(window), "destroy",

                     G_CALLBACK(gtk_main_quit), NULL);



    gtk_widget_show_all(window);



    gtk_main();



    return 0;

}