Partager via


COleControl::OnRenderData

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 contrôle à l'aide de les fonctions membres de DelayRenderData ou de DelayRenderFileData pour le rendu différé.L'implémentation par défaut des appels à cette fonction OnRenderFileData ou OnRenderGlobalData, respectivement, si le support de stockage fourni est un fichier ou en mémoire.Si le format est demandé CF_METAFILEPICT ou le format persistant de jeu de propriétés, l'implémentation par défaut affiche les données appropriées et retourne une valeur différente de zéro.Sinon, elle retourne 0 et ne fait rien.

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

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 FORMATETC et de STGMEDIUM dans Kit de développement logiciel Windows.

Configuration requise

Header: afxctl.h

Voir aussi

Référence

Classe de COleControl

Graphique de la hiérarchie

COleControl::OnRenderFileData

COleControl::OnRenderGlobalData