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

Artigo
03/03/2024

Move a posição inicial do intervalo o número especificado de unidades na direção especificada.

Sintaxe

HRESULT MoveStart(
  long Unit,
  long Count,
  long *pDelta
);

Parâmetros

Unit

Tipo: long

Unidade usada na movimentação. O valor padrão é tomCharacter. Para obter uma lista dos outros valores de Unidade , consulte a discussão em ITextRange.

Count

Tipo: long

Número de unidades a serem movidas. O valor padrão é 1. Se Count for maior que zero, o movimento será para frente , no final da história , e se Count for menor que zero, o movimento será para trás – para o início. Se Count for zero, a posição inicial ficará inalterada.

pDelta

Tipo: long*

O número real de unidades que o final é movido. 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_NOTIMPL	Não há suporte para unidade.
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::MoveStart é 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