SetFormat-Methode

Stellt ein Datenformat in das OLE-Drag & Drop-Datenobjekt. Diese Methode ist nur zur Laufzeit verfügbar.

oDataObject.SetFormat(nFormat | cFormat)

Parameter

• nFormat cFormat
  Gibt das Format der Daten an, die in das Datenobjekt gestellt werden. In der folgenden Tabelle sind die Werte für einige gängige Datenformate zusammen mit einer Beschreibung jedes Formats aufgeführt. Sie können auch Ihr eigenes Format erstellen, indem Sie eine eindeutige Zeichenfolge für cFormat angeben.

  Datenformat	nFormat cFormat	Beschreibung
  CF_TEXT	1	Textformat
  CF_OEMTEXT	7	Textformat, das Zeichen aus dem OEM-Zeichensatz enthält.
  CF_UNICODETEXT	13	Unicode-Textformat, nur unter Windows NT 4.0 oder höher verfügbar.
  CF_FILES or CF_HDROP	15	Ein Handle, das eine Dateiliste bezeichnet, wie z. B. ein Dateisatz, der aus Windows-Explorer gezogen wird.
  CFSTR_OLEVARIANTARRAY	"OLE Variant Array"	Ein Array. Mit Hilfe dieses Formats können mehrere Werte in einem einzigen Drag & Drop-Vorgang übertragen werden. Beispielsweise kann dieses Format dazu verwendet werden, einen Satz von Einträgen in einem Listenfeld in ein anderes Listenfeld zu ziehen.
  CFSTR_OLEVARIANT	"OLE Variant"	Ein Wert vom Typ Variant. Alle Datentypen in Visual FoxPro werden als Werte vom Typ Variant dargestellt. Dieses Format kann dazu verwendet werden, Visual FoxPro-Daten zu übertragen, ohne den Datentyp zu verlieren.
  CFSTR_VFPSOURCEOBJECT	"VFP Source Object"	Ein Verweis auf das Quellobjekt des Ziehvorgangs in Visual FoxPro.

  * Definiert in FOXPRO.H.

Hinweise

Sie können ein Datenformat in das Datenobjekt stellen, bevor Sie die entsprechenden Daten in das Datenobjekt stellen. Wenn Sie ein Datenformat ohne entsprechende Daten in das Datenobjekt stellen und die GetData-Methode im OLEDragDrop-Ereignis aufrufen, wird für das Quellobjekt des Ziehvorgangs das OLESetData-Ereignis ausgeführt. Das Quellobjekt des Ziehvorgangs kann dann mit der SetData-Methode im OLESetData-Ereignis die Daten in das Datenobjekt stellen.

Wenn Sie eine große Datenmenge in das Datenobjekt stellen, von Visual FoxPro nicht systemeigen unterstützte Datenformate verwenden oder eine große Anzahl von Datenformaten verwenden, lässt sich die Leistung der OLE-Drag & Drop-Vorgänge verbessern, indem Sie nur die Datenformate in das Datenobjekt stellen.

Die SetFormat-Methode kann nur in den Ereignissen OLEStartDrag und OLESetData ausgeführt werden.

Siehe auch

ClearData-Methode | GetData-Methode | GetFormat-Methode | OLE-Drag & Drop - Überblick | OLEDragDrop-Ereignis | OLESetData-Ereignis | OLEStartDrag-Ereignis | SetData-Methode

Betrifft: DataObject-Objekt