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

Ajusta os pontos de extremidade de intervalo aos valores especificados.

Sintaxe

HRESULT SetRange(
  long cpAnchor,
  long cpActive
);

Parâmetros

cpAnchor

Tipo: long

A posição do caractere para a extremidade de âncora do intervalo.

cpActive

Tipo: long

A posição do caractere para o final ativo do intervalo.

Retornar valor

Tipo: HRESULT

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

Comentários

Esse método define a posição inicial do intervalo como min(cpActive, cpAnchor)e a posição final como max(cpActive, cpAnchor). Se o intervalo for uma seleção não genérica, cpAnchor será o final ativo e cpAnchor será a extremidade de âncora. Se o intervalo for uma seleção degenerada, a seleção será exibida no início da linha, em vez de no final da linha anterior.

Esse método remove quaisquer outras suborganizações que esse intervalo possa ter. Para preservar os subranges atuais, use ITextRange2::SetActiveSubrange.

Se o intervalo de texto for uma seleção, você poderá definir os atributos da seleção usando o método ITextSelection::SetFlags .

Requisitos

Confira também

Conceitual

ITextRange

Referência

Modelo de objeto de texto