Interface IVsFontAndColorUtilities

Artigo
01/24/2017

Publicado: agosto de 2016

Fornece ferramentas para trabalhar com os dados de entrada e saídos usados pelos métodos das Visual Studio fontes e cores mecanismo.

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

Sintaxe

[GuidAttribute("A356A017-07EE-4D06-ACDE-FEFDBB49EB50")]
[InterfaceTypeAttribute(1)]
public interface IVsFontAndColorUtilities

[GuidAttribute("A356A017-07EE-4D06-ACDE-FEFDBB49EB50")]
[InterfaceTypeAttribute(1)]
public interface class IVsFontAndColorUtilities

[<GuidAttribute("A356A017-07EE-4D06-ACDE-FEFDBB49EB50")>]
[<InterfaceTypeAttribute(1)>]
type IVsFontAndColorUtilities = interface end

<GuidAttribute("A356A017-07EE-4D06-ACDE-FEFDBB49EB50")>
<InterfaceTypeAttribute(1)>
Public Interface IVsFontAndColorUtilities

Métodos

	Nome	Descrição
	CopyFontInfo(FontInfo[], FontInfo[])	Copia as informações de fonte de um FontInfo objeto em outro.
	CopyItemInfo(AllColorableItemInfo[], AllColorableItemInfo[])	Copia as informações contidas em uma AllColorableItemInfo objeto para outro AllColorableItemInfo objeto.
	EncodeAutomaticColor(UInt32)	Retorna o valor atual de Visual Studio cor automática de sessão como um RGB (COLORREF) valor.
	EncodeIndexedColor(COLORINDEX, UInt32)	Converte um membro do COLORINDEX enumeração em sua RGB (COLORREF) equivalente do valor de cor.
	EncodeInvalidColor(UInt32)	Retorna um RGB (COLORREF) cor inválido definido pelo valor de cor correspondente ao sistema.
	EncodeSysColor(Int32, UInt32)	Retorna um RGB (COLORREF) valor de cor correspondente a um componente de cor do sistema especificada.
	EncodeTrackedItem(Int32, Int32, UInt32)	Retorna um RGB (COLORREF) valor de cor correspondente para uma cor rastreadas no Visual Studio ambiente.
	EncodeVSColor(Int32, UInt32)	Retorna o COLORREF equivalente de um __VSSYSCOLOREX cores.
	FreeFontInfo(FontInfo[])	Liberar todos os dados em um independente FontInfo objeto.
	FreeItemInfo(AllColorableItemInfo[])	Liberar todos os dados em um independente AllColorableItemInfo objeto
	GetColorType(UInt32, Int32)	Obtenha o tipo de representação de cores em uma COLORREF.
	GetEncodedIndex(UInt32, COLORINDEX[])	Obter um membro válido do COLORINDEX enumeração correspondente a um fornecido COLORREF.
	GetEncodedSysColor(UInt32, Int32)	Obter um índice de serviço de cor do sistema correspondente a um fornecido COLORREF.
	GetEncodedVSColor(UInt32, Int32)	Obter um membro válido do __VSSYSCOLOREX enumeração correspondente a um fornecido COLORREF.
	GetRGBOfEncodedColor(UInt32, UInt32, Guid, UInt32)	Obtenha o valor RGB de um controle criado ou indexada COLORREF representação de uma cor.
	GetRGBOfIndex(COLORINDEX, UInt32)	Obter o valor RGB correspondente a um membro válido do COLORINDEX enumeração.
	GetRGBOfItem(AllColorableItemInfo[], Guid, UInt32, UInt32)	Obter o RGB (COLORREF) valores da cor de primeiro plano e plano de fundo de um fontes e cores categoria de uma instância do AllColorableItemInfo.
	GetTrackedItemIndex(UInt32, Int32, Int32)	Obter o índice de uma cor controlada, conforme representado por um COLORREF e um membro do __VSCOLORASPECT indicado se a cor foi usada no primeiro ou segundo plano.
	InitFontInfo(FontInfo[])	Inicializa uma FontInfo objeto para um estado padrão.
	InitItemInfo(AllColorableItemInfo[])	Inicializa uma AllColorableItemInfo objeto para um estado padrão.

Comentários

Os métodos do IVsFontAndColorUtilities interface permite fornecer um VSPackage fontes e cores ferramentas de suporte para trabalhar com FontInfo, __FONTCOLORFLAGS, __FCFONTFLAGS, e LOGFONTW, que são usados para especificar e modificar as informações de fonte e cor.

Se um VSPackage fornecendo fontes e cores alterar suas configurações padrão, ele deve chamar ClearCache ou ClearAllCaches. Isso forçará o recarregamento de fontes e cores provedores, verifique se a propagação de suas configurações e a moeda do futuro fontes e cores consultas.

Observação
Muitos dos métodos nessa interface trabalham com dados de cor armazenados como um COLORREF, consistente com o SDK do Windows 32 GetSysColor função. A COLORREF (RGB) tem o formato hexadecimal de 0x00bbggrr. Código gerenciado pode obter a funcionalidade equivalente à GetSysColor com SystemColors e converter entre COLORREF e System.Drawing.Color estrutura usando M:System.Drawing.ColorTranslator.FromWin32 e M:System.Drawing.ColorTranslator.ToWin32.

Muitos dos métodos nessa interface trabalham com dados de cor armazenados como um COLORREF, consistente com o SDK do Windows 32 GetSysColor função. A COLORREF (RGB) tem o formato hexadecimal de 0x00bbggrr. Código gerenciado pode obter a funcionalidade equivalente à GetSysColor com SystemColors e converter entre COLORREF e System.Drawing.Color estrutura usando M:System.Drawing.ColorTranslator.FromWin32 e M:System.Drawing.ColorTranslator.ToWin32.

Observações para os Autores de Chamada:

O IVsFontAndColorUtilities é obtida a SVsFontAndColorStorage implementação do serviço.

Os VSPackages desenvolvidos usando código gerenciado pode obter um IVsFontAndColorCacheManager interface chamando GetService com um argumento de SVsFontAndColorStorage e projeção para IVsFontAndColorUtilities:

IVsFontAndColorUtilities store=null;
store=GetService(typeof(SVsFontAndColorStorage)) as IVsFontAndColorUtilities;
if (store == null ){
    throw new ApplicationException("Unable to obtain IVsFontAndColorUtilities Interface");

}

Os programadores COM podem obter um IVsFontAndColorCacheManager interface chamando QueryService com

uma ID de serviço SID_SVsFontAndColorStorage e a ID de interface IID_IVsFontAndColorUtilities:

CComPtr<IVsFontAndColorUtilities> srpFCCacheMgr;
pSP->QueryService(SID_SVsFontAndColorStorage , IID_IVsFontAndColorUtilities , (void**)&srpFCCacheMgr);
VSASSERT(SUCCEEDED(hr), " IVsFontAndColorUtilities not provided");

Confira Também

Namespace Microsoft.VisualStudio.Shell.Interop
Usando fontes e cores

Retornar ao início

Compartilhar via