COleDataSource::OnRenderGlobalData

Article
03/04/2013

Appelé par l'infrastructure pour récupérer des données dans le format spécifié lorsque le support de stockage spécifié est mémoire globale.

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

Paramètres

lpFormatEtc
Pointe vers la structure de FORMATETC spécifiant le format dans lequel les informations sont demandées.
phGlobal
Indique un handle vers la mémoire globale dans laquelle les données doivent être retournées.S'il n'a pas encore été alloué, ce paramètre peut être NULL.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Le format spécifié est un précédemment défini dans l'objet d' COleDataSource à l'aide de la fonction membre de DelayRenderData pour le rendu différé.L'implémentation par défaut de cette fonction retourne simplement FALSE.

Si phGlobal est NULL, le nouvel HGLOBAL doit être allouée et retourné dans phGlobal.Sinon, HGLOBAL spécifié par phGlobal doit être rempli avec les données.La quantité de données placées dans HGLOBAL ne doit pas dépasser la taille actuelle du bloc de mémoire.En outre, le bloc ne peut pas être réallocation à une plus grande taille.

Il s'agit d'un substituable avancé.Remplacez cette fonction pour fournir les données au format et le support demandés.Selon les données, vous pouvez substituer l'une des autres versions de cette fonction à la place.Si vous souhaitez gérer plusieurs support de stockage, substituez OnRenderData.Si vos données sont dans un fichier, ou sont de taille variable, substituez OnRenderFileData.Pour plus d'informations sur le rendu différée comme géré par les MFC, consultez l'article objets de données et sources de données : manipulation.

Pour plus d'informations, consultez la structure et l' IDataObject::GetData de FORMATETC dans Kit de développement logiciel Windows*.*