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

Altera esse intervalo para a unidade especificada da história.

Sintaxe

HRESULT SetIndex(
  [in] long Unit,
  [in] long Index,
  [in] long Extend
);

Parâmetros

[in] Unit

Tipo: long

Unidade usada para indexar o intervalo. Para obter uma lista de valores unitários, consulte ITextRange.

[in] Index

Tipo: long

Índice para a Unidade. Esse intervalo é realocado para a Unidade que tem esse número de índice. Se positivo, a numeração de Unidadescomeça no início da história e prossiga. Se negativo, a numeração começa no final da história e prossegue para trás. O início da história corresponde a um Índice de 1 para todas as unidades existentes, e a última unidade na história corresponde a um Índice de -1.

[in] Extend

Tipo: long

Sinalizador que indica a extensão do intervalo. Se zero (o padrão), o intervalo será recolhido a um ponto de inserção na posição inicial da Unidade especificada. Se diferente de zero, o intervalo será definido como toda a Unidade.

Retornar valor

Tipo: HRESULT

O método retorna um valor HRESULT . Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno Descrição
E_INVALIDARG
O índice não é válido.
E_NOTIMPL
Não há suporte para a unidade.
S_FALSE
Falha por algum outro motivo.

Comentários

Esse método permite que um aplicativo trabalhe com texto orientado a linhas, como programas, de maneira conveniente. Por exemplo, SetIndex(tomLine, 10, 0) converte um intervalo em um ponto de inserção no início da décima linha.

Requisitos

Requisito Valor
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

Modelo de objeto de texto