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( ).

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.

NoteNote

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.

* Defined in FOXPRO.H.

Expand imageRemarks

Expand imageSee Also


© , 1996-2020 • Updated: 11/10/20
Comment or report problem with topic