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

Artigo
08/26/2023

Move a posição inicial 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 MoveStartWhile(
  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 será encaminhada para o final da história e, se Count for menor que zero, a pesquisa será anterior ao início. Se Count for zero, a posição inicial será inalterada.

pDelta

Tipo: long*

A contagem real de caracteres que a posição inicial é movida. Este parâmetro 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_INVALIDARG	Cset não é válido.
S_FALSE	Falha por algum outro motivo.

Comentários

Se o novo início seguir a extremidade antiga, a nova extremidade será definida como igual ao novo início.

O movimento descrito por ITextRange::MoveStartWhile é 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