Método ITextRange::GetChar (tom.h)
Obtiene el carácter en la posición inicial del intervalo.
Sintaxis
HRESULT GetChar(
long *pChar
);
Parámetros
pChar
Tipo: long*
Posición del carácter inicial del intervalo.
Valor devuelto
Tipo: HRESULT
El método devuelve un valor HRESULT . Si el método se realiza correctamente, devuelve S_OK. Si pChar es null, se produce un error en el método y devuelve E_INVALIDARG.
Comentarios
En el siguiente ejemplo de Microsoft Visual Basic se establece ch igual al carácter al principio del intervalo.
ch = r.Char
Del mismo modo, ITextRange::SetChar sobrescribe el carácter al principio del intervalo con el carácter especificado. Los caracteres recuperados y establecidos por estos métodos son variables LONG , que ocultan la forma en que se almacenan en el almacén de respaldo (como bytes, palabras, longitud variable, etc.) y no requieren usar un BSTR.
La propiedad Char, que puede hacer la mayoría de las cosas que una colección de caracteres puede, tiene dos grandes ventajas:
- Puede hacer referencia a cualquier carácter del artículo primario en lugar de limitarse al intervalo primario.
- Es significativamente más rápido, ya que los objetos LONGestán implicados en lugar de objetos de rango.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | tom.h |
| Archivo DLL | Msftedit.dll |
Consulte también
Conceptual
Referencia