COleControl::OnGetNaturalExtent

Appelé par l'infrastructure en réponse à la requête d' IViewObjectEx::GetNaturalExtent d'un conteneur.

virtual BOOL OnGetNaturalExtent(
   DWORD dwAspect,
   LONG lindex,
   DVTARGETDEVICE* ptd,
   HDC hicTargetDev,
   DVEXTENTINFO* pExtentInfo,
   LPSIZEL psizel 
);

Paramètres

  • dwAspect
    Spécifie la représentation de l'objet.Les représentations incluent le contenu, une icône, un aperçu, ou un document imprimé.Les valeurs valides sont prises de l'énumération DVASPECT ou DVASPECT2.

  • lindex
    La partie de l'objet qui est concerné.Actuel uniquement -1 est valide.

  • ptd
    Les points à structure DVTARGETDEVICE définir le périphérique cible pour lequel la taille de l'objet doit être retournée.

  • hicTargetDev
    Spécifie le contexte d'informations pour l'appareil cible indiqué par le paramètre d' ptd à partir duquel l'objet peut récupérer la métrique du périphérique et teste les fonctionnalités de l'appareil.Si ptd est NULL, l'objet doit ignorer la valeur du paramètre d' hicTargetDev .

  • pExtentInfo
    Pointe vers la structure de DVEXTENTINFO qui spécifie les données de dimensionnement.La structure de DVEXTENTINFO est :

    typedef struct tagExtentInfo

    {

    UINT cb;

    DWORD dwExtentMode;

    SIZEL sizelProposed;

    } DVEXTENTINFO;

    Le membre de structure dwExtentMode peut prendre l'une de deux valeurs :

    • DVEXTENT_CONTENT s'enquièrent le nombre important le contrôle doit être d'adapter précisément le contenu (la rupture-à- taille)

    • DVEXTENT_INTEGRAL en redimensionnant, exécutez a proposé pour contrôler la taille

  • psizel
    Points aux données de dimensionnement retournées par le contrôle.Les données de dimensionnement retournées sont définies à -1 pour une dimension qui n'a pas été définie.

Valeur de retour

Une valeur différente de zéro s'il avec succès retourne ou règle la taille ; sinon 0.

Notes

Remplacez cette fonction pour retourner la taille d'affichage de l'objet la plus proche du mode proposé de taille et d'étendue dans la structure de DVEXTENTINFO .L'implémentation par défaut retourne FALSE et ne fait aucun réglage de la taille.

Configuration requise

Header: afxctl.h

Voir aussi

Référence

Classe de COleControl

Graphique de la hiérarchie

COleControl::OnGetViewExtent