RegisterFocus

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

RegisterFocus
The RegisterFocus method adds the specified focus module for the specified focus.
void RegisterFocus (in ODTypeToken focus, 
                    in ODFocusModule focusModule);
focus
A tokenized string representing the focus type to be assigned to the specified focus module, expressed as a 32-bit value.
focusModule
A reference to a focus module that is to manage the specified focus, or kODNULL to create a standard exclusive focus module.

DISCUSSION
The focus parameter must be the tokenized form of one of the focus constants (kODClipboardFocus, kODKeyFocus, kODMenuFocus, kODModalFocus, kODMouseFocus, kODScrollingFocus, or kODSelectionFocus) or the tokenized form of a part-specific focus type. You can call the session object's Tokenize method to obtain a token corresponding to one of these constants.

EXCEPTIONS

kODErrFocusAlreadyRegistered
The specified focus is already registered.
kODErrOutOfMemory
There is not enough memory to allocate the default focus module.

SEE ALSO
The ODFocusType type (page 889).
The ODTypeToken type (page 877).
The ODSession::Tokenize method (page 622).
"Creating a Focus Module" on page 448 in OpenDoc Programmer's Guide.