Freigeben über

SetData-Methode

  • Artikel

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

oDataObject.SetData(eData [, nFormat | cFormat])

Parameter

  • eData
    Gibt die Daten an, die in das Datenobjekt gestellt werden. Wenn Sie die optionalen Argumente nFormat und cFormat nicht angeben, stellt Visual FoxPro die Daten im Format CF_TEXT und CFSTR_OLEVARIANT in das Datenobjekt. Handelt es sich bei eData um ein Array, stellen Sie eData das @-Zeichen voran. Ein Array wird im Format CFSTR_OLEVARIANTARRAY in das Datenobjekt gestellt. Wenn es sich bei eData um einen Objektverweis oder um ein Feld vom Typ Objekt handelt oder wenn das Array einen Objektverweis enthält, wird ein Fehler generiert.

  • 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. Mit cFormat können Sie auch ein benutzerdefiniertes Format angeben. In diesem Fall muss es sich bei eData um Daten vom Typ Zeichen oder von einem mit CREATEBINARY( ) erstellten Binärdatentyp handeln.

    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 mit Drag & Drop 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

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

Siehe auch

ClearData-Methode | CREATEBINARY( ) | GetData-Methode | GetFormat-Methode | OLE-Drag & Drop - Überblick | OLEStartDrag-Ereignis | SetFormat-Methode

Betrifft: DataObject-Objekt