MENU SET STATE statement

Purpose

Set the state of a specified menu item.

Syntax

MENU SET STATE hMenu, [BYCMD] pos&, state&

Remarks

Change the state of the menu item identified by pos&.

hMenu

Double-word or Long-integer variable containing the handle of the menu that contains the item to change.

pos&

Position within the menu, of the menu item to be changed. If the BYCMD option is specified, pos& refers to the unique menu item identifier of the item. Otherwise, pos& indicates the physical position of the menu item within the menu, where pos& = 1 for the first position, pos& = 2 for the second position, and so on.

state&

The new state of the menu item. This must be one or more of the following items, combined together with the OR operator to form a bitmask:

%MF_CHECKED

Place a checkmark next to the item.

%MF_DISABLED

Disable the menu item so that it cannot be selected.

%MF_ENABLED

Enable the menu item so that it can be selected.

%MF_GRAYED

Disable the menu item so that it cannot be selected and draw it in a "grayed" state to indicate this.

%MF_HILITE

Highlight the menu item.

%MF_UNCHECKED

Remove any checkmark next to the item.

See also

Dynamic Dialog Tools, Menus, MENU ADD POPUP, MENU ADD STRING, MENU ATTACH, MENU DELETE, MENU DRAW BAR, MENU GET STATE, MENU GET TEXT, MENU NEW BAR, MENU NEW POPUP, MENU SET TEXT