Método ITextRange::MoveStartUntil (tom.h)
Move a posição inicial do intervalo da posição do primeiro caractere encontrado que está no conjunto de caracteres especificado pelo Cset, desde que o caractere seja encontrado dentro dos caracteres Count da posição inicial.
Sintaxe
HRESULT MoveStartUntil(
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 para passar. 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 Contagem for zero, a posição inicial será inalterada.
pDelta
Tipo: long*
O número real de caracteres que o início do intervalo é movido, mais 1 para uma correspondência se a Contagem for maior que zero e –1 para uma correspondência se Contagem 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 |
|---|---|
|
O Cset não é válido. |
|
Falha por algum outro motivo. |
Comentários
Se nenhum caractere do Cset for encontrado nas posições de contagem da posição inicial, o intervalo ficará inalterado.
Se o novo início seguir a extremidade antiga, o novo final será definido como igual ao novo início.
O movimento descrito por ITextRange::MoveStartUntil é 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 |
Confira também
Conceitual
Referência