Método IVsUIHierWinClipboardHelper.Paste (IDataObject, UInt32)

Artigo
06/13/2016

Cola um objeto de dados da área de transferência à hierarquia.

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

Sintaxe

int Paste(
    IDataObject pDataObject,
    uint dwEffects
)

int Paste(
    IDataObject^ pDataObject,
    unsigned int dwEffects
)

abstract Paste : 
        pDataObject:IDataObject *
        dwEffects:uint32 -> int

Function Paste (
    pDataObject As IDataObject,
    dwEffects As UInteger
) As Integer

Parâmetros

pDataObject
[in] Ponteiro para o IDataObject interface no item que está sendo colado.Este objeto de dados contém os dados transferidos na operação de colar.Se ocorrer a colar, esse objeto de dados (item de hierarquia) é incorporado à hierarquia do destino.

dwEffects
[in] Ponteiro para o valor da pdwEffect parâmetro da IVsHierarchy objeto, identificando todos os efeitos que ofereça suporte a hierarquia.

Valor de retorno

Type: System.Int32

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

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsUIHierWinClipboardHelper::Paste(
   [in] IDataObject *pDataObject,
   [in] DWORD dwEffects
);

Quando uma operação de colar ocorre na hierarquia de destino, a hierarquia de origem recebe a notificação de colar do ambiente, por meio do OnPaste método.

Soltar efeitos estão incluídos na dwEffect parâmetro e descreva a ação associada a uma operação de soltar.A tabela a seguir mostra possível dwEffect valores e suas descrições:

Observação
Esses efeitos são exclusivos e não podem ser combinados com o operador bit a bit de ou.

Nome do efeito	Valor1	Descrição
DROPEFFECT_NONE	0	O destino de soltar (janela de hierarquia) não pode aceitar os dados.Sem soltar teria permissão.
DROPEFFECT_COPY	1	Item eliminado permanece na fonte e uma cópia dele é adicionada ao destino.
DROPEFFECT_MOVE	2	Eliminados do item foi adicionado ao destino.O item é removido da origem e seu armazenamento é excluído.
DROPEFFECT_LINK	4	Um link para o item de origem é adicionado ao destino para que o item deve ser removido da fonte, mas o armazenamento deve permanecer para que o link não é quebrado.Portanto, um link é um caso especial de movimentação.

1.Os valores da dwEffects parâmetro são obtidas a partir do DROPEFFECT enumeração no conjunto de documentação de Platform SDK do Biblioteca MSDN.

Consulte também

Interface IVsUIHierWinClipboardHelper
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via