NSPanel Bindings

Related class
Availability
Available in OS X v10.3 and later.

Parameters Bindings

contentHeight

A float value that specifies the height of the NSPanel's content view. The height is expressed in the NSPanel's base coordinate system. Changing this value alters the size of the NSPanel.

Availability:
Available in OS X v10.3 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

contentWidth

A float value that specifies the width of the NSPanel's content view. The width is expressed in the NSPanel's base coordinate system. Changing this value alters the size of the NSPanel.

Availability:
Available in OS X v10.3 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

documentEdited

A Boolean value that specifies if the NSPanel's document has been edited and not saved.

The documentEdited binding should evaluate to YES if the NSPanel's content needs to be saved.

Availability:
Available in OS X v10.3 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

visible

A Boolean value that specifies if the NSPanel is visible.

If visible evaluates to YES, the NSPanel is visible.

Availability:
Available in OS X v10.3 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

Title Bindings

representedFilename

An NSString that contains the name of the file that the window represents.

Availability:
Available in OS X v10.3 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

title

An NSString value that is displayed in the title bar of the NSPanel.

Availability:
Available in OS X v10.3 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

Title With Pattern Bindings

displayPatternTitle1

A multiple-value binding that specifies a string value that replaces %{title1}@ in a display pattern string that is used to set the title of the NSPanel.

When displayPatternTitle1 is bound, a new binding, displayPatternTitle2, is exposed and can be bound. Binding to displayPatternTitle2 causes displayPatternTitle3 to be exposed, and so on.

The Display Pattern binding option is an NSString that is used as the pattern string. The appropriate displayPatternTitleX binding value is substituted for the %{titleX}@ pattern in the display string.

As an example, if displayPatternTitle1 evaluates to 22, displayPatternTitle2 evaluates to 5 and the Display Pattern string is "%{title2}@ of %{title1}@ rows are selected", the resulting NSPanel title will be "5 of 22 rows are selected".

If displayPatternTitle1 is bound, the title and representedFilename bindings are not available.

Availability:
Available in OS X v10.4 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Display PatternNSDisplayPatternBindingOption NSString


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString