Méthode ITextRange::GetChar (tom.h)
Obtient le caractère à la position de début de la plage.
HRESULT GetChar(
long *pChar
);
pChar
Type : long*
Position du caractère de début de la plage.
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.
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.
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 |
Conceptuel
Référence