< Previous PageNext Page > Hide TOC

NSPanel Bindings

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

Contents:

Parameters Bindings
Title Bindings
Title With Pattern Bindings


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 Mac OS X v10.3 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

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 Mac OS X v10.3 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

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 Mac OS X v10.3 and later.
Binding is Read-Only.


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

visible

A Boolean value that specifies if the NSPanel is visible.

If visible evaluates to YES, the NSPanel is visible.

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


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

Title Bindings

representedFilename

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

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSString
Null PlaceholderNSNullPlaceholderBindingOptionNSString

title

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

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSString
Null PlaceholderNSNullPlaceholderBindingOptionNSString

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 Mac OS X v10.4 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Display PatternNSDisplayPatternBindingOptionNSString


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSString
Null PlaceholderNSNullPlaceholderBindingOptionNSString


< Previous PageNext Page > Hide TOC


© 2004, 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-10-31)


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.