Initializes a newly created object with data from a specified data object,
which can reside either in the same container or on the Clipboard.
| IDataObject *pDataObject,
||//Pointer to data object
| BOOL fCreation,
||//Specifies how object is created
| DWORD dwReserved
||//Not used in OLE 2
[in] Points to the data object from which the initialization data is to be
obtained. This parameter can be NULL, which indicates that the caller wants to
know if it is worthwhile trying to send data; that is,
whether the container is capable of initializing an object from data passed to
it. The data object to be passed can be based on either the current selection
within the container document or on data transferred to the container from an
[in] TRUE indicates the container is inserting a new object inside itself and
initializing that object with data from the current selection; FALSE indicates
a more general programmatic data transfer, most likely from a source other than
the current selection.
[in] Reserved for future use; must be zero.
is not NULL, the object successfully attempted to initialize itself from the
provided data; if pDataObject
is NULL, the object is able to attempt a successful initialization .
is not NULL, the object made no attempt to initialize itself; if pDataObject
is NULL, the object cannot attempt to initialize itself from the data
The object does not support InitFromData
The object is not running and therefore cannot perform the operation.
This method enables a container document to insert within itself a new object
whose content is based on a current data selection within the container. For
example, a spreadsheet document may want to create a graph object based on data
in a selected range of cells.
Using this method, a container can also replace the contents of an embedded
object with data transferred from another source. This provides a convenient way
of updating an embedded object.
Notes to Callers
Following initialization, the container should call IOleObject::GetMiscStatus
to check the value of the OLEMISC_INSERTNOTREPLACE
bit. If the bit is on, the new object inserts itself following the selected
data. If the bit is off, the new object replaces the selected data.
Notes to Implementors
A container specifies whether to base a new object on the current selection by
passing either TRUE or FALSE to the fCreation
is TRUE, the container is attempting to create a new
instance of an object, initializing it with the selected data specified by
the data object.
is FALSE, the caller is attempting to replace the object's current contents
with that pointed to by pDataObject
. The usual constraints that apply to an object during a paste operation
should be applied here. For example, if the type of the data provided is
unacceptable, the object should fail to initialize and return S_FALSE.
If the object returns S_FALSE, it cannot initialize itself from the provided
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages