COleDataSource::OnRenderGlobalData

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

Valeur de retour

Différent de zéro en cas de succès ; sinon 0.

Paramètres

lpFormatEtc

Points à la structure FORMATETC spécifiant le format dans lequel les informations sont demandées.

phGlobal

Points à un handle de mémoire globale dans laquelle les données doit être renvoyé. Si on n'a pas encore été attribué, ce paramètre peut être NULL.

Remarques

Appelé par le framework pour récupérer des données dans le format spécifié lorsque le support de stockage spécifié est la mémoire globale. Le format spécifié est un préalablement placées dans l'objet COleDataSource à l'aide de la fonction membre DelayRenderData pour le rendu différé. L'implémentation par défaut de cette fonction retourne simplement la valeur FALSE.

Si phGlobal est NULL, alors un nouveau HGLOBAL devrait être alloués et revient en phGlobal. Par ailleurs, le HGLOBAL spécifiée par phGlobal doit être remplis avec les données. La quantité de données placées dans la HGLOBAL ne doit pas dépasser la taille actuelle du bloc de mémoire. Aussi, le bloc ne peut être réalloué à une plus grande taille.

C'est une avancée overridable. Substituer cette fonction de fournir vos données dans le format demandé et le milieu. Selon vos données, vous pouvez substituer une des autres versions de cette fonction au lieu de cela. Si vous souhaitez gérer les multiples supports de stockage, substituer se. Si vos données dans un fichier, ou de taille variable, substituez OnRenderFileData. Pour plus d'informations sur le rendu différé comme géré par MFC, consultez l'article objets de données et Sources de données : Manipulation dans le Guide du programmeur Visual C++.

Pour plus d'informations, consultez la structure FORMATETC et IDataObject::GetData dans la OLE 2 de référence du programmeur, Volume 1.

Aperçu COleDataSource |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;COleDataSource::DelayRenderData, COleDataSource::DelayRenderFileData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnSetData

Index