Método ITextRange2::GetChar2 (tom.h)

Obtém o caractere no deslocamento especificado do final desse intervalo.

Sintaxe

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

[out] pChar

Tipo: long*

O valor do caractere.

[in] Offset

Tipo: long

O deslocamento do final do intervalo. Um deslocamento de 0 obtém o caractere no final do intervalo.

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará NOERROR. Caso contrário, ele retornará um código de erro HRESULT.

Esse método difere de ITextRange::GetChar das seguintes maneiras:

Ele retorna o caractere UTF-32 para o par alternativo em vez do código principal do par.
Ele obtém o código de caractere, ou códigos, no deslocamento especificado do final do intervalo em vez do caractere no início do intervalo.

Se o caractere for o código principal de um par alternativo, o caractere UTF-32 correspondente será retornado.

Se Offset especificar um caractere antes do início da história ou no final da história, esse método retornará o código de caractere 0.

Se o valor de Deslocamento for	Esse caractere é retornado
0	O caractere no final do intervalo.
Negativo e acessa o meio de um par alternativo	O caractere UTF-32 correspondente.
Positivo e acessa o meio de um par substituto	O caractere UTF-32 após esse par.

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll