Multiple-Value Boolean Bindings

Multiple-value Boolean bindings are used to determine if an object is editable, hidden, or enabled. The resulting value of the binding is derived by forming the logical AND or logical OR of the values of the exposed bindings. The logical operation used depends on the specific binding.

Multiple-Value Argument Bindings

The conventional Cocoa target/action mechanism provides the means for a control to invoke a message, passing itself as the sender. Multiple-value argument bindings extend that capability, allowing you to specify a target while passing an arbitrary number of arguments to the action. This mechanism provides significantly greater flexibility.

To set up target and argument bindings, you typically first bind the target binding—often to a controller’s selection or arrangedObjects key path—and specify the selector name to invoke. For each argument of the selector, you then bind an argument binding. When the control is clicked, the action is sent to the target with the specified parameters.

You can specify the selector name for any of the argument bindings, and the change will be propagated throughout.

Value With Pattern Bindings

The multiple-value pattern bindings allow you to assemble the final value of a binding from multiple string values. This pattern is used by the displayPatternValue and displayPatternTitle bindings.

A common use of pattern bindings is to indicate the size of the selection in an array controller in the form “5 of 34 selected”. To implement this, you’d bind displayPatternValue1 to the controller with the key path selection.@count, and then bind displayPatternValue2 to the controller with the key path contentArray.@count. You then specify the format string by setting the value pattern option to “%{value1}@ of %{value2}@ selected”.

In the pattern string, the value of displayPatternValue1 is represented by “%{value1}@”, the value of displayPatternValue2 by “%{value2}@”, and so on. Unlike the other multiple-value bindings, the first pattern binding is always 1.

You can specify the pattern string for any of the display pattern value bindings, and the change will be propagated throughout.

Predicate Binding

The multiple-value predicate binding allows you to create a search field pop-up menu that is pre populated with menu items that correspond to predicate filters. Each of the predicate bindings correspond to an entry in the search field pop-up menu. This multiple-value binding is used by the NSSearchField predicate binding.

The display name string is used as the menu item title. The predicate format is string that specifies the predicate for that menu item using the predicate format described in Predicate Programming Guide. Any occurrences of the string $value in the predicate format string are replaced with the contents of the search field.

For example, if you have a search field pop-up menu item named “Subject” that will filter message objects in an array controller based on the value of the subject key, you would construct a predicate as follows:

Additional search menu items can be added by binding to the newly exposed bindings, predicate2, predicate3, etc.