Metodo ITextRange::GetChar (tom.h)

Ottiene il carattere nella posizione iniziale dell'intervallo.

Sintassi

HRESULT GetChar(
  long *pChar
);

Parametri

pChar

Tipo: long*

Posizione del carattere iniziale dell'intervallo.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT . Se il metodo ha esito positivo, restituisce S_OK. Se pChar è Null, il metodo ha esito negativo e restituisce E_INVALIDARG.

Commenti

Nell'esempio di Microsoft Visual Basic seguente viene impostato ch uguale al carattere all'inizio dell'intervallo.

ch = r.Char

Analogamente, ITextRange::SetChar sovrascrive il carattere all'inizio dell'intervallo con il carattere specificato. I caratteri recuperati e impostati da questi metodi sono variabili LONG , che nascondono la modalità di archiviazione nell'archivio di backup (come byte, parole, lunghezza variabile e così via) e non richiedono l'uso di un valore BSTR.

La proprietà Char, che può eseguire la maggior parte delle operazioni che un insieme di caratteri può, presenta due grandi vantaggi:

• Può fare riferimento a qualsiasi carattere nella storia padre anziché essere limitato all'intervallo padre.
• È significativamente più veloce, poiché LONGè coinvolto invece di oggetti di intervallo.

Di conseguenza, il modello TOM (Text Object Model) non supporta una raccolta di caratteri.

Requisiti

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

Vedi anche

Informazioni concettuali

ITextRange

Riferimento

SetChar

Modello a oggetti di testo