COleDataSource::OnRenderData

Artykuł
02/27/2013

Wywołana przez ramy do pobierania danych w określonym formacie.

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

Parametry

lpFormatEtc
Wskazuje na FORMATETC Struktura określająca format, w którym jest wymagane informacje.
lpStgMedium
Wskazuje na STGMEDIUM strukturę, w której dane są zwracane.

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 lub DelayRenderFileData Członkowskich funkcji renderowania opóźnione.Domyślna implementacja ta funkcja będzie wywoływać OnRenderFileData lub OnRenderGlobalData , jeśli podany nośnik jest plik lub pamięci, odpowiednio.Jeśli żadna z tych formatów są dostarczane, domyślna implementacja będzie zwraca 0 i nic nie.Aby uzyskać więcej informacji o opóźnionych renderowania jako obsługiwany przez MFC, zobacz obiekty danych i źródeł danych: manipulowanie.

Jeśli lpStgMedium->tymed jest TYMED_NULL, STGMEDIUM powinny być przydzielane i wypełnione określony przez lpFormatEtc - > tymed.Jeśli nie jest TYMED_NULL, STGMEDIUM powinno być wypełnione miejsce z danymi.

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 mały i stały rozmiar dane zastępują OnRenderGlobalData.Jeśli dane w pliku, lub wielkości zmiennej, należy zastąpić OnRenderFileData.

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