Método ITextRange::GetChar (tom.h)

Artigo
08/26/2023

Obtém o caractere na posição inicial do intervalo.

Sintaxe

HRESULT GetChar(
  long *pChar
);

Parâmetros

pChar

Tipo: long*

A posição do caractere inicial do intervalo.

Valor retornado

Tipo: HRESULT

O método retorna um valor HRESULT . Se o método for bem-sucedido, ele retornará S_OK. Se pChar for nulo, o método falhará e retornará E_INVALIDARG.

Comentários

O exemplo do Microsoft Visual Basic a seguir define ch igual ao caractere no início do intervalo.

ch = r.Char

Da mesma forma, ITextRange::SetChar substitui o caractere no início do intervalo com o caractere especificado. Os caracteres recuperados e definidos por esses métodos são variáveis LONG , que ocultam a maneira como são armazenados no repositório de backup (como bytes, palavras, comprimento variável e assim por diante), e não exigem o uso de um BSTR.

A propriedade Char, que pode fazer a maioria das coisas que uma coleção de caracteres pode, tem duas grandes vantagens:

Ele pode referenciar qualquer caractere na história pai em vez de ser limitado ao intervalo pai.
É significativamente mais rápido, já que LONGs estão envolvidos em vez de objetos de intervalo.

Assim, o TOM (Modelo de Objeto de Texto) não dá suporte a uma coleção de caracteres.

Requisitos


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