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

Artigo
08/26/2023

Move o final do intervalo contagem de caracteres ou apenas ultrapassa todos os caracteres contíguos encontrados no conjunto de caracteres especificado por Cset, o que for menor.

Sintaxe

HRESULT MoveEndWhile(
  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 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 será inalterada.

pDelta

Tipo: long*

O número real de caracteres que o final é movido. O valor pode ser nulo.

Valor retornado

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	Cset não é válido.
S_FALSE	Falha por algum outro motivo.

Comentários

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::MoveEndWhile é 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


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