Share via


COleControl::GetAmbientProperty

Ruft den Wert einer Ambient-Eigenschaft des Containers ab.

BOOL GetAmbientProperty(
   DISPID dispid,
   VARTYPE vtProp,
   void* pvProp 
);

Parameter

  • dwDispid
    Die Dispatch-ID der gewünschten Ambient-Eigenschaft.

  • vtProp
    Ein variantes Typtag, das den Typ des in angibt pvProp zurückgegeben werden, Werts.

  • pvProp
    Ein Zeiger auf die Adresse der Variablen, die den Eigenschaftswert oder den Rückgabewert empfängt.Der tatsächliche Typ des Zeigers muss dem Typ entsprechen, der von vtProp angegeben wird.

    vtProp

    Typ der pvProp

    VT_BOOL

    BOOL*

    VT_BSTR

    CString*

    VT_I2

    short*

    VT_I4

    long*

    VT_R4

    float*

    VT_R8

    double*

    VT_CY

    CY*

    VT_COLOR

    OLE_COLOR*

    VT_DISPATCH

    LPDISPATCH*

    VT_FONT

    LPFONTDISP*

Rückgabewert

Ungleich 0 (null), wenn die Ambient-Eigenschaft unterstützt wird; 0 andernfalls.

Hinweise

Wenn Sie GetAmbientProperty verwenden, um die Eigenschaften Ambienten DisplayName und ScaleUnits abzurufen, legen Sie vtProp zu VT_BSTR und pvProp zu CString* fest.Wenn Sie die Umgebungspinsel Schriftarteigenschaft abrufen, legen Sie vtProp zu VT_FONT und pvProp zu LPFONTDISP* fest.

Beachten Sie, dass Funktionen bereits für allgemeine Ambient-Eigenschaften, wie AmbientBackColor und AmbientFont bereitgestellt wurden.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl-Klasse

Hierarchien-Diagramm

COleControl::AmbientForeColor

COleControl::AmbientScaleUnits

COleControl::AmbientShowGrabHandles