GetData-Methode

Ruft Daten vom OLE-Drag & Drop DataObject-Objekt ab. Diese Eigenschaft ist nur zur Laufzeit verfügbar.

oDataObject.GetData(nFormat | cFormat [, @ArrayName])

Parameter

• nFormat cFormat
  Gibt das Format der Datei an, die abgerufen wird. In der folgenden Tabelle sind die Werte für jedes Dateiformat sowie die Beschreibung aller Formate aufgelistet. Das Datenobjekt unterstützt die folgenden Formate automatisch (es stehen noch weitere Formate zur Verfügung. Diese würden jedoch eine zusätzliche Programmierung erfordern). Weitere Informationen über zur Verfügung stehende Datenformate finden Sie in der Dokumentation für Visual C++® im Programmierernetzwerk von Microsoft.

  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 erkennt, wie z. B. ein Dateisatz, der aus Windows-Explorer entnommen ist.
  CF_LOCALE	16	Ein Handle zur lokalen Kennung für Text in der Zwischenablage.
  CFSTR_OLEVARIANTARRAY	"OLE Variant Array"	Ein Visual FoxPro-Array. Mit diesem Format können mehrere Werte in einer einzigen Drag & Drop-Operation transferiert werden. Dieses Format kann z. B. dazu verwendet werden, einen Satz von Einträgen in einem Listenfeld in ein anderes Listenfeld zu ziehen.
  CFSTR_OLEVARIANT	"OLE Variant"	Eine Visual FoxPro-Variante. Alle Datentypen in Visual FoxPro liegen als Varianten vor. Dieses Format kann dazu verwendet werden, Visual FoxPro-Daten zu transferieren, ohne den Datentyp zu verlieren.
  CFSTR_VFPSOURCEOBJECT	"VFP Source Object"	Ein Hinweis auf ein Visual FoxPro-Objekt.

  * Definiert in FOXPRO.H.

• @ArrayName
  Gibt den Namen des Arrays an, in dem die Daten gespeichert sind, wenn die Daten mehrere Werte beinhalten können. Die einzigen Datenformate, in denen Daten mehrere Werte beinhalten können, sind CF_FILES, CF_HDROP und CFSTR_OLEVARIANTARRAY. Sie können z. B. einen Dateiensatz aus Windows-Explorer in ein Visual FoxPro Listenfeld ziehen. Verwenden Sie die GetData-Methode im OLEDragDrop-Ereignis des Listenfeldes, um die Namen der Dateien in ein Array zu transferieren. Verwenden Sie anschließend die AddItem-Methode in einer FOR … ENDFOR-Schleife, um dem Listenfeld den Inhalt des Arrays hinzuzufügen.

  Das Array muss bereits vorhanden sein, bevor Sie dessen Namen in der GetData-Methode angeben können. Ist das Array vorhanden, jedoch nicht groß genug, um alle Daten zu enthalten, wird es von Visual FoxPro automatisch vergrößert. Ist das Array größer als notwendig, wird es abgeschnitten.

Hinweise

Der von der GetData-Methode zurückgegebene Wert wird durch das Datenformat bestimmt, das mit nFormat oder cFormat angegeben wurde. Es wird Falsch (.F.) zurückgegeben, wenn das DataObject keine Daten in dem von Ihnen mit nFormat oder cFormat angegebenen Format enthält. Es wird Wahr (.T.) zurückgegeben, wenn die Daten in einem Datenformat mit mehreren Werten abgespeichert sind, wie z. B. CF_FILES, CF_HDROP oder CFSTR_OLEVARIANTARRAY. Die Daten im DataObject werden zurückgegeben, wenn die Daten in einem Datenformat mit einem Wert abgespeichert sind, z. B. CF_TEXT, CFSTR_OLEVARIANT oder CFSTR_VFPSOURCEOBJECT.

Das OLESetData-Ereignis für eine Datenquelle wird ausgelöst, wenn das von Ihnen mit nFormat oder cFormat angegebene Datenformat vorhanden ist, jedoch keine Daten im DataObject für dieses Format enthalten sind. (Die SetFormat-Methode kann dazu verwendet werden, ein Datenformat anzugeben, bevor die jeweiligen Daten mit der SetData-Methode in das DataObject übernommen werden.)

Siehe auch

ClearData-Methode | GetFormat-Methode | OLE-Drag & Drop - Überblick | OLESetData-Ereignis | SetData-Methode | SetFormat-Methode

Betrifft: DataObject-Objekt