AddProperty

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

AddProperty
The AddProperty method adds a property with the specified name to this storage unit.
ODStorageUnit AddProperty (in ODPropertyName propertyName);
propertyName
The name of the property to be added.
return value
A reference to this storage unit.

DISCUSSION
If the storage unit does not already contain a property with the specified name, the new property is added and this storage unit is focused on the newly added property. Otherwise, this storage unit is focused on the existing property with the specified name.

EXCEPTIONS

kODErrCannotAddProperty
Cannot add the specified property to this storage unit.
kODErrIllegalNullPropertyInput
The specified property name is null.
kODErrZeroRefCount
This storage unit has a reference count of 0.

SEE ALSO
The ODPropertyName type (page 904).
The ODStorageUnit::GetProperty method (page 693).
The ODStorageUnit::Remove method (page 707).
Listing 2-41 on page 100 in OpenDoc Cookbook.
"Creating Properties and Values" on page 274 in OpenDoc Programmer's Guide.