ITextRange2::GetChar2-Methode (tom.h)

Ruft das Zeichen am angegebenen Offset vom Ende dieses Bereichs ab.

Syntax

HRESULT GetChar2(
  [out] long *pChar,
  [in]  long Offset
);

Parameter

[out] pChar

Typ: long*

Der Zeichenwert.

[in] Offset

Typ: long

Der Offset vom Ende des Bereichs. Ein Offset von 0 ruft das Zeichen am Ende des Bereichs ab.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, gibt sie NOERROR zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode unterscheidet sich von ITextRange::GetChar auf folgende Weise:

  • Es gibt das UTF-32-Zeichen für das Ersatzpaar anstelle des Leadcodes des Paares zurück.
  • Es ruft den Zeichencode oder Codes am angegebenen Offset vom Ende des Bereichs ab und nicht das Zeichen am Anfang des Bereichs.

Wenn das Zeichen der Leadcode für ein Ersatzpaar ist, wird das entsprechende UTF-32-Zeichen zurückgegeben.

Wenn Offset ein Zeichen vor Dem Beginn der Geschichte oder am Ende der Geschichte angibt, gibt diese Methode den Zeichencode 0 zurück.

Wenn der Offset-Wert ist Dieses Zeichen wird zurückgegeben.
0 Das Zeichen am Ende des Bereichs.
Negativ und greift auf die Mitte eines Ersatzpaars zu. Das entsprechende UTF-32-Zeichen.
Positiv und greift auf die Mitte eines Ersatzpaars zu. Das UTF-32-Zeichen nach diesem Paar.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile tom.h
DLL Msftedit.dll

Weitere Informationen

ITextRange2