Share via


COleControl::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 kein Arbeitsspeicher 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 Steuerelementobjekt 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.

Ü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 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 finden Sie unter FORMATETC die Struktur in Windows SDK.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl-Klasse

Hierarchien-Diagramm

COleControl::OnRenderFileData

COleControl::OnRenderData