ITextRange::GetChar-Methode (tom.h)
Ruft das Zeichen an der Startposition des Bereichs ab.
Syntax
HRESULT GetChar(
long *pChar
);
Parameter
pChar
Typ: long*
Die Anfangszeichenposition des Bereichs.
Rückgabewert
Typ: HRESULT
Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn pChar NULL ist, schlägt die Methode fehl, und es wird E_INVALIDARG zurückgegeben.
Hinweise
Im folgenden Microsoft Visual Basic-Beispiel wird ch gleich dem Zeichen am Anfang des Bereichs festgelegt.
ch = r.Char
Ebenso überschreibt ITextRange::SetChar das Zeichen am Anfang des Bereichs mit dem angegebenen Zeichen. Die von diesen Methoden abgerufenen und festgelegten Zeichen sind LONG-Variablen , die die Art und Weise ausblenden, in der sie im Sicherungsspeicher gespeichert werden (als Bytes, Wörter, variable Länge usw.), und sie erfordern keine Verwendung eines BSTR.
Die Char-Eigenschaft, die die meisten Aktionen ausführen kann, die eine Zeichensammlung ausführen kann, hat zwei große Vorteile:
- Es kann auf jedes Zeichen im übergeordneten Textabschnitt verweisen, anstatt auf den übergeordneten Bereich beschränkt zu sein.
- Dies ist deutlich schneller, da LONG-Objekteanstelle von Bereichsobjekten beteiligt sind.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | tom.h |
| DLL | Msftedit.dll |
Siehe auch
Konzept
Referenz