<!-- ##### SECTION Title ##### -->
mate-app-helper

<!-- ##### SECTION Short_Description ##### -->
Useful functions for populating menus and toolbars.

<!-- ##### SECTION Long_Description ##### -->
<para>
This module lets a developer easily create menus and toolbars for use in their
applications. Basically, a hierarchy of #MateUIInfo structures are defined and
then the appropriate functions from this module are called to create the menu
or tool bars.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### SECTION Image ##### -->


<!-- ##### ENUM MateUIInfoType ##### -->
<para>

</para>

@MATE_APP_UI_ENDOFINFO: 
@MATE_APP_UI_ITEM: 
@MATE_APP_UI_TOGGLEITEM: 
@MATE_APP_UI_RADIOITEMS: 
@MATE_APP_UI_SUBTREE: 
@MATE_APP_UI_SEPARATOR: 
@MATE_APP_UI_HELP: 
@MATE_APP_UI_BUILDER_DATA: 
@MATE_APP_UI_ITEM_CONFIGURABLE: 
@MATE_APP_UI_SUBTREE_STOCK: 
@MATE_APP_UI_INCLUDE: 

<!-- ##### ENUM MateUIInfoConfigurableTypes ##### -->
<para>

</para>

@MATE_APP_CONFIGURABLE_ITEM_NEW: 
@MATE_APP_CONFIGURABLE_ITEM_OPEN: 
@MATE_APP_CONFIGURABLE_ITEM_SAVE: 
@MATE_APP_CONFIGURABLE_ITEM_SAVE_AS: 
@MATE_APP_CONFIGURABLE_ITEM_REVERT: 
@MATE_APP_CONFIGURABLE_ITEM_PRINT: 
@MATE_APP_CONFIGURABLE_ITEM_PRINT_SETUP: 
@MATE_APP_CONFIGURABLE_ITEM_CLOSE: 
@MATE_APP_CONFIGURABLE_ITEM_QUIT: 
@MATE_APP_CONFIGURABLE_ITEM_CUT: 
@MATE_APP_CONFIGURABLE_ITEM_COPY: 
@MATE_APP_CONFIGURABLE_ITEM_PASTE: 
@MATE_APP_CONFIGURABLE_ITEM_CLEAR: 
@MATE_APP_CONFIGURABLE_ITEM_UNDO: 
@MATE_APP_CONFIGURABLE_ITEM_REDO: 
@MATE_APP_CONFIGURABLE_ITEM_FIND: 
@MATE_APP_CONFIGURABLE_ITEM_FIND_AGAIN: 
@MATE_APP_CONFIGURABLE_ITEM_REPLACE: 
@MATE_APP_CONFIGURABLE_ITEM_PROPERTIES: 
@MATE_APP_CONFIGURABLE_ITEM_PREFERENCES: 
@MATE_APP_CONFIGURABLE_ITEM_ABOUT: 
@MATE_APP_CONFIGURABLE_ITEM_SELECT_ALL: 
@MATE_APP_CONFIGURABLE_ITEM_NEW_WINDOW: 
@MATE_APP_CONFIGURABLE_ITEM_CLOSE_WINDOW: 
@MATE_APP_CONFIGURABLE_ITEM_NEW_GAME: 
@MATE_APP_CONFIGURABLE_ITEM_PAUSE_GAME: 
@MATE_APP_CONFIGURABLE_ITEM_RESTART_GAME: 
@MATE_APP_CONFIGURABLE_ITEM_UNDO_MOVE: 
@MATE_APP_CONFIGURABLE_ITEM_REDO_MOVE: 
@MATE_APP_CONFIGURABLE_ITEM_HINT: 
@MATE_APP_CONFIGURABLE_ITEM_SCORES: 
@MATE_APP_CONFIGURABLE_ITEM_END_GAME: 

<!-- ##### MACRO MATE_APP_CONFIGURABLE_ITEM_EXIT ##### -->
<para>
The <literal>EXIT</literal> and <literal>QUIT</literal> commands are synonyms
(they were used interchangably and inconsistently in MATE 1). This define
just makes this the case for configurable menu items as well. Note, however,
that in MATE 2, the use of <emphasis>exit</emphasis> is deprecated and all new
applications should use the word <emphasis>quit</emphasis> whenever termination
of an application is being discussed.
</para>



