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

Artigo
03/03/2024

Move a extremidade do intervalo para a posição do caractere do primeiro caractere encontrado que está no conjunto de caracteres especificado por Cset, desde que o caractere seja encontrado dentro de Contagem de caracteres do final do intervalo.

Sintaxe

HRESULT MoveEndUntil(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

Parâmetros

Cset

Tipo: VARIANT*

O conjunto de caracteres a ser usado na correspondência. Isso pode ser uma cadeia de caracteres explícita de caracteres ou um índice de conjunto de caracteres. Para obter mais informações, consulte Conjuntos de correspondência de caracteres.

Count

Tipo: long

Número máximo de caracteres a serem passados. O valor padrão é tomForward, que pesquisa até o final da história. Se Count for maior que zero, a pesquisa avançará (no final da história). Se Count for menor que zero, a pesquisa se moverá para trás (em direção ao início da história). Se Count for zero, a posição final ficará inalterada.

pDelta

Tipo: long*

O número real de caracteres que a extremidade do intervalo é movida, mais 1 para uma correspondência se Count for maior que zero e –1 para uma correspondência se Count for menor que zero. 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
Valor	Significado
E_INVALIDARG	O Cset é inválido.
S_FALSE	Falha por algum outro motivo.

Comentários

Se nenhum caractere do conjunto especificado por Cset for encontrado nas posições Count da extremidade do intervalo, o intervalo será deixado inalterado. Se a nova extremidade preceder o início antigo, o novo início será definido como igual ao novo fim.

O movimento descrito por ITextRange::MoveEndUntil é 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 movendo-se 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