COleControl::OnRenderData
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 Steuerelementobjekt mithilfe der DelayRenderData oder DelayRenderFileData-Memberfunktionen für verzögertes Rendering platziert wird.Die Standardimplementierung von diesem Funktionsaufrufe OnRenderFileData oder OnRenderGlobalData bzw. wenn das angegebene Speichermedium entweder eine Datei oder Arbeitsspeicher ist.Wenn das angeforderte Format CF_METAFILEPICT oder das dauerhafte Eigenschaftensatzformat befindet, rendert die Standardimplementierung der entsprechenden Daten und gibt Wert ungleich 0 (null) zurück.Andernfalls wird der Wert 0 zurückgegeben und Auswirkungen.
Wenn es ist TYMED_NULLlpStgMedium->tymed, sollte STGMEDIUM zugeordnet und gefüllt werden, wie angegeben, durch lpFormatEtc->tymed.Wenn nicht TYMED_NULL, STGMEDIUM an der Stelle mit Daten gefüllt wird.
Überschreiben Sie diese Funktion, um die Daten im angeforderten Format und im Medium bereitzustellen.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 FORMATETC und STGMEDIUM-Strukturen in Windows SDK.
Anforderungen
Header: afxctl.h