Copyright © 2025-2026 Candy ArtsChoice Status
The Choice_Status command modifies the choices of open menus: it enables or disables them, activates or deactivates them, shows or hides them, and changes their label and tooltip. Three filters, on menus, categories and choices, select the choices to modify. It is meant to run from a Block that a choice or a timer bridges to while the menu is open, for example to disable a choice once it has been picked. An invalid filter mode is reported and changes nothing; an invalid change is reported and ignored.
Keys
Every key also accepts a ¢ expression instead of a fixed value, unless its description says otherwise. See CandyRef Expressions.
Menu_Mode
Description:
Which open menus are modified. The value is case-insensitive.
Values:
• Last: The innermost open menu.
• Tags: The open menus with a tag listed in Menu_Tags.
• All: Every open menu.
• Empty: Not valid. A warning is reported, and nothing is changed.
Menu_Tags
Description:
The tags of the menus to modify when Menu_Mode is Tags. They are matched whole and case-insensitively.
Values:
• Tags: A comma-separated list.
Category_Mode
Description:
Which categories of those menus are modified. The value is case-insensitive.
Values:
• Last: The category of the menu's last picked choice.
• Tags: The categories with a tag listed in Category_Tags.
• All: Every category, except those with a tag listed in Category_Tags.
• Empty: Not valid. A warning is reported, and nothing is changed.
Category_Tags
Description:
Tags of the categories to include when Category_Mode is Tags, or to exclude when it is All. They are matched whole and case-insensitively.
Values:
• Tags: A comma-separated list.
Choice_Mode
Description:
Which choices of those categories are modified. The value is case-insensitive.
Values:
• Last: The menu's last picked choice.
• Tags: The choices with a tag listed in Choice_Tags.
• All: Every choice, except those with a tag listed in Choice_Tags.
• Empty: Not valid. A warning is reported, and nothing is changed.
Choice_Tags
Description:
Tags of the choices to include when Choice_Mode is Tags, or to exclude when it is All. They are matched whole and case-insensitively.
Values:
• Tags: A comma-separated list.
Enable
Description:
Whether the choices have a button.
Values:
• Enable: Create the button, after running the choice's Setup Block.
• Disable: Delete the button.
• Toggle: Enable disabled choices and disable enabled ones.
• - or empty: No change.
Activate
Description:
Whether the buttons can be picked.
Values:
• Activate: The buttons can be picked.
• Deactivate: The buttons are displayed but can't be picked.
• Toggle: Switch between the two states.
• - or empty: No change.
Show
Description:
Whether the buttons are visible.
Values:
• Show: Show them.
• Hide: Hide them.
• Toggle: Switch between the two states.
• - or empty: No change.
Label
Description:
The buttons' new text.
Values:
• Text
• Empty: No change.
Tooltip
Description:
The buttons' new tooltip.
Values:
• Text
• Empty: No change.