First

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODFocusOwnerIterator

First
The First method should begin the iteration and return a reference to the first frame in the iteration sequence.
ODFrame First ();
return value
A reference to the first frame in the iteration sequence, or kODNULL if the focus has no owners.

DISCUSSION
Your part calls this method before calling this focus-owner iterator's IsNotComplete method for the first time. This method may be called multiple times; each time resets the iteration.
Your override of this method should not increment the reference count of the returned frame object.

OVERRIDING
If you subclass ODFocusOwnerIterator, you must override this method. Your override must not call its inherited method; that is, your override must implement this method's functionality completely.

EXCEPTIONS

kODErrIteratorOutOfSync
The list of focus owners was modified while the iteration was in progress.