Instance Property

propertiesToUpdate

The available properties for the menu.

Declaration

var propertiesToUpdate: NSMenuProperties { get }

Discussion

This property contains a bitwise-C OR set of NSMenuProperties values that are applicable to the menu.

This property may be queried from specific callbacks to determine which menu properties are defined, and whether or not they are relevant to changes you need to make to the menu. This property is intended to allow for more efficient updating of the menu in certain circumstances.

For example, if the propertyItemImage property isn’t set, your delegate doesn’t need to spend time updating the images of the menu items, because the images aren’t needed (for example, during key-equivalent matching).

You have to update a menu property only if it has changed since you last set it, even if the corresponding bit is 1. For example, if the title of a menu item never changes, you have to set it only once.

Accessing this property is optional; it is always acceptable to fully update all properties of the menu.