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

Artigo
03/03/2024

Move o intervalo para o início da primeira Unidade sobreposta no intervalo.

Sintaxe

HRESULT StartOf(
  long Unit,
  long Extend,
  long *pDelta
);

Parâmetros

Unit

Tipo: long

Unidade a ser usada na operação de movimentação. Para obter uma lista de valores unitários , consulte a discussão em ITextRange.

Extend

Tipo: long

Como mover as extremidades do intervalo. Pode ser um dos seguintes valores.

0 (ou tomMove)	Recolhe um intervalo não descricional para a posição inicial movendo o ponto de inserção. Esse é o padrão.
1 (ou tomExtend)	Move a posição inicial para o início da Unidade sobreposta. Não move a posição final.

pDelta

Tipo: long*

Ponteiro para uma variável que recebe o número de caracteres que a posição inicial é movida. Pode ser nula. No retorno, pDelta é o número assinado de caracteres que o ponto de inserção ou a posição inicial é movido. Esse valor é sempre menor ou igual a zero, porque o movimento é sempre em direção ao início da história.

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 a unidade.
S_FALSE	Falha por algum outro motivo.

Comentários

Se o intervalo for um ponto de inserção em um limite entre as Unidades, ITextRange::StartOf não alterará a posição inicial.

Os métodos ITextRange::StartOf e ITextRange::EndOf diferem dos métodos HomeKey e EndKey , pois este último se estende do final ativo, enquanto ITextRange::StartOf se estende da posição inicial e ITextRange::EndOf se estende da posição final.

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