Blitz3D+ Command Reference

UncheckMenu menu

Parameters

menu - menu item to remove the check mark from

Description

Removes the check mark from a menu item.

Requires Extended language mode.

The other half of CheckMenu. Check marks are how menus show on/off options - Show grid, Wireframe, Snap - and the mark never toggles by itself: when the $1001 menu-action event arrives, read the state with MenuChecked and call CheckMenu or UncheckMenu to flip it, then apply the change to your tool.

For items on a window's menu bar, call UpdateWindowMenu afterwards so the native bar redraws without the mark. The update is idempotent - unchecking an item that is already unchecked changes nothing and causes no rebuild or flicker. Popup menu items need no update call, because their native menu is built fresh each time ShowPopupMenu opens it.

Menu items start out unchecked.

See it working in the menus and events sample and the world editor shell sample.

See also: CheckMenu, MenuChecked, CreateMenu, UpdateWindowMenu, DisableMenu.

Index