<!-- ##### ENUM MateUIPixmapType ##### -->
<para>

</para>

@MATE_APP_PIXMAP_NONE: 
@MATE_APP_PIXMAP_STOCK: 
@MATE_APP_PIXMAP_DATA: 
@MATE_APP_PIXMAP_FILENAME: 

<!-- ##### STRUCT MateUIInfo ##### -->
<para>
This is the structure that defines an item in a menu bar or toolbar.  The 
idea is to create an array of such structures with the information needed 
to create menus or toolbars. The most convenient way to create such a 
structure is to use the MATEUIINFO_* macros provided below.
</para>

<para>
The @moreinfo parameter contents depend on the @type. For 'item',
'toggleitem' and 'radioitem' types, this is a pointer to the function to
call when the item is activated. For 'subtrees', it is a pointer to another
array of #MateUIInfo structures. For 'radioitem lead' entry, it is a
pointer to an array of #MateUIInfo structures for the radio item group. For
a 'help' item, it specifies the help node to load (i.e. the application's
identifier) or %NULL for the main program's name. For 'builder data',
@moreinfo points to the #MateUIBuilderData structure for the subsequent
items.
</para>

<para>
The contents of the @pixmap_info depend upon the value of @pixmap_type. If
@pixmap_type is @MATE_APP_PIXMAP_STOCK, then @pixmap_info is a pointer to a
stock icon name. For #MATE_APP_PIXMAP_DATA pixmaps, @pixmap_info is a
pointer to inline xpm data. For #MATE_APP_PIXMAP_FILENAME pixmaps, it is a
pointer to the filename string.
</para>

