Interface IVsUIHierarchy

Artigo
06/13/2016

Redireciona comandos que você pode chamar para a janela hierarquia apropriada em vez do manipulador de comandos padrão.

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

Sintaxe

[InterfaceTypeAttribute(1)]
[GuidAttribute("E82609EA-5169-47F4-91D0-6957272CBE9F")]
public interface IVsUIHierarchy : IVsHierarchy

[InterfaceTypeAttribute(1)]
[GuidAttribute("E82609EA-5169-47F4-91D0-6957272CBE9F")]
public interface class IVsUIHierarchy : IVsHierarchy

[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("E82609EA-5169-47F4-91D0-6957272CBE9F")>]
type IVsUIHierarchy = 
    interface
        interface IVsHierarchy
    end

<InterfaceTypeAttribute(1)>
<GuidAttribute("E82609EA-5169-47F4-91D0-6957272CBE9F")>
Public Interface IVsUIHierarchy
    Inherits IVsHierarchy

Métodos

	Nome	Descrição
	AdviseHierarchyEvents(IVsHierarchyEvents, UInt32)	Permite que os clientes ligar as notificações de eventos sem fazer com que a hierarquia implementar IConnectionPointContainer.
	Close()	Fecha e limpa uma hierarquia depois que o ambiente determina que ele não é mais usado.
	ExecCommand(UInt32, Guid, UInt32, UInt32, IntPtr, IntPtr)	Executa um comando em um item específico dentro de uma janela de hierarquia de interface do usuário ou na própria hierarquia.
	GetCanonicalName(UInt32, String)	Usado para persistência de espaço de trabalho, por exemplo, para lembrar a posição das janelas.
	GetGuidProperty(UInt32, Int32, Guid)	Identifica o "tipo" de um nó específico.
	GetNestedHierarchy(UInt32, Guid, IntPtr, UInt32)	Torna possível para um nó de uma determinada hierarquia um atalho para o meio de outra hierarquia.
	GetProperty(UInt32, Int32, Object)	Obtém as propriedades de um nó específico ou da hierarquia.
	GetSite(IServiceProvider)	Obtém o provedor de serviços a partir do qual os serviços de acesso.
	ParseCanonicalName(String, UInt32)	Retorna o identificador do item de hierarquia, dado seu nome canônico.
	QueryClose(Int32)	Determina se a hierarquia fornecida pode ser fechada.
	QueryStatusCommand(UInt32, Guid, UInt32, OLECMD[], IntPtr)	Consulta o objeto para o status do comando.
	SetGuidProperty(UInt32, Int32, Guid)	Define as propriedades cujos valores são GUIDs.
	SetProperty(UInt32, Int32, Object)	Define as propriedades de um nó específico ou da hierarquia.
	SetSite(IServiceProvider)	Define o provedor de serviços a partir do qual os serviços de acesso.
	UnadviseHierarchyEvents(UInt32)	Desativa a notificação de eventos de hierarquia de cliente sem exigir que a hierarquia de implementa IConnectionPointContainer.
	Unused0()	Não utilizados.Return E_NOTIMPL.
	Unused1()	Não utilizados.Return E_NOTIMPL.
	Unused2()	Não utilizados.Return E_NOTIMPL.
	Unused3()	Não utilizados.Return E_NOTIMPL.
	Unused4()	Não utilizados.Return E_NOTIMPL.

Métodos de Extensão

	Nome	Descrição
	EnumImportingProjects()	Enumerates all the projects that are importing the shared assets owned by the given Shared Assets Project hierarchy.(Definido por SharedProjectUtilities.)
	EnumOwningProjectsOfSharedAssets()	The Shared Assets Projects that own and manage the shared assets imported by the given project.(Definido por SharedProjectUtilities.)
	GetActiveProjectContext()	Gets the active project context.(Definido por SharedProjectUtilities.)
	GetSharedItemsImportFullPaths()	Gets the full paths of the "Shared.items" files imported by the given project.(Definido por SharedProjectUtilities.)
	IsCapabilityMatch(String)	Sobrecarregado. Checks whether a given project matches the requirements prescribed in an AppliesTo expression.(Definido por PackageUtilities.)
	IsProjectImportingSharedAssets()	Determines whether the given project imports shared assets.(Definido por SharedProjectUtilities.)
	IsSharedAssetsProject()	Determines whether the given project is a Shared Assets Project.(Definido por SharedProjectUtilities.)
	SetActiveProjectContext(IVsHierarchy)	Sets the active project context.(Definido por SharedProjectUtilities.)

Comentários

Quando a janela hierarquia tem o foco, quaisquer comandos que você implementar são enviados para a janela de hierarquia em vez de para a interface de manipulação de comandos padrão, IOleCommandTarget, que não oferece suporte a hierarquias.IVsUIHierarchyé semelhante a IOleCommandTarget em termos de funcionalidade, mas também fornece informações sobre o item selecionado atualmente na hierarquia, com base no valor de VSITEMID.

Comandos que você deseja usar na fora da janela de hierarquia, como adicionar um item de projeto, não devem ser tratados pelo IVsUIHierarchy métodos.Use somente o IVsUIHierarchy interface para lidar com os seguintes tipos de comandos:

Comandos que exigem a janela hierarquia de interface do usuário tenha foco.
Comandos que atuam em um item específico dentro da hierarquia.(Se ItemID é igual a VSITEMID_SELECTION, o comando será aplicado para o item ou itens selecionados.)

Lidar com todos os outros comandos relacionados à hierarquia ativa com o IOleCommandTarget interface.

Dicas de ferramentas em uma janela de hierarquia de interface do usuário são reservadas para mostrar a legenda completa do nó se a legenda está sendo cortada (isto é, pelo modo de exibição atuala janela é muito estreita para mostrar a legenda do total).Você não pode fornecer dicas de ferramenta personalizada para windows da hierarquia de interface do usuário.

Observações para implementadores:

Implementado por criadores de VSPackage para manipular os comandos, como Recortar, Copy, Colar, Excluir, e Renomear enviado para a janela hierarquia.

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via