The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15



Tips ‘n’ Tricks


:: com :: sun :: star :: embed ::

interface XEmbedObjectFactory
allows to create and initialize a new embedded object of specified type.

This interface provides user with full control over object creation.

Methods' Summary
createInstanceUserInit creates a new object and transport parameters for persistent initialization.  
Methods' Details
createInstanceUserInit( [in] sequence< byte >  aClassID,
[in] string  sClassName,
[in] XStorage  xStorage,
[in] string  sEntName,
[in] long  nEntryConnectionMode,
[in] sequence< ::com::sun::star::beans::PropertyValue >  aArgs,
[in] sequence< ::com::sun::star::beans::PropertyValue >  aObjectArgs )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::uno::Exception );

creates a new object and transport parameters for persistent initialization.

This method can be used to have a full control over persistence initialization of a object.

If the service implementation does not support XEmbedObjectCreator interface, it must accept the empty aClassID parameter in case of loading from existing entry.

Parameter aClassID
the class id of the new object
Parameter sClassName
the class name of the new object
Parameter xStorage
a parent storage the entry should be created/opened in
Parameter sEntName
a name for the entry
Parameter nEntryConnectionMode
a mode in which the object should be initialized from entry can take values from EntryInitModes constant set
Parameter aArgs
optional parameters for the embedded document persistence initialization, see also ::com::sun::star::document::MediaDescriptor
Parameter aObjectArgs
optional parameters for the object persistence initialization, see also EmbeddedObjectDescriptor @thrown ::com::sun::star::lang::IllegalArgumentException one of arguments is illegal
com::sun::star::io::IOException in case of io problems during opening\creation
com::sun::star::uno::Exception in case of other problems
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.