Método ITextRange::Copy (tom.h)

Artigo
03/13/2024

Copia o texto para um objeto de dados.

Sintaxe

HRESULT Copy(
  VARIANT *pVar
);

Parâmetros

pVar

Tipo: VARIANT*

O texto copiado. pVar-ppunkVal> é o parâmetro out para um IDataObject, desde que as seguintes condições existam:

pVar-vt> = (VT_UNKNOWN | VT_BYREF)
pVar não é nulo
pVar-ppunkVal> não é nulo

Caso contrário, a área de transferência será usada.

Retornar valor

Tipo: HRESULT

Esse método retorna um valor HRESULT . Se tiver êxito, ele retornará S_OK. Caso contrário, ele retornará E_OUTOFMEMORY.

Comentários

Os métodos ITextRange::Cut, ITextRange::Copy e ITextRange::P aste permitem que você execute as operações de corte, cópia e colagem habituais em um objeto de intervalo usando um IDataObject, não alterando assim o conteúdo da área de transferência. Entre os formatos de área de transferência normalmente compatíveis estão CF_TEXT e CF_RTF. Além disso, formatos de área de transferência privada podem ser usados para referenciar os próprios formatos de rich text internos de uma solução de texto.

Para copiar e substituir texto sem formatação, você pode usar os métodos ITextRange::GetText e ITextRange::SetText . Para copiar o texto formatado do intervalo r1 para o intervalo r2 sem usar a área de transferência, você pode usar copiar e colar e também os métodos ITextRange::GetFormattedText e ITextRange::SetFormattedText , conforme mostrado no exemplo do Microsoft Visual Basic a seguir:

r2.GetFormattedText = r1.GetFormattedText

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll