COleDataSource::OnRenderData

Artikel
02/26/2013

Aufgerufen durch das Framework, um Daten im angegebenen Format abzurufen.

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

Parameter

lpFormatEtc
Zeigt auf die FORMATETC-Struktur, die das Format angibt, in dem Informationen angefordert werden.
lpStgMedium
zeigt auf eine STGMEDIUM-Struktur, in der die Daten zurückgegeben werden sollen.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Das angegebene Format ist eines, das zuvor in das COleDataSource-Objekt mithilfe der DelayRenderData oder DelayRenderFileData-Memberfunktion für verzögertes Rendering platziert wird.Die Standardimplementierung dieser Funktion ruft OnRenderFileData oder OnRenderGlobalData, wenn das angegebene Speichermedium entweder eine Datei oder Arbeitsspeicher ist, bzw. auf.Wenn keine dieser Formate angegeben werden, gibt die Standardimplementierung 0 zurück und Auswirkungen.Weitere Informationen zum verzögerten Rendering, wie von MFC behandelt werden, finden Sie im Artikel Datenobjekte und Datenquellen: Manipulation.

Wenn >tymed lpStgMedium- ist TYMED_NULL, sollte STGMEDIUM zugeordnet und gefüllt werden, wie angegeben, durch lpFormatEtc->tymed.Wenn es nicht TYMED_NULL ist, sollte STGMEDIUM an der Stelle mit Daten gefüllt werden.

Dies ist ein erweitertes schreibbar gekennzeichnet.Überschreiben Sie diese Funktion, um die Daten im angeforderten Format und im Medium zu erzeugen.Je nach den Daten sollten Sie eine der anderen Versionen dieser Funktion stattdessen überschreiben.Wenn die Daten klein und an Größe behoben werden, überschreiben Sie OnRenderGlobalData.Wenn die Daten in einer Datei oder sind von der variablen Größe sind, überschreiben Sie OnRenderFileData.

Weitere Informationen finden Sie in STGMEDIUM und FORMATETC-Strukturen, den TYMED-Enumerationstyp und IDataObject::GetData in Windows SDK*.*