Compartir a través de

COleControl::GetAmbientProperty

  • Artículo

 

Obtiene el valor de una propiedad de ambiente del contenedor.

Sintaxis

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

Parámetros

  • dwDispid
    El identificador de envío de propiedad de ambiente deseada.

  • vtProp
    Una variante escribe la etiqueta que especifica el tipo de valor que se devolverá en pvProp.

  • pvProp
    Un puntero a la dirección de la variable que recibirá el valor de propiedad o valor devuelto.El tipo real de este puntero debe coincidir con el tipo especificado por vtProp.

    vtProp

    tipo de 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*

Valor devuelto

Distinto de cero si se admite la propiedad de ambiente; si no 0.

Comentarios

Si utiliza GetAmbientProperty para recuperar las propiedades de ambiente DisplayName y de ScaleUnits, establezca vtProp a VT_BSTR y pvProp a CString*.Si está recuperando la propiedad de fuente ambiente, establezca vtProp a VT_FONT y pvProp a LPFONTDISP*.

Observe que las funciones se han proporcionado ya para las propiedades de ambiente comunes, como AmbientBackColor y AmbientFont.

Requisitos

encabezado: afxctl.h

Vea también

COleControl Class
Gráfico de jerarquías
COleControl::AmbientForeColor
COleControl::AmbientScaleUnits
COleControl::AmbientShowGrabHandles