Método IVsUIShell2.GetVSSysColorEx (Int32, UInt32)

Artigo
10/14/2016

Publicado: agosto de 2016

Retorna as configurações RGB da cor de sistema especificado usado pelo ambiente.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (em Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Sintaxe

int GetVSSysColorEx(
    int dwSysColIndex,
    out uint pdwRGBval
)

int GetVSSysColorEx(
    int dwSysColIndex,
    [OutAttribute] unsigned int% pdwRGBval
)

abstract GetVSSysColorEx : 
        dwSysColIndex:int *
        pdwRGBval:uint32 byref -> int

Function GetVSSysColorEx (
    dwSysColIndex As Integer,
    <OutAttribute> ByRef pdwRGBval As UInteger
) As Integer

Parâmetros

dwSysColIndex
Type: System.Int32

[in] Um valor a partir de __VSSYSCOLOREX enumeração que especifica a cor do sistema para recuperar.

pdwRGBval
Type: System.UInt32

[out] Uma palavra de 32 bits que contém o valor RGB.

Valor Retornado

Type: System.Int32

Se o método for bem-sucedido, ele retornará S_OK. Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell80.idl:

HRESULT IVsUIShell2::GetVSSysColorEx(
   [in]  VSSYSCOLOREX  dwSysColIndex,
   [out] DWORD        *pdwRGBval
);

Este método substitui o GetVSSysColor método.

Esse método é semelhante a de Win32 API GetSysColor de função e retorna as configurações RGB para as diversas cores de sistema usadas pelo Visual Studio. Esses valores mudam de acordo com o esquema da área de trabalho do Windows implementado.

O valor RGB retornado pelo GetVSSysColorEx método é um valor de cor do Windows de 32 bits, no formato de um valor COLORREF.

Código C++ pode usar o valor RGB retornado diretamente usando as macros que oferecem suporte a COLORREFs, como GetRValue, GetGValue e GetBValue.

Retornado de código gerenciado que usa cores podem usar o T:System.Drawing.Color estrutura, que pode ser obtida com o valor de cor do Windows de 32 bits usando o M:System.Drawing.ColorTranslator.FromWin32(System.Int32) método.

Para uma discussão completa sobre práticas recomendadas para escolher os valores corretos de cor durante a criação de uma interface do usuário, consulte The Visual Studio UI Guidelines documento.

Confira Também

Interface IVsUIShell2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao início

Partilhar via