📄 migrating-gnomeuiinfo.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Migrating from GnomeUIInfo</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GTK+ Reference Manual"><link rel="up" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction"><link rel="prev" href="ui-manager.html" title="User Interface Manager Object"><link rel="next" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gtk.html" title="Part I. GTK+ Overview"><link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference"><link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects"><link rel="chapter" href="ch01.html" title="Object Hierarchy"><link rel="chapter" href="ch02.html" title="Widget Gallery"><link rel="chapter" href="WindowWidgets.html" title="Windows"><link rel="chapter" href="DisplayWidgets.html" title="Display Widgets"><link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles"><link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry"><link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor"><link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets"><link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar"><link rel="chapter" href="Actions.html" title="Action-based menus and toolbars"><link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)"><link rel="chapter" href="LayoutContainers.html" title="Layout Containers"><link rel="chapter" href="Ornaments.html" title="Ornaments"><link rel="chapter" href="ScrollingWidgets.html" title="Scrolling"><link rel="chapter" href="Printing.html" title="Printing"><link rel="chapter" href="MiscObjects.html" title="Miscellaneous"><link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes"><link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding"><link rel="chapter" href="SpecialObjects.html" title="Special-purpose features"><link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents"><link rel="chapter" href="Builder.html" title="Interface builder"><link rel="chapter" href="DeprecatedObjects.html" title="Deprecated"><link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+"><link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist"><link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser"><link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction"><link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry"><link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView"><link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog"><link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton"><link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant"><link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser"><link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton"><link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder"><link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip"><link rel="part" href="pt05.html" title="Part V. GTK+ Tools"><link rel="glossary" href="glossary.html" title="Glossary"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="ui-manager.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="gtk-migrating-GtkAction.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GTK+ Reference Manual</th><td><a accesskey="n" href="gtk-migrating-GtkComboBox.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="migrating-gnomeuiinfo"></a>Migrating from GnomeUIInfo</h2></div></div></div><p> Prior to GTK+ 2.4, some applications used the GnomeUIInfo mechanism from <code class="filename"><libgnomeui/gnome-app-helper.h></code> to define their menus and toolbars. With it, a program decleres an array of <span class="structname">GnomeUIInfo</span> structures, which contain information for menu or toolbar items such as their label, icon, and accelerator key. Then, one calls <ahref="/usr/share/gtk-doc/html/libgnomeui/libgnomeui-gnome-app-helper.html#gnome-app-fill-menu"><code class="function">gnome_app_fill_menu()</code></a> or <ahref="/usr/share/gtk-doc/html/libgnomeui/libgnomeui-gnome-app-helper.html#gnome-app-fill-toolbar"><code class="function">gnome_app_fill_toolbar()</code></a>, or one of the related functions, to create the appropriate widgets based on these structures. </p><p> A downside of this API is that the same structures are used to pass back pointers to the widgets that got created. This means that the structures cannot simply be kept around if the program requires multiple instances of the user interface (e.g. several windows); each new invocation of <ahref="/usr/share/gtk-doc/html/libgnomeui/libgnomeui-gnome-app-helper.html#gnome-app-fill-menu"><code class="function">gnome_app_fill_menu()</code></a> would overwrite the widget fields of the structures. </p><p> Another disadvantage is that there is no automatic way to synchronize the state of related controls. If there are toolbar toogle buttons for "Bold", "Italic", "Underline", and also corresponding menu items under "Format/Bold", etc., one has to synchronize their toggled states by hand whenever the user selects any one of them. </p><p> Finally, there is no way to do menu and toolbar merging for applications that require embedded components. </p><p> To convert an application that uses GnomeUIInfo into the new GtkAction mechanism, you need to do several things: </p><div class="orderedlist"><ol type="1"><li><p> Separate your existing GnomeUIInfo entries into normal actions, toggle actions, and radio actions, and then create a separate array of <a class="link" href="GtkActionGroup.html#GtkActionEntry"><span class="type">GtkActionEntry</span></a> structures for each group. This will allow you to create the necessary <a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> objects. Note that this does not describe the actual "shape" that your menus and toolbars will have; it simply defines the set of commands that will appear in them. </p></li><li><p> Create an XML description of your menus and toolbars for use with <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>. This defines the actual shape of the menus and toolbars. </p></li><li><p> Port the code that uses gnome-app and gnome-app-helper to <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> and <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>. </p></li><li><p> If your GnomeUIInfo entries use GNOME_APP_PIXMAP_DATA or GNOME_APP_PIXMAP_FILENAME for pixmaps, you have to create a <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>, add it to the list of default factories, then create a <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> for each of your own icons. Add the sets to the factory, and use the id in the <a class="link" href="GtkActionGroup.html#GtkActionEntry"><span class="type">GtkActionEntry</span></a> like a regular GTK+ stock id. </p></li></ol></div><div class="example"><a name="gnomeuiinfo-example"></a><p class="title"><b>Example 56. GnomeUIInfo Example</b></p><div class="example-contents"><p> The following code shows a declaration of a simple menu bar to be used with <ahref="/usr/share/gtk-doc/html/libgnomeui/libgnomeui-gnome-app-helper.html#gnome-app-fill-menu"><code class="function">gnome_app_fill_menu()</code></a> or similar. The menu hierarchy i looks like this: </p><div class="itemizedlist"><ul type="disc"><li><p><span class="guimenu">File</span></p><table class="simplelist" border="0" summary="Simple list"><tr><td><span class="guimenuitem">Open</span></td></tr><tr><td><span class="guimenuitem">—</span></td></tr><tr><td><span class="guimenuitem">Exit</span></td></tr></table></li><li><p><span class="guimenu">View</span></p><table class="simplelist" border="0" summary="Simple list"><tr><td><span class="guimenuitem">Zoom In</span></td></tr><tr><td><span class="guimenuitem">Zoom Out</span></td></tr><tr><td><span class="guimenuitem">—</span></td></tr><tr><td><span class="guimenuitem">[ ] Full Screen</span></td></tr><tr><td><span class="guimenuitem">—</span></td></tr><tr><td><span class="guimenuitem">( ) High Quality</span></td></tr><tr><td><span class="guimenuitem">( ) Normal Quality</span></td></tr><tr><td><span class="guimenuitem">( ) Low Quality</span></td></tr></table></li></ul></div><pre class="programlisting">static GnomeUIInfo file_menu_items[] = { { GNOME_APP_UI_ITEM, "_Open", "Open a file", open_callback, NULL, NULL, GNOME_APP_PIXMAP_STOCK, GTK_STOCK_OPEN, 'o', GDK_CONTROL_MASK, NULL }, { GNOME_APP_UI_SEPARATOR }, { GNOME_APP_UI_ITEM, "E_xit", "Exit the program", exit_callback, NULL, NULL, GNOME_APP_PIXMAP_STOCK, GTK_STOCK_QUIT, 'q', GDK_CONTROL_MASK, NULL}, { GNOME_APP_UI_ENDOFINFO }};static GnomeUIInfo view_radio_items[] = { { GNOME_APP_UI_ITEM, "_High Quality", "Display images in high quality, slow mode", high_quality_callback, NULL, NULL, GNOME_APP_PIXMAP_FILENAME, "high-quality.png", 0, 0, NULL }, { GNOME_APP_UI_ITEM, "_Normal Quality", "Display images in normal quality", normal_quality_callback, NULL, NULL, GNOME_APP_PIXMAP_FILENAME, "normal-quality.png", 0, 0, NULL }, { GNOME_APP_UI_ITEM, "_Low Quality", "Display images in low quality, fast mode", low_quality_callback, NULL, NULL, GNOME_APP_PIXMAP_FILENAME, "low-quality.png", 0, 0, NULL }, { GNOME_APP_UI_ENDOFINFO }};static GnomeUIInfo view_menu_items[] = { { GNOME_APP_UI_ITEM, "Zoom _In", "Zoom into the image", zoom_in_callback, NULL, NULL, GNOME_APP_PIXMAP_STOCK, GTK_STOCK_ZOOM_IN, GDK_PLUS, 0, NULL },⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -