
A registry is a table that maps data types to executable code. These tables represent the preferences of the user for particular part editors, scripting systems, and translators.
Several different registry objects are supported, including parts, scripting systems, and translations. Part registries allow the document shell to map parts to part editors according to their part kind. Scripting system registries determine what scripting system is used to edit and interpret a script. Translation registries regulate which translation module is used for translating data of a given part kind into data of a different part kind.
Name spaces are used to uniquely identify part kinds, translation module kinds, scripting systems, and object extensions for code-binding purposes. A name space associates an ISO string (for example, a part kind) with a pointer to the code (for example, the part editor for the part kind).
The following lists the registration functions in alphabetic order.
This function deregisters a part handler with the OpenDoc registry and the OpenDoc SOM interface repository using the specified part handler name.
Signature
unsigned long ODDeregisterPartHandler (ISOString isoPartHandlerName) |
Parameters
Returns
This function deregisters a part handler with the OpenDoc registry and the OpenDoc SOM interface repository using the specified class name.
Signature
unsigned long ODDeregisterPartHandlerClass (ISOString className) |
Parameters
Returns
This function returns a list of category names that meet the given criteria. If the part handler name and part kind name are not specified, a list of all category names is returned.
Signature
unsigned long ODQueryCategoryList (ISOString isoPartHandlerName,
ISOString isoPartKind,
ISOString buffer,
ODULong bufferSize)
|
Parameters
Returns
This function returns a list of part handler names that meet the given criteria.
Signature
unsigned long ODQueryHandlerDisplayName (ISOString PartHandlerName,
ISOString buffer,
ODULong bufferSize)
|
Parameters
Returns
This function returns a list of part kind names that meet the given criteria.
Signature
unsigned long ODQueryKindDisplayName (ISOString PartKindName,
ISOString buffer,
ODULong bufferSize)
|
Parameters
Returns
This function returns information about the specified part handler.
Signature
unsigned long ODQueryPartHandlerInfo (ISOString isoPartHandlerName,
PartKindQueryInfo *partKindQueryInfo
|
Parameters
Returns
This function returns a list of part handler names that meet the given criteria. If the part kind and category are not specified, a list of all part handlers is returned.
Signature
unsigned long ODQueryPartHandlerList (ISOString isoPartKind,
ISOString buffer,
ODULong bufferSize)
|
Parameters
Returns
This function returns information about the specified part kind.
Signature
unsigned long ODQueryPartKindInfo (ISOString isoPartHandlerName,
ISOString isoPartKindName,
PartKindQueryInfo *partKindQueryInfo)
|
Parameters
Returns
This function returns a list of part kinds that meets the given criteria. If the part handler and category are not specified, a list of all part-registered part kinds is returned.
Signature
unsigned long ODQueryPartKindList (ISOString isoPartHandlerName,
ISOString *buffer,
ODULong bufferSize)
|
Parameters
When it is finished using this value, the client code is responsible for freeing it by calling SOMFree.
Returns
This function returns the preferred part-handler name for the specified part kind.
Signature
unsigned long ODQueryPreferredPartHandler (ISOString isoPartKindName,
ISOStr isoPartHandlerName
ODULong bufferSize)
|
Parameters
Returns
This function returns information about the preferred part-handler using the specified category.
Signature
unsigned long ODQueryPreferredPartHandlerForCategory (ISOString isoCategory,
ISOString isoPartHandlerName,
ODULong bufferSize)
|
Parameters
Returns
This function returns information about the preferred part-handler using the specified file extension.
Signature
unsigned long ODQueryPreferredPartHandlerForFileExt (ISOString isoFileExt,
ISOString isoPartHandlerName
ODULong bufferSize)
|
Parameters
Returns
This method returns the preferred part-handler name for the specified file type.
Signature
unsigned long ODQueryPreferredPartHandlerForFileType (ISOString partFileType,
ISOString isoPartHandlerName,
ODULong bufferSize)
|
Parameters
Returns
This function registers a part handler with the OpenDoc registry.
Signature
unsigned long ODRegisterPartHandlerClass (ISOString className) |
Parameters
Returns
Remarks This function creates an instance of the specified class using the specified DLL. The successful completion of this function depends on the information that is provided by the part-handler class. If the handler has already been registered, this function replaces the handler information.
This function sets the preferred part-handler name.
Signature
unsigned long ODSetPreferredPartHandler (ISOString isoPartKindName,
ISOString isoPartHandleName)
|
Parameters
Returns
This function sets the preferred part-handler to the specified name using the specified category.
Signature
unsigned long ODSetPreferredPartHandlerForCategory (ISOString isoCategory,
ISOString isoPartHandlerName)
|
Parameters
Returns
This function sets the preferred part-handler to the specified name using the specified file extension.
Signature
unsigned long ODSetPreferredPartHandlerForFileExt (ISOString isoFileExt,
ISOString isoPartHandlerName)
|
Parameters
Returns
This function sets the preferred part-handler to the specified name using the specified file type.
Signature
unsigned long ODSetPreferredPartHandlerForFileType (ISOString isoFileType,
ISOString isoPartHandlerName)
|
Parameters
Returns