IVsUIHierWinClipboardHelper.Paste(IDataObject, UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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. |
- Os valores do
dwEffectsparâmetro são extraídos daDROPEFFECTenumeração no conjunto de documentação do MSDN Library Platform SDK.