<para>
When @type is #MATE_APP_UI_ITEM_CONFIGURABLE, @accelerator_key is
overloaded to be the name of the configurable pixmap (an element from the
#MateUIInfoConfigurableTypes enum). In this case @ac_mods should be 0.
</para>

<para>
The @widget field in the #MateUIInfo structure is filled in by the creation
function. It can be used to tweak the widgets once they have been created if
the application requires that level of fine-grained control.
</para>

@type: 
@label: 
@hint: 
@moreinfo: 
@user_data: 
@unused_data: 
@pixmap_type: 
@pixmap_info: 
@accelerator_key: 
@ac_mods: 
@widget: 

<!-- ##### STRUCT MateUIBuilderData ##### -->
<para>

</para>

@connect_func: 
@data: 
@is_interp: 
@relay_func: 
@destroy_func: 

<!-- ##### MACRO MATEUIINFO_KEY_UIDATA ##### -->
<para>
The <literal>widget</literal> element in a #MateUIInfo structure will have
this parameter set to the user data that was given in the #MateUIInfo instance.
</para>



<!-- ##### MACRO MATEUIINFO_KEY_UIBDATA ##### -->
<para>
The <literal>widget</literal> element in a #MateUIInfo structure will have
this parameter set to the user data that was given in the relevant
#MateUIBuilderData structure that was applicable at the time of construction
of the widget.
</para>



<!-- ##### USER_FUNCTION MateUISignalConnectFunc ##### -->
<para>
The template for functions that are called as a result of signals being emitted
from a menu or tool bar item. Fnuctions of this type are given as the first
element of a #MateUIBuilderData instance.
</para>

@uiinfo: The user data that was part of the #MateUIInfo instance.
@signal_name: The name of the emitted signal.
@uibdata: The user data that was part of the relevant #MateUIBuilderData
instance.


<!-- ##### FUNCTION mate_accelerators_sync ##### -->
<para>

</para>

@void: 


<!-- ##### FUNCTION mate_app_fill_menu ##### -->
<para>

</para>

@menu_shell: 
@uiinfo: 
@accel_group: 
@uline_accels: 
@pos: 


<!-- ##### FUNCTION mate_app_fill_menu_with_data ##### -->
<para>

</para>

@menu_shell: 
@uiinfo: 
@accel_group: 
@uline_accels: 
@pos: 
@user_data: 


<!-- ##### FUNCTION mate_app_fill_menu_custom ##### -->
<para>

</para>

@menu_shell: 
@uiinfo: 
@uibdata: 
@accel_group: 
@uline_accels: 
@pos: 


<!-- ##### FUNCTION mate_app_ui_configure_configurable ##### -->
<para>

</para>

@uiinfo: 


<!-- ##### FUNCTION mate_app_create_menus ##### -->
<para>

</para>

@app: 
@uiinfo: 


<!-- ##### FUNCTION mate_app_create_menus_interp ##### -->
<para>

</para>

@app: 
@uiinfo: 
@relay_func: 
@data: 
@destroy_func: 


<!-- ##### FUNCTION mate_app_create_menus_with_data ##### -->
<para>

</para>

@app: 
@uiinfo: 
@user_data: 


<!-- ##### FUNCTION mate_app_create_menus_custom ##### -->
<para>

</para>

@app: 
@uiinfo: 
@uibdata: 


<!-- ##### FUNCTION mate_app_fill_toolbar ##### -->
<para>

</para>

@toolbar: 
@uiinfo: 
@accel_group: 


<!-- ##### FUNCTION mate_app_fill_toolbar_with_data ##### -->
<para>

</para>

@toolbar: 
@uiinfo: 
@accel_group: 
@user_data: 


<!-- ##### FUNCTION mate_app_fill_toolbar_custom ##### -->
<para>

</para>

@toolbar: 
@uiinfo: 
@uibdata: 
@accel_group: 


<!-- ##### FUNCTION mate_app_create_toolbar ##### -->
<para>

</para>

@app: 
@uiinfo: 


<!-- ##### FUNCTION mate_app_create_toolbar_interp ##### -->
<para>

</para>

@app: 
@uiinfo: 
@relay_func: 
@data: 
@destroy_func: 


<!-- ##### FUNCTION mate_app_create_toolbar_with_data ##### -->
<para>

</para>

@app: 
@uiinfo: 
@user_data: 


<!-- ##### FUNCTION mate_app_create_toolbar_custom ##### -->
<para>

</para>

@app: 
@uiinfo: 
@uibdata: 


<!-- ##### FUNCTION mate_app_find_menu_pos ##### -->
<para>

</para>

@parent: 
@path: 
@pos: 
@Returns: 


<!-- ##### FUNCTION mate_app_remove_menus ##### -->
<para>

</para>

@app: 
@path: 
@items: 


<!-- ##### FUNCTION mate_app_remove_menu_range ##### -->
<para>

</para>

@app: 
@path: 
@start: 
@items: 


<!-- ##### FUNCTION mate_app_insert_menus_custom ##### -->
<para>

</para>

@app: 
@path: 
@uiinfo: 
@uibdata: 


<!-- ##### FUNCTION mate_app_insert_menus ##### -->
<para>

</para>

@app: 
@path: 
@menuinfo: 


<!-- ##### FUNCTION mate_app_insert_menus_with_data ##### -->
<para>

</para>

@app: 
@path: 
@menuinfo: 
@data: 


<!-- ##### FUNCTION mate_app_insert_menus_interp ##### -->
<para>

</para>

@app: 
@path: 
@menuinfo: 
@relay_func: 
@data: 
@destroy_func: 


<!-- ##### FUNCTION mate_app_install_appbar_menu_hints ##### -->
<para>

</para>

@appbar: 
@uiinfo: 


<!-- ##### FUNCTION mate_app_install_statusbar_menu_hints ##### -->
<para>

</para>

@bar: 
@uiinfo: 


<!-- ##### FUNCTION mate_app_install_menu_hints ##### -->
<para>

</para>

@app: 
@uiinfo: 


<!-- ##### FUNCTION mate_app_setup_toolbar ##### -->
<para>

</para>

@toolbar: 
@dock_item: 


<!-- ##### MACRO MATEUIINFO_END ##### -->
<para>
A macro that can be used to terminate an arrau of #MateUIInfo structures.
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_SEPARATOR ##### -->
<para>
A macro that defines a menu seperator bar. Can be put into an array of
#MateUIInfo structures.
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_ITEM ##### -->
<para>
A generic menu item with an inline xpm icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@xpm_data: Pixmap data.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_ITEM_STOCK ##### -->
<para>
A menu item with a stock icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@stock_id: The value of stock icon (from the mate-stock-item module of this
library).
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_ITEM_NONE ##### -->
<para>
A menu item with no icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_ITEM_DATA ##### -->
<para>
A menu item with an inline xpm icon and user data pointer for @callback.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@user_data: User data to pass to the callback function.
@xpm_data: Pixmap data.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_TOGGLEITEM ##### -->
<para>
A toggle item (check box) with inline xpm icon.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@xpm_data: Pixmap data.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_TOGGLEITEM_DATA ##### -->
<para>
A toggle item (chekc box) with inline xpm icon and user data pointer for
@callback.
</para>

@label: Menu label.
@tooltip: Tooltip for the label.
@callback: Function to call on selection of this item.
@user_data: User data to pass to the callback function.
@xpm_data: Pixmap data.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_HELP ##### -->
<para>
A menu containing all help topics based on @app_name.
</para>

@app_name: Application id string.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_SUBTREE ##### -->
<para>
A subtree (submenu).
</para>

@label: Submenu label.
@tree: A pointer to an array of #MateUIInfo structures.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_SUBTREE_HINT ##### -->
<para>
A subtree with a hint.
</para>

@label: Submenu label.
@hint: Hint for statusbar.
@tree: A pointer to an array of #MateUIInfo structures.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_SUBTREE_STOCK ##### -->
<para>
A subtree using a stock icon.
</para>

@label: 
@tree: A pointer to an array of #MateUIInfo structs.
@stock_id: The value of stock icon (from the mate-stock-item module of this
library).
@Returns: A #MateUIInfo structure.
<!-- # Unused Parameters # -->
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_INCLUDE ##### -->
<para>
A menu that should be included at the current point of the current menu (like
#MATEUIINFO_SUBTREE, but doesn't create a submenu).
</para>

@tree: A pointer to an array of #MateUIInfo structures.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_RADIOLIST ##### -->
<para>
A list of radio items.
</para>

@list: Pointer to a list of #MATEUIINFO_RADIOITEM elements.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_RADIOITEM ##### -->
<para>
A radio item with an inline xpm icon.
</para>

@label: Item label.
@tooltip: Tooltip for the item.
@callback: Function to call on selection of this item.
@xpm_data: Pixmap data.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_RADIOITEM_DATA ##### -->
<para>
A radio item with an inline xpm icon and user data for @callback.
</para>

@label: Item label.
@tooltip: Tooltip for the item.
@callback: Function to call on selection of this item.
@user_data: User data for the callback function.
@xpm_data: Pixmap data.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_NEW_ITEM ##### -->
<para>
A "New" entry (typically in the "File" menu).
</para>

@label: The label for the menu item (the thing being created).
@tip: Tooltip for the item.
@cb: Callback for when the menu item is selected.
@data: User data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_NEW_SUBTREE ##### -->
<para>
A "New" menu item that creates a subtree (for when you have more than one thing
that can be created anew).
</para>

@tree: Pointer to a list of #MateUIInfo menu structures.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_OPEN_ITEM ##### -->
<para>
An "Open..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_SAVE_ITEM ##### -->
<para>
A "Save" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_SAVE_AS_ITEM ##### -->
<para>
A "Save as..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_REVERT_ITEM ##### -->
<para>
A "Revert" (to last saved) menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_PRINT_ITEM ##### -->
<para>
A "Print" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_PRINT_SETUP_ITEM ##### -->
<para>
A "Print setup..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_CLOSE_ITEM ##### -->
<para>
A "Close" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_EXIT_ITEM ##### -->
<para>
An "Exit" menu item (deprecated).
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_QUIT_ITEM ##### -->
<para>
A "Quit" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_CUT_ITEM ##### -->
<para>
A "Cut" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_COPY_ITEM ##### -->
<para>
A "Copy" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_PASTE_ITEM ##### -->
<para>
A "Paste" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_SELECT_ALL_ITEM ##### -->
<para>
A "Select All" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_CLEAR_ITEM ##### -->
<para>
A "clear" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_UNDO_ITEM ##### -->
<para>
An "Undo" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_REDO_ITEM ##### -->
<para>
A "Redo" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_FIND_ITEM ##### -->
<para>
A "Find" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_FIND_AGAIN_ITEM ##### -->
<para>
A "Find Again" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_REPLACE_ITEM ##### -->
<para>
A "Replace" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_PROPERTIES_ITEM ##### -->
<para>
A "Properties..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_PREFERENCES_ITEM ##### -->
<para>
A "Preferences..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_NEW_WINDOW_ITEM ##### -->
<para>
A "New Window" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_CLOSE_WINDOW_ITEM ##### -->
<para>
A "Close Window" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_ABOUT_ITEM ##### -->
<para>
An "About..." menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_NEW_GAME_ITEM ##### -->
<para>
A "New Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_PAUSE_GAME_ITEM ##### -->
<para>
A "Pause Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_RESTART_GAME_ITEM ##### -->
<para>
A "Restart Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_UNDO_MOVE_ITEM ##### -->
<para>
An "Undo Move" menu item (for games, usually).
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_REDO_MOVE_ITEM ##### -->
<para>
A "Redo move" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_HINT_ITEM ##### -->
<para>
A "Hint" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_SCORES_ITEM ##### -->
<para>
A "Scores" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_END_GAME_ITEM ##### -->
<para>
An "End Game" menu item.
</para>

@cb: Callback for when the menu item is selected.
@data: Used data to pass to the callback.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_FILE_TREE ##### -->
<para>
A "File" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_EDIT_TREE ##### -->
<para>
An "Edit" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_VIEW_TREE ##### -->
<para>
A "View" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_SETTINGS_TREE ##### -->
<para>
A "Settings" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_FILES_TREE ##### -->
<para>
A "Files" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_WINDOWS_TREE ##### -->
<para>
A "Windows" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_HELP_TREE ##### -->
<para>
A "Help" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATEUIINFO_MENU_GAME_TREE ##### -->
<para>
A "Game" menu tree.
</para>

@tree: Pointer to a tree containing menu items for inside this menu.
@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_FILE_STRING ##### -->
<para>
A string which is the title of the "File" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_FILE_PATH ##### -->
<para>
A pre-defined path to the "File" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_EDIT_STRING ##### -->
<para>
A string which is the title of the "Edit" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_EDIT_PATH ##### -->
<para>
A pre-defined path to the "Edit" menu (when the menu is created using
#MATEUIINFO_MENU_EDIT_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_VIEW_STRING ##### -->
<para>
A string which is the title of the "View" menu (when the menu is created using
#MATEUIINFO_MENU_VIEW_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_VIEW_PATH ##### -->
<para>
A pre-defined path to the "View" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_SETTINGS_STRING ##### -->
<para>
A string which is the title of the "Settings" menu (when the menu is created
using #MATEUIINFO_MENU_SETTINGS_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_SETTINGS_PATH ##### -->
<para>
A pre-defined path to the "Settings" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_NEW_STRING ##### -->
<para>
A string which is the title of the "New" menu (when the menu is created using
#MATEUIINFO_MENU_NEW_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_NEW_PATH ##### -->
<para>
A pre-defined path to the "New" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_FILES_STRING ##### -->
<para>
A string which is the title of the "Files" menu (when the menu is created using
#MATEUIINFO_MENU_FILES_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_FILES_PATH ##### -->
<para>
A pre-defined path to the "Files" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_WINDOWS_STRING ##### -->
<para>
A string which is the title of the "Windows" menu (when the menu is created
using #MATEUIINFO_MENU_WINDOWS_TREE).
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### MACRO MATE_MENU_WINDOWS_PATH ##### -->
<para>
A pre-defined path to the "Windows" menu (when the menu is created using
#MATEUIINFO_MENU_FILE_TREE). Used in calls like mate_app_find_menu_pos().
</para>

@Returns: A #MateUIInfo structure.


<!-- ##### FUNCTION mate_app_helper_gettext ##### -->
<para>
Translate @string by calling gettext() and then, if that did not change the
string, dgettext() with the domain set to libmate's message domain.
</para>

@string: The string to translate.
@Returns: The localised value of the string.


<!-- ##### MACRO L_ ##### -->
<para>
Syntactic sugar for mate_app_helper_gettext().
</para>

@x: 


<!-- ##### MACRO D_ ##### -->
<para>
Syntactic sugar for calling dgettext() with the domain set to libmate's message
domain.
</para>

@x: 


