Método ITextRange::Copy (tom.h)
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
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 |
Confira também
Conceitual
Referência