SetData Method
Places data in the OLE drag-and-drop DataObject. Available at run time only.
oDataObject.SetData(eData [, nFormat | cFormat])
Parameters
eData
Specifies the data placed on the DataObject. If you omit the optional nFormat and cFormat arguments, Visual FoxPro places the data on the DataObject in the CF_TEXT and CFSTR_OLEVARIANT formats. If eData is an array, precede eData with an ampersand (@). An array is placed on the DataObject in the CFSTR_OLEVARIANTARRAY format. An error is generated if eData is an object reference or a general field, or the array contains an object reference.nFormat| cFormat
Specifies the format of the data placed on the DataObject. The following table lists the values for some common data formats with a description of each format. You can specify a user-defined format with cFormat. In this case, eData must be of character type or a binary type created with CREATEBINARY( ).
\* Defined in FOXPRO.H.Data format*
nFormat| cFormat
Description
CF_TEXT
1
Text format.
CF_OEMTEXT
7
Text format containing characters in the OEM character set.
CF_UNICODETEXT
13
Unicode text format.
Note
Available only for versions of Visual FoxPro running on Windows NT 4.0 or later.
CF_FILES or CF_HDROP
15
A handle that identifies a list of files, such as a set of files dragged from the Windows Explorer.
CFSTR_OLEVARIANTARRAY
"OLE Variant Array"
An array. Multiple values can be transferred in a single drag-and-drop operation with this format.
For example, this format can be used to drag a set of items in a list box to another list box.
CFSTR_OLEVARIANT
"OLE Variant"
A variant. All data types in Visual FoxPro are represented as variants. This format can be used to drag and drop Visual FoxPro data without losing the data type.
CFSTR_VFPSOURCEOBJECT
"VFP Source Object"
A reference to the Visual FoxPro drag source object.
Remarks
Applies To: DataObject Object
The SetData method can only be executed in the OLEStartDrag and OLESetData events.
See Also
Reference
Other Resources