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

Artigo
08/26/2023

Move a posição inicial do intervalo a posição do primeiro caractere encontrado que está no conjunto de caracteres especificado por Cset, desde que o caractere seja encontrado dentro de Contagem de caracteres 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 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 ficará inalterada.

pDelta

Tipo: long*

O número real de caracteres que o início do intervalo é movido, 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
E_INVALIDARG	O Cset não é válido.
S_FALSE	Falha por algum outro motivo.

Comentários

Se nenhum caractere de Cset for encontrado nas posições Count da posição inicial, o intervalo será deixado inalterado.

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