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.
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
Référence