COleDataSource::OnRenderGlobalData

Artykuł
02/27/2013

Wywołana przez pobieranie danych w określonym formacie określony nośnik jest w globalnej pamięci RAM.

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

Parametry

lpFormatEtc
Wskazuje na FORMATETC Struktura określająca format, w którym jest wymagane informacje.
phGlobal
Punkty do dojścia do globalnej pamięci, w której dane są zwracane.Jeśli jeden nie jeszcze przydzielono, ten parametr może być NULL.

Wartość zwracana

Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.

Uwagi

Określony format jest jedną z wcześniej umieszczone w COleDataSource obiektu za pomocą DelayRenderData Członkowskich funkcji renderowania opóźnione.Domyślna implementacja ta funkcja zwraca po prostu FALSE.

Jeśli phGlobal jest NULL, następnie nowy HGLOBAL powinny być przydzielane i zwracane w phGlobal.W przeciwnym razie HGLOBAL określonej przez phGlobal powinna być wypełniona danych.Ilość danych jest umieszczone w HGLOBAL nie może przekraczać bieżący rozmiar bloku pamięci.Ponadto nie powtórnie przydzielone blok większy rozmiar.

Jest to zaawansowane NotOverridable.Zastąpienie tej funkcji do dostarczania danych w nośniku i żądanego formatu.W zależności od danych można zastąpić jedną z wersji tej funkcji w zamian.Jeśli chcesz obsługiwać wiele nośników, należy zastąpić OnRenderData.Jeśli dane w pliku, lub wielkości zmiennej, należy zastąpić OnRenderFileData.Aby uzyskać więcej informacji o opóźnionych renderowania jako obsługiwany przez MFC, zobacz obiekty danych i źródeł danych: manipulowanie.

Aby uzyskać więcej informacji, zobacz FORMATETC struktury i Metoda IDataObject::GetData w Windows SDK*.*