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 |
---|---|
|
O índice não é válido. |
|
Não há suporte para a unidade. |
|
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
Referência