Método ITextRange::StartOf (tom.h)
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 |
---|---|
|
Não há suporte para a unidade. |
|
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 |
Confira também
Conceitual
Referência