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

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.

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

Confira também

Conceitual

ITextRange

Mover

MoveWhile

Referência

Modelo de objeto de texto