指定 OLE 拖放 Data对象 的数据格式。只在设计时可用。
语法
oDataObject.SetFormat(nFormat | cFormat)
参数
nFormat | cFormat
指定 Data对象 的数据格式。下表列出了一些常用数据格式的值，以及每种格式的说明。使用 cFormat 也可以指定自定义格式。
| 数据格式* | nFormat | cFormat |
说明 |
| CF_TEXT | 1 | 文本格式。 |
| CF_OEMTEXT | 7 | 包含 OEM 字符集中字符的文本格式。 |
| CF_UNICODETEXT | 13 | Unicode 文本格式，只在Windows NT 下可用。 |
| CF_FILES or CF_HDROP | 15 | 一个标识一组文件的句柄，例如从 Windows 资源管理器拖来的一组文件。 |
| CFSTR_OLEVARIANTARRAY | "OLE Variant Array" | 一个 Visual FoxPro 数组。使用这个格式在一次拖放中可以传送多个值。例如，这个格式可以用于将列表框中的一些项拖动到另一个列表框中。 |
| CFSTR_OLEVARIANT | "OLE Variant" | 个 Visual FoxPro 变量。Visual FoxPro 中的所有数据类型都可以用变量代表。这个格式可以用于拖放 VisualFoxPro 数据，并且不丢失数据类型。 |
| CFSTR_VFPSOURCEOBJECT | "VFP Source对象" | 对一个 Visual FoxPro 对象的引用。 |
* 在 FOXPRO.H 中定义。
说明
可以在向 Data对象 中放置相应数据之前，向 Data对象中放置数据格式。如果在 Data对象中放置了数据格式，而不包含相应的数据，并且在 OLEDragDrop 事件中激活了SetData Method，则拖动源发生 OLESetData 事件。然后，该拖动源在 OLESetData 事件中使用 SetData Method将数据放在 Data对象 中。
当需要将大量数据放在 Data对象 时，当使用 Visual FoxPro 在本地不支持的数据格式时，或者当使用大量数据格式时，只在 Data对象 上放置数据格式，会提高 OLE 拖放的性能。
SetFormat Method只能在 OLEStartDrag 和 OLESetData 事件中执行。