I have (in Tiger 10.4.11) a nib with an NSTextField.
It's value is bound to "myInt" in MyObjectController (an
NSObjectController) - Controller Key: selection.
The content outlet of MyObjectController is connected to the File's
Owner, which is of class MyOwner.
MyOwer has an instance variabel called "myInt" which is, not very
surprising, an int.
Everything works fine.
But I don't understand bindings at all.
Trying to change this, to get some understanding, I looked at the
check boxes kindly offered by InterfaceBuilder.
The first one is: "Allows Editing Multiple Values Selection" - which
is checked.
So I typed "Multiple" into AppKiDo. Got several hits, but nothing
relating to "Allows Editing Multiple Values Selection".
So selected NSObjectController -> 1. General -> Inheritance and found
a link to the "Cocoa Bindings Programming Topics".
Clicked, and viewed it in Safari. See a list of Articles, but none of
these seems to be related to "Allows Editing Multiple Values Selection".
Tried "Find", but Sarari can only search the current page.
[Woebegone reminiscences of the DigitalLibrarian of NeXTStep - but
this does not help me today].
Ok, use todays tools: Xcode -> Help -> Documentation. Type "Allows
Editing Multiple Values Selection" got nothing in either Api or Full
Text Search. Well.
Next: Spotlight - and got about 200 html documents. Usually there are
millions of things all called index.html, but today I am lucky: there
is one called "BindingOptions.html", which is an Article in "Cocoa
Bindings Reference".
This mentions "NSAllowsEditingMultipleValuesSelectionBindingOption",
and Xcode Help points to the "NSKeyValueBindingCreation Protocol
Reference"
Spotlight shows me also "/Developer/ADC Reference Library/
releasenotes/Cocoa/AppKit.html", which mentions this flag with
arrays. Obviously not interesting, as I just have one TextField.
But all I have found so far is: the flag
NSAllowsEditingMultipleValuesSelectionBindingOption or the checkbox
"Allows Editing Multiple Values Selection" "determines if the binding
allows editing when the value represents a multiple selection."
Is this really an explanation, or just a rephrase?
And: how can the value (some simple integer in my case) "represent a
multiple selection"?
So what conclusions should I draw from this:
a) the answer is extremely obvious and I am just plain stupid.
b) the documentation is less than perfect.
To summarize:
1. AppKiDo is very helpful
2. Xcode -> Help -> Documentation is only marginally useful
3. Not being able to do a global search in a conceptional Guide is a
severe handicap.
The explanation I am craving for might not belong into a Reference
document.
But then a link to the appropriate section of the conceptional Guide
would be very helpful.
Kind regards
Gerriet.
P.S. Generally I am convinced that the documentation as far as it is
shown in AppKiDo is quite good. But everything else (e.g. Carbon
documentation) is mostly unusable.
_______________________________________________
Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com
This email sent to [EMAIL PROTECTED]
