Metodo ITextRange::GetText (tom.h)

Articolo
08/26/2023

Ottiene il testo normale in questo intervallo. La proprietà Text è la proprietà predefinita dell'interfaccia ITextRange .

Sintassi

HRESULT GetText(
  BSTR *pbstr
);

Parametri

pbstr

Tipo: BSTR*

Testo.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_INVALIDARG	pbstr è Null.
E_OUTOFMEMORY	Memoria insufficiente per contenere il testo.

Commenti

Il metodo ITextRange::GetText restituisce il testo normale nell'intervallo. La proprietà Text è la proprietà predefinita per ITextRange; viene richiamato automaticamente per un intervallo, come nell'esempio di Microsoft Visual Basic, Applications Edition (VBA) seguente.

print range

Alcuni degli esempi seguenti usano questo fatto. Il metodo ITextRange::SetText sostituisce bstr per il testo dell'intervallo. Per l'elaborazione di un singolo carattere, la proprietà Char è più efficiente della proprietà Text e non richiede la creazione di un singolo intervallo di caratteri per l'archiviazione di un carattere. Se l'intervallo è degenerato, la proprietà Text consente di inserire facilmente il testo. È anche possibile eliminare il testo in un intervallo, come illustrato negli esempi VBA seguenti.

range.delete

range = ""

È possibile usare la proprietà Text per copiare testo normale da un luogo all'altro, semplicemente impostando un intervallo uguale a un altro. Per altre informazioni, vedere ITextRange::GetDuplicate. L'istruzione di esempio di Microsoft Visual Basic seguente imposta il testo nell'intervallo1 in tale intervallo2.

range1 = range2 ' Replace range1's text by range2's

Gli intervalli possono essere in storie diverse o anche in applicazioni diverse. Tuttavia, implicano la copia del testo prima in un BSTR e quindi da tale stringa alla posizione di destinazione. Per grandi quantità di testo, i metodi ITextRange::Copy e ITextRange::P aste possono essere più veloci, poiché possono eseguire la copia direttamente dall'origine alla destinazione e con qualsiasi formato supportato dall'origine e dalla destinazione.

Il testo restituito dalla proprietà Text viene specificato in Unicode. Il segno finale del paragrafo può essere assegnato da 0x2029 (separatore di paragrafo Unicode) o dal feed di ritorno/riga a capo (CR/LF) (0xd, 0xa) o da un ritorno a capo solo, a seconda del file originale. Microsoft Word usa un ritorno a capo solo, a meno che non legge un'altra scelta in un file, negli Appunti o in un IDataObject. Il segnaposto per un oggetto incorporato viene assegnato dal carattere speciale , WCH_EMBEDDING, con il valore Unicode 0xFFFC.

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