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.
Dementsprechend unterstützt das Text Object Model (TOM) keine Characters-Auflistung.

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

ITextRange

Referenz

SetChar

Textobjektmodell