|
IOleObject::InitFromData
Initializes a newly created object with data from a specified data object,
which can reside either in the same container or on the Clipboard.
HRESULT InitFromData(
IDataObject *pDataObject,
| //Pointer to data object
| BOOL fCreation,
| //Specifies how object is created
| DWORD dwReserved
| //Not used in OLE 2
| );
|
|
Parameters
pDataObject
[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
external source.
fCreation
[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.
dwReserved
[in] Reserved for future use; must be zero.
Return Values
S_OK
If pDataObject 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 .
S_FALSE
If pDataObject 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
provided.
E_NOTIMPL
The object does not support InitFromData.
OLE_E_NOTRUNNING
The object is not running and therefore cannot perform the operation.
Comments
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 parameter.
If 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.
If fCreation 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
data.
See Also
IOleObject::GetMiscStatus, IDataObject::SetData
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
