Admin Production ni-theme
Current Publication

SetMenuBarAttribute

LabWindows/CVI

SetMenuBarAttribute

int SetMenuBarAttribute (int menuBarHandle, int menuOrMenuItemID, int menuBarAttribute, ...);

Purpose

Sets the value of a specific menu bar attribute.

Parameters

Input
Name Type Description
menuBarHandle int Specifier for a particular menu bar that is currently in memory. You can obtain this handle from functions such as LoadMenuBar and NewMenuBar.

If the menu bar was automatically loaded through LoadPanel, use GetPanelMenuBar to get the menu bar handle.
menuOrMenuItemID int ID that you assigned to the menu or menu item in the User Interface Editor or that you obtain from functions such as NewMenu and NewSubMenu.

If the attribute corresponds to the entire menu bar, pass 0 as this parameter.
menuBarAttribute int The menu bar attribute value to set.

In the function panel, when you click the control or press <Enter>, <Spacebar>, or <Ctrl-down arrow>, a dialog box appears containing a hierarchical list of the available attributes. Attributes whose values cannot be obtained are dimmed. Help text is shown for each attribute. To select an attribute, double-click it or select it and then press <Enter>.

If the attribute shown in this ring control has named constants as valid values, you can open a list of them by moving to the Attribute Value control and pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants.
attributeValue ... The value to which to set the menu bar attribute.

If the attribute shown in this control has named constants as valid values, you can open a list of them by pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants.

Return Value

Name Type Description
status int Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later

Examples

Refer to the following examples that use the SetMenuBarAttribute function:

  • apps\uirview\uirview.cws

    Open example
  • userint\clipbord.cws

    Open example
  • userint\menus.cws

    Open example
  • userint\activex\WebBrowser.cws

    Open example
  • userint\custctrl\toolbar\tooldemo.cws

    Open example