Interface IVsUIHierWinClipboardHelper

Artigo
08/09/2016

Publicado: abril de 2016

Coordena a área de transferência entre hierarquias em uma janela de hierarquia de interface do usuário.

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

Sintaxe

[InterfaceTypeAttribute(1)]
[GuidAttribute("DF29D855-D0EC-4DA1-BCC3-42FA3A09B1CB")]
public interface IVsUIHierWinClipboardHelper

[InterfaceTypeAttribute(1)]
[GuidAttribute("DF29D855-D0EC-4DA1-BCC3-42FA3A09B1CB")]
public interface class IVsUIHierWinClipboardHelper

[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("DF29D855-D0EC-4DA1-BCC3-42FA3A09B1CB")>]
type IVsUIHierWinClipboardHelper = interface end

<InterfaceTypeAttribute(1)>
<GuidAttribute("DF29D855-D0EC-4DA1-BCC3-42FA3A09B1CB")>
Public Interface IVsUIHierWinClipboardHelper

Métodos

	Nome	Descrição
	AdviseClipboardHelperEvents(IVsUIHierWinClipboardHelperEvents, UInt32)	Estabelece a notificação de eventos de auxiliar de área de transferência de hierarquia do cliente sem a hierarquia de implementar IConnectionPointContainer.
	Copy(IDataObject)	Copia um objeto de dados de uma hierarquia para a área de transferência.
	Cut(IDataObject)	Recorta um objeto de dados de uma hierarquia para a área de transferência.
	Paste(IDataObject, UInt32)	Cola um objeto de dados da área de transferência para a hierarquia.
	UnadviseClipboardHelperEvents(UInt32)	Desabilita a notificação do cliente de hierarquia da área de transferência auxiliar eventos sem a necessidade de que a hierarquia de implementa IConnectionPointContainer.

Comentários

Qualquer hierarquia que deseja coordenar suas operações de área de transferência com outras hierarquias deve implementar IVsUIHierWinClipboardHelperEvents e registre-se para receber notificações de eventos de área de transferência chamando AdviseClipboardHelperEvents.

Este é um exemplo de uma seqüência típica de recortar e colar entre hierarquias:

O usuário executa uma transferência de um item de projeto de uma hierarquia de projeto.
Cria o projeto de origem um IDataObject contendo os dados CF_VSPROJECTITEMS formato (como o CF_HDROP formato). Além de passar o IDataObject para OLE, a hierarquia de origem também passa para o ambiente por meio de Cut método.
O projeto de origem altera a aparência do item recortado chamando ExpandItem e especificando um valor de EXPF_CutHighlightItem ou EXPF_AddCutHighlightItem, conforme apropriado.
O usuário executa uma operação de colar do item de projeto.
O projeto de destino manipula o conteúdo de IDataObject, e comunica-se de que uma operação de colar ocorreu ao chamar Paste.
Quando seu Paste método é chamado, o IVsUIHierWinClipboardHelper interface percorre a lista de hierarquias que chamou AdviseClipboardHelperEvents e chamadas OnPaste em cada um. Quando o projeto de origem é chamado dessa forma, ele deve concluir a transferência, excluindo o item recortado de sua hierarquia.

O IVsUIHierWinClipboardHelper interface é também um Inspetor de área de transferência, então quando altera o conteúdo da área de transferência e a transferência IDataObject não está mais na área de transferência, o OnClear método de cada ouvinte é chamado. Dessa forma, o item recortado pode ser mais esmaecido chamando ExpandItem e especificando um valor de EXPF_UnCutHighlightItem. Em uma situação de cópia, o item não precisa esmaecido desde que ele não foi reduzido.

Ver ilustrações de implementação e/ou chamada dessa interface no exemplo Basic Project.

Observações para implementadores:

Implementado pelo ambiente.

Observações para chamadores:

Chamado por hierarquias que dão suporte a recortar, copiar e colar operações.

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via