Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODStorageUnit

FocusWithCursor

The FocusWithCursor method focuses this storage unit on the focus context represented by the specified storage-unit cursor.

ODStorageUnit FocusWithCursor (
                           in ODStorageUnitCursor cursor);

cursor

A reference to the storage-unit cursor representing the desired focus context.

return value

A reference to this storage unit, focused on the specified focus context.

DISCUSSION

After this method executes successfully, this storage unit's offset is 0.

Before calling this method, you can call the ExistsWithCursor method to check whether the specified focus context exists.

EXCEPTIONS

kODErrIllegalNullSUCursorInput

The cursor parameter is null.

kODErrPropertyDoesNotExist

The cursor parameter specifies a property that does not exist.

kODErrSUValueDoesNotExist

The cursor parameter specifies a value type that does not exist for the specified property.

kODErrValueIndexOutOfRange

The cursor parameter specifies a value index that is out of the range for the specified property.

kODErrZeroRefCount

This storage unit has a reference count of 0.

SEE ALSO

The ODStorageUnit::ExistsWithCursor method (page 682).
The ODStorageUnit::Focus method (page 684).
"Focusing a Storage Unit" on page 274 in OpenDoc Programmer's Guide.