Interface IVsUserContext

Artigo
08/11/2016

Publicado: agosto de 2016

Gerencia os atributos e palavras-chave (contexto e subcontexto) no recipiente de contexto ou subcontexto.

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

Sintaxe

[GuidAttribute("761081DF-D45F-4683-9B9E-1B7241E56F5C")]
[InterfaceTypeAttribute(1)]
public interface IVsUserContext

[GuidAttribute("761081DF-D45F-4683-9B9E-1B7241E56F5C")]
[InterfaceTypeAttribute(1)]
public interface class IVsUserContext

[<GuidAttribute("761081DF-D45F-4683-9B9E-1B7241E56F5C")>]
[<InterfaceTypeAttribute(1)>]
type IVsUserContext = interface end

<GuidAttribute("761081DF-D45F-4683-9B9E-1B7241E56F5C")>
<InterfaceTypeAttribute(1)>
Public Interface IVsUserContext

Métodos

	Nome	Descrição
	AddAttribute(VSUSERCONTEXTATTRIBUTEUSAGE, String, String)	Adiciona um atributo, a palavra-chave de pesquisa, ou F1 palavra-chave para o recipiente de contexto ou subcontexto.
	AddSubcontext(IVsUserContext, Int32, UInt32)	Links de um recipiente subcontexto para um recipiente de contexto do pai.
	AdviseUpdate(IVsUserContextUpdate, UInt32)	Permite que os clientes receber notificação quando o recipiente de propriedades de contexto de usuário é alterado.
	CountAttributes(String, Int32, Int32)	Retorna o número de atributos ou palavras-chave presentes no recipiente de contexto ou subcontexto.
	CountSubcontexts(Int32)	Retorna o número de recipientes subcontexto associado com o recipiente de contexto.
	GetAttribute(Int32, String, Int32, String, String)	Retorna o atributo especificado ou a palavra-chave do recipiente de contexto ou subcontexto baseado na posição de índice ou nome.
	GetAttributePri(Int32, String, Int32, Int32, String, String)	Retorna um atributo especificado ou a palavra-chave do recipiente de contexto ou subcontexto baseado na posição de índice, nome ou prioridade.
	GetAttrUsage(Int32, Int32, VSUSERCONTEXTATTRIBUTEUSAGE[])	Retorna o tipo de contexto (atributo, a palavra-chave de pesquisa, ou F1 palavra-chave) que está presente em uma posição de índice especificado no recipiente de contexto ou subcontexto.
	GetPriority(Int32)	Determina a prioridade de um atributo ou a palavra-chave no recipiente de contexto ou subcontexto.
	GetSubcontext(Int32, IVsUserContext)	Retorna um recipiente de subcontexto especificado do pai de recipiente de contexto.
	IsDirty(Int32)	Determina se o contexto do usuário foi alterado no recipiente de contexto ou subcontexto.
	RemoveAllSubcontext()	Remove todos os recipientes subcontexto associados com o recipiente de contexto.
	RemoveAttribute(String, String)	Remove um recipiente de contexto ou subcontexto um atributo ou a palavra-chave.
	RemoveAttributeIncludeChildren(String, String)	Remove um atributo ou a palavra-chave do recipiente de contexto e de qualquer recipientes subcontexto associado.
	RemoveSubcontext(UInt32)	Remove o recipiente subcontexto especificado.
	SetDirty(Int32)	Sinaliza o recipiente de contexto ou subcontexto de atualização.
	UnadviseUpdate(UInt32)	Desabilita os clientes recebam notificações de atualizações para o contexto do usuário.
	Update()	Contexto de usuário de atualizações.

Comentários

Contexto e subcontexto são compostos de F1 palavras-chave, palavras-chave de pesquisa e atributos. Recipientes de contexto e subcontexto são objetos COM (IVsUserContext objetos) que são usados para agrupar palavras-chave e atributos associados a um provedor de contexto específico. Provedores de contexto são componentes de ambiente que estão envolvidos na seleção, como serviços de linguagem, editores e janelas de ferramenta. Subcontexto é uma seleção em um editor, ferramenta serviço de janela ou idioma. Exemplos de elementos subcontexto incluem um termo do idioma de chave em um serviço de linguagem ou um comando em uma janela de ferramenta.

O provedor de contexto associa o recipiente de contexto da seleção. O recipiente subcontexto é uma separado IVsUserContext objeto vinculado para o recipiente de contexto. Porque o contexto saco aponta para qualquer recipientes subcontexto que estão vinculados a ele, as palavras-chave e os atributos presentes em sacos de contexto e um subcontexto abrangem todo o contexto para o componente. A união dos recipientes de contexto e subcontexto para cada provedor de contexto dentro da seleção ativa descreve o contexto geral no ambiente em um momento específico.

Antes de usar os métodos de IVsUserContext para gerenciar o recipiente de contexto, você primeiro precisa configurar o componente ambiente como um provedor de contexto, criando um recipiente de contexto para ele. Para criar um novo recipiente de contexto, chame QueryService sobre o SVsMonitorUserContext para obter um ponteiro para o IVsMonitorUserContext interface. Uma vez que o ponteiro para esta interface, chame CreateEmptyContext para criar um novo recipiente de contexto e receber um ponteiro para IVsUserContext. Você pode chamar o AddAttribute método para adicionar atributos, palavras-chave de pesquisa, ou F1 palavras-chave para o recipiente de contexto. Usar esse mesmo procedimento para criar e preencher um recipiente subcontexto e, em seguida, chame AddSubcontext para vincular o recipiente subcontexto para o recipiente de contexto.

Observações para chamadores:

Chame essa interface para adicionar, remover, enumerar ou contexto e subcontexto do sinalizador.

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via