(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: datatransfer ::

interface XSystemTransferable
Description
Interface to be implemented by objects used to provide system dependent data for a transfer operation. Those objects usually also implement XTransferable.

Methods' Summary
getData Called by a data consumer to obtain a system specific data object from the source. The data object is returned in an any. The contained type may differ on different platforms.  
Methods' Details
getData
any
getData( [in] sequence< byte >  aProcessId );

Description
Called by a data consumer to obtain a system specific data object from the source. The data object is returned in an any. The contained type may differ on different platforms.
Parameter aProcessId
The argument aProcessId is a process identifier of the caller's process. The interface implementation must ensure that the system data object can be used in that process. If the data object is not valid in the caller process then the returned any must be empty.
Returns
The system dependent data object.

Notes:Under Windows the returned any contains an unsigned long which represents a pointer to an IDataObject interface. The caller of getData has to release the data object (IDataObject::Release) if it is no longer needed. The caller must also make sure that the current thread has been initialized for OLE (use OleInitialize).

Top of Page

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.