Partilhar via


COleControl::GetAmbientProperty

Obtém o valor de uma propriedade de ambiente do contêiner.

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

Parâmetros

  • dwDispid
    A ID de despacho da propriedade de ambiente desejada.

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

  • pvProp
    Um ponteiro para o endereço da variável que irá receber o valor da propriedade ou valor retornado.O tipo real desse ponteiro deve corresponder ao tipo especificado por vtProp.

    vtProp

    Tipo de pvProp

    VT_BOOL

    BOOL *

    VT_BSTR

    CString *

    VT_I2

    curto *

    VT_I4

    muito tempo *

    VT_R4

    float *

    VT_R8

    duas vezes *

    VT_CY

    CY *

    VT_COLOR

    OLE_COLOR *

    VT_DISPATCH

    LPDISPATCH *

    VT_FONT

    LPFONTDISP *

Valor de retorno

Diferente de zero se o suporte para a propriedade de ambiente; caso contrário, 0.

Comentários

Se você usar GetAmbientProperty para recuperar as propriedades DisplayName e ScaleUnits Ambiente, conjunto vtProp para VT_BSTR e pvProp para CString *.Se você estiver recuperando a propriedade fonte Ambiente, conjunto vtProp para VT_FONT and pvProp para LPFONTDISP *.

Observe que funções já foram fornecidas para propriedades do ambiente comuns, sistema autônomo AmbientBackColor and AmbientFont.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe COleControl

Gráfico de hierarquia

COleControl::AmbientForeColor

COleControl::AmbientScaleUnits

COleControl::AmbientShowGrabHandles

Outros recursos

COleControl membros