Compartilhar via


COleControl::GetAmbientProperty

Obtém o valor de uma propriedade de ambiente de controles.

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

Parâmetros

  • dwDispid
    A identificação de distribuição de propriedade de ambiente desejada.

  • vtProp
    Uma marca variante de tipo que especifica o tipo do valor a ser retornado em pvProp.

  • pvProp
    Um ponteiro para o endereço de variável que receberá o valor da propriedade ou o valor de retorno.O real tipo de esse ponteiro deve corresponder ao 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 de retorno

Diferente de zero se a propriedade de ambiente é suportado; se não 0.

Comentários

Se você usar GetAmbientProperty para recuperar as propriedades de ambiente de DisplayName e de ScaleUnits, defina vtProp a VT_BSTR e pvProp a CString*.Se você está recuperando a propriedade de ambiente de fonte, defina vtProp a VT_FONT e pvProp a LPFONTDISP*.

Observe que as funções já foram fornecidas para propriedades de ambiente comuns, como AmbientBackColor e AmbientFont.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe de COleControl

Gráfico de hierarquia

COleControl::AmbientForeColor

COleControl::AmbientScaleUnits

COleControl::AmbientShowGrabHandles