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

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

Confira também

Conceitual

ITextRange

Referência

Setchar

Modelo de objeto de texto