Méthode ITextRange::GetChar (tom.h)

Obtient le caractère à la position de début de la plage.

Syntaxe

HRESULT GetChar(
  long *pChar
);

Paramètres

pChar

Type : long*

Position du caractère de début de la plage.

Valeur retournée

Type : HRESULT

La méthode retourne une valeur HRESULT . Si la méthode réussit, elle retourne S_OK. Si pChar a la valeur Null, la méthode échoue et retourne E_INVALIDARG.

Remarques

L’exemple Microsoft Visual Basic suivant définit ch égal au caractère au début de la plage.

ch = r.Char

De même, ITextRange::SetChar remplace le caractère au début de la plage par le caractère spécifié. Les caractères récupérés et définis par ces méthodes sont des variables LONG , qui masquent la façon dont ils sont stockés dans le magasin de stockage (sous forme d’octets, de mots, de longueur variable, etc.) et ne nécessitent pas l’utilisation d’un BSTR.

La propriété Char, qui peut effectuer la plupart des tâches d’une collection de caractères, présente deux grands avantages :

  • Il peut référencer n’importe quel caractère de l’histoire parente au lieu d’être limité à la plage parente.
  • Il est considérablement plus rapide, car les longssont impliqués dans les objets plutôt que dans les objets de plage.
Par conséquent, le modèle d’objet texte (TOM) ne prend pas en charge une collection de caractères.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tom.h
DLL Msftedit.dll

Voir aussi

Conceptuel

ITextRange

Référence

SetChar

Modèle objet texte