Share via


COleControl::OnGetNaturalExtent

Aufgerufen vom Framework als Reaktion auf IViewObjectEx::GetNaturalExtent Anforderung eines Containers.

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

Parameter

  • dwAspect
    Gibt an, wie das Objekt dargestellt werden soll.Darstellungseinschliessungsinhalt, ein Symbol, eine Miniaturansicht oder ein gedrucktes Dokument.Gültige Werte werden aus der Enumeration DVASPECT oder DVASPECT2 entnommen.

  • lindex
    Der Teil des Objekts, das von Interesse ist.Derzeit nur -1 ist gültig.

  • ptd
    Zeigt auf DVTARGETDEVICE-Struktur das Definieren des Zielgeräts, für das die Größe des Objekts zurückgegeben werden soll.

  • hicTargetDev
    Gibt den Informationskontext für das Zielgerät an, das durch den ptd-Parameter angegeben, aus dem das Objekt Gerätenmetrik extrahieren kann und die Features des Geräts testet.Wenn ptdNULL ist, sollte das Objekt den Wert im hicTargetDev-Parameter ignorieren.

  • pExtentInfo
    Zeigt auf die DVEXTENTINFO-Struktur, die Größenanpassungsdaten angibt.Die DVEXTENTINFO-Struktur ist:

    typedef struct tagExtentInfo

    {

    UINT cb;

    DWORD dwExtentMode;

    SIZEL sizelProposed;

    } DVEXTENTINFO;

    Der Strukturmember dwExtentMode kann einen von zwei Werten verwenden:

    • DVEXTENT_CONTENT erkundigen sicher, wie groß das Steuerelement soll, Inhalt (Verschluss-zuGröße) genau zu passen sein

    • DVEXTENT_INTEGRAL, als die Größenanpassung, übergeben, vorgeschlagene Größe vor, um zu steuern

  • psizel
    Punkte in der Bearbeitendaten zurückgegeben von Steuerelement.Die zurückgegebenen Bearbeitendaten werden bis -1 für jede Dimension festgelegt, die nicht angepasst wurde.

Rückgabewert

Ungleich 0 (null), wenn es erfolgreich die Größe zurückgibt oder angepasst; 0 andernfalls.

Hinweise

Überschreiben Sie diese Funktion, um die Anzeigengröße des Objekts zurückzugeben, die dem vorgeschlagenen Größen- und Wertebereichsmodus in der Struktur DVEXTENTINFO am nächsten ist.Die Standardimplementierung gibt FALSE zurück und nimmt keine Anpassungen an die Größe vor.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl-Klasse

Hierarchien-Diagramm

COleControl::OnGetViewExtent