Freigeben über


COleDataSource::OnRenderGlobalData

Aufgerufen durch das Framework, um Daten im angegebenen Format abzurufen, wenn das angegebene Speichermedium globalen Arbeitsspeicher ist.

virtual BOOL OnRenderGlobalData( 
   LPFORMATETC lpFormatEtc, 
   HGLOBAL* phGlobal  
);

Parameter

  • lpFormatEtc
    Zeigt auf die FORMATETC-Struktur, die das Format angibt, in dem Informationen angefordert werden.

  • phGlobal
    Zeigt auf einem Handle im globalen Speicher, in dem die Daten zurückgegeben werden sollen. Wenn noch kein zugeordnet wurde, kann dieser Parameter NULL sein.

Rückgabewert

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

Hinweise

Das angegebene Format ist eines, das zuvor in das COleDataSource-Objekt mithilfe der DelayRenderData-Memberfunktion für verzögertes Rendering platziert wird. Die Standardimplementierung dieser Funktion gibt einfach FALSE zurück.

Wenn phGlobalNULL lautet, sollte neues HGLOBAL in phGlobal zugeordnet und zurückgegeben werden. Andernfalls sollte HGLOBAL, das von phGlobal angegeben wird, mit Daten gefüllt werden. Die Menge von Daten, die in HGLOBAL platziert werden, darf die aktuelle Größe des Speicherblocks nicht überschreiten. Auch der Block kann nicht für einen des neu zugeordnet 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 Sie mehrere Speichermedien behandeln möchten, überschreiben Sie OnRenderData. Wenn die Daten in einer Datei oder sind von der variablen Größe sind, überschreiben Sie OnRenderFileData. Weitere Informationen zum verzögerten Rendering, wie von MFC behandelt werden, finden Sie im Artikel Datenobjekte und Datenquellen: Manipulation.

Weitere Informationen finden Sie unter FORMATETC die Struktur und IDataObject::GetData in Windows SDK*.*

Anforderungen

Header: afxole.h

Siehe auch

Referenz

COleDataSource-Klasse

Hierarchiediagramm

COleDataSource::DelayRenderData

COleDataSource::DelayRenderFileData

COleDataSource::OnRenderData

COleDataSource::OnRenderFileData

COleDataSource::OnSetData