Metodo ITextRange::Copy (tom.h)

Articolo
03/13/2024

Copia il testo in un oggetto dati.

Sintassi

HRESULT Copy(
  VARIANT *pVar
);

Parametri

pVar

Tipo: VARIANT*

Testo copiato. pVar-ppunkVal> è il parametro out per un IDataObject, a condizione che esistano le condizioni seguenti:

pVar-vt> = (VT_UNKNOWN | VT_BYREF)
pVar non è Null
pVar-ppunkVal> non è Null

In caso contrario, gli Appunti vengono usati.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce un valore HRESULT . Se ha esito positivo, restituisce S_OK. In caso contrario, restituisce E_OUTOFMEMORY.

Commenti

I metodi ITextRange::Cut, ITextRange::Copy e ITextRange::P aste consentono di eseguire le normali operazioni Cut, Copy e Paste in un oggetto range usando un oggetto IDataObject, quindi non modificando il contenuto degli Appunti. Tra i formati degli Appunti in genere supportati sono CF_TEXT e CF_RTF. Inoltre, i formati degli Appunti privati possono essere usati per fare riferimento ai formati di testo interni di una soluzione di testo.

Per copiare e sostituire il testo normale, è possibile usare i metodi ITextRange::GetText e ITextRange::SetText . Per copiare il testo formattato dall'intervallo r1 all'intervallo r2 senza usare gli Appunti, è possibile usare Copia e Incolla e anche ITextRange::GetFormattedText e ITextRange::SetFormattedText, come illustrato nell'esempio di Microsoft Visual Basic seguente:

r2.GetFormattedText = r1.GetFormattedText

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll