Category Creo Parametric user interface, Object ProMenubarmenu

Function ProMenubarmenuMenuAdd


DEPRECATED: Since Creo 1
SUPERSEDED BY: Depends on the context, consult the user documentation.
Description
Note: This API is deprecated. Use Customize UI dialog to create menus in Creo Parametric Ribbon UI.

Adds a new menu to the menu of Creo Parametric. This menu can be used later to add other menus, actions, and options.

This function affects the top-level Creo Parametric menu bar only.

This function is executed only once during a Creo Parametric session for each menu. Subsequent calls to this function for a previously loaded menu are ignored.

Replacement in Object TOOLKIT: pfcSession::UIAddMenu
Synopsis
#include <ProMenuBar.h>
ProErrorProMenubarmenuMenuAdd(
ProMenuItemName parent_menu
/* (In)
The name of the parent menu
*/
ProMenuItemName menu_name
/* (In)
The name of the menu (must be unique)
*/
ProMenuItemLabel menu_label
/* (In)
The label of the menu
*/
ProMenuItemName neighbor
/* (In)
The neighbor item in the parent menu.

Note: If you are adding the first menu to the menu of Creo Parametric, set the neighbor argument to NULL.

*/
ProBoolean add_after_neighbor
/* (In)
Defines whether to add the menu before or after the neighbor item; PRO_B_TRUE specifies after.
*/
ProFileName filename
/* (In)
The name of the message file containing the label
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully added the menu.
PRO_TK_MSG_NOT_FOUNDThe specified message was not found in the message file.
PRO_TK_E_FOUNDa menubar entity with this name already exists.
PRO_TK_GENERAL_ERRORThe function failed to add the menu.

Manual References:

  1. Technical Summary of Changes for Creo 11.0.0.0: Functions superseded from Creo 1.0 to Creo 11.0

Sample Code References:

  1. pt_af_examples ( PTAFExampleMain.c )
  2. pt_examples ( TestMenubar.c )