unstable since: 3.0

Declaration [src]

gimp_procedure_add_menu_path (
  GimpProcedure* procedure,
  const gchar* menu_path

Description [src]

Adds a menu path to the procedure. Only procedures which have a menu label can add a menu path.

Menu paths are untranslated paths to known menus and submenus with the syntax <Prefix>/Path/To/Submenu, for example <Image>/Layer/Transform. GIMP will localize these. Nevertheless you should localize unknown parts of the path. For instance, say you want to create procedure to create customized layers and add a Create submenu which you want to localize from your plug-in with gettext. You could call:

path = g_build_path ("/", "<Image>/Layer", _("Create"), NULL);
gimp_procedure_add_menu_path (procedure, path);
g_free (path);

See also: gimp_plug_in_add_menu_branch().

GIMP menus also have a concept of named section. For instance, say you are creating a plug-in which you want to show next to the “Export”, “Export As” plug-ins in the File menu. You would add it to the menu path “File/[Export]”. If you actually wanted to create a submenu called “[Export]” (with square brackets), double the brackets: “File/[[Export]]”

See also:

This function will place your procedure to the bottom of the selected path or section. Order is not assured relatively to other plug-ins.

Available since: 3.0



Type: const gchar*

The procedures additional menu path.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.