Compartilhar via


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

Move a posição final do intervalo.

Sintaxe

HRESULT MoveEnd(
  long Unit,
  long Count,
  long *pDelta
);

Parâmetros

Unit

Tipo: long

As unidades pelas quais mover o final do intervalo. O valor padrão é tomCharacter. Para obter uma lista dos outros valores unitários, consulte ITextRange.

Count

Tipo: long

O número de unidades a serem passadas. O valor padrão é 1. Se Count for maior que zero, o movimento será encaminhado para o final da história e, se Count for menor que zero, o movimento será para trás em direção ao início. Se Count for zero, a posição final será inalterada.

pDelta

Tipo: long*

O número real de unidades que a posição final do intervalo é movida. O valor pode ser nulo.

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_NOTIMPL
Não há suporte para a unidade.
S_FALSE
Falha por algum outro motivo.

Comentários

Se a nova posição final preceder a posição inicial antiga, a nova posição inicial será definida como igual à nova posição final; ou seja, torna-se um intervalo degenerado ou um ponto de inserção.

O movimento descrito por ITextRange::MoveEnd é lógico em vez de geométrico. Ou seja, o movimento está no final ou no início de uma história. Dependendo do idioma, mover-se para o final da história pode estar se movendo para a esquerda ou se movendo para a direita.

Para obter mais informações, consulte ITextRange e ITextRange::Move.

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

Mover

Referência

Modelo de objeto de texto