COleDataSource::OnRenderData

Article
03/04/2013

Appelé par l'infrastructure pour récupérer des données dans le format spécifié.

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

Paramètres

lpFormatEtc
Pointe vers la structure de FORMATETC spécifiant le format dans lequel les informations sont demandées.
lpStgMedium
Pointe vers une structure de STGMEDIUM dans laquelle les données doivent être retournées.

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 ou de DelayRenderFileData pour le rendu différé.L'implémentation par défaut de cette fonction appelle OnRenderFileData ou OnRenderGlobalData si le support de stockage fourni est un fichier ou en mémoire, respectivement.Si aucune de ces formats ne sont fournis, alors l'implémentation par défaut retourne 0 et ne fera rien.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.

Si lpStgMedium- >tymed est TYMED_NULL, STGMEDIUM doit être allouée et rempli comme spécifié par lpformatetc->tymed.Si ce n'est pas TYMED_NULL, STGMEDIUM doit être rempli en place avec les données.

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 vos données sont petites et résolues en taille, substituez OnRenderGlobalData.Si vos données sont dans un fichier, ou sont de taille variable, substituez OnRenderFileData.

Pour plus d'informations, consultez les structures de STGMEDIUM et de FORMATETC , le type énumération de TYMED , et l' IDataObject::GetData dans Kit de développement logiciel Windows*.*