IVsUIHierWinClipboardHelper.Paste(IDataObject, UInt32) Método

Definição

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

public:
 int Paste(Microsoft::VisualStudio::OLE::Interop::IDataObject ^ pDataObject, System::UInt32 dwEffects);
public:
 int Paste(Microsoft::VisualStudio::OLE::Interop::IDataObject ^ pDataObject, unsigned int dwEffects);
int Paste(Microsoft::VisualStudio::OLE::Interop::IDataObject const & pDataObject, unsigned int dwEffects);
public int Paste (Microsoft.VisualStudio.OLE.Interop.IDataObject pDataObject, uint dwEffects);
abstract member Paste : Microsoft.VisualStudio.OLE.Interop.IDataObject * uint32 -> int
Public Function Paste (pDataObject As IDataObject, dwEffects As UInteger) As Integer

Parâmetros

pDataObject
IDataObject

no Ponteiro para a IDataObject interface no item que está sendo colado. Esse objeto de dados contém os dados que estão sendo transferidos na operação de colagem. Se a colagem ocorrer, esse objeto de dados (item de hierarquia) será incorporado à hierarquia de destino.

dwEffects
UInt32

no Ponteiro para o valor do pdwEffect parâmetro do IVsHierarchy objeto, identificando todos os efeitos aos quais a hierarquia dá suporte.

Retornos

Int32

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

Comentários

Assinatura COM

De VSShell. idl:

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

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

Os efeitos Drop são incluídos no dwEffect parâmetro e descrevem a ação associada a uma operação DROP. A tabela a seguir mostra os dwEffect valores possíveis e suas descrições:

Observação

Esses efeitos são exclusivos e não podem ser combinados usando-se o operador OR.

Nome do efeito Value1 Descrição
DROPEFFECT_NONE 0 O destino de soltura (janela de hierarquia) não pode aceitar os dados. Nenhuma queda será permitida.
DROPEFFECT_COPY 1 O item descartado permanece na origem e uma cópia dele é adicionada ao destino.
DROPEFFECT_MOVE 2 O item removido 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 seja removido da origem, mas o armazenamento deve permanecer para que o link não seja interrompido. Um link é, portanto, um caso especial de mover.
  1. Os valores do dwEffects parâmetro são extraídos da DROPEFFECT enumeração no conjunto de documentação do MSDN Library Platform SDK.

Aplica-se a