COleControl::GetAmbientProperty

获取容器的一个环境属性的值。

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

参数

  • dwDispid
    预期环境属性的调度ID。

  • vtProp
    指定在 pvProp将返回的值的类型的不同类型标记。

  • pvProp
    要接收属性值或返回值变量的地址的指针。此指针的实际类型必须与 vtProp指定的类型。

    vtProp

    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*

返回值

非零,则环境属性支持;否则为0。

备注

如果使用 GetAmbientProperty 检索环境DisplayName和ScaleUnits属性,请 vtProp 到 VT_BSTR 和 pvProp 到 CString*。如果检索环境字体属性,请 vtProp 到 VT_FONT 和 pvProp 到 LPFONTDISP*

请注意功能用于常规环境属性已提供了,例如 AmbientBackColorAmbientFont

要求

Header: afxctl.h

请参见

参考

COleControl选件类

层次结构图

COleControl::AmbientForeColor

COleControl::AmbientScaleUnits

COleControl::AmbientShowGrabHandles