Método ITextSelection::MoveUp (tom.h)

Artigo
03/13/2024

Imita a funcionalidade das teclas Seta para Cima e Page Up.

Sintaxe

HRESULT MoveUp(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Parâmetros

Unit

Tipo: long

Unidade a ser usada na operação. Pode ser um dos seguintes.

Valor	Combinação de chaves correspondente	Significado
tomLine	Seta para Cima	Move para cima uma linha. Esse é o padrão.
tomParagraph	Ctrl+Seta para Cima	Move para cima um parágrafo.
tomScreen	Page Up	Move para cima uma tela.
tomWindow	Ctrl+Page Up	Move para o primeiro caractere na janela.

Count

Tipo: long

Número de unidades a serem passadas. O valor padrão é 1.

Extend

Tipo: long

Sinalizador que indica como alterar a seleção. Se Extend for zero (ou tomMove), o método recolherá a seleção para um ponto de inserção e moverá. Se Extend for 1 (ou tomExtend), o método moverá a extremidade ativa e deixará a outra extremidade sozinha. O valor padrão é zero. Um valor Extend diferente de zero corresponde à tecla Shift que está sendo pressionada, além da combinação de teclas descrita em Unidade.

pDelta

Tipo: long*

A contagem real de unidades que o ponto de inserção ou a extremidade ativa são movidas para baixo. Este parâmetro pode ser nulo. Recolher a seleção conta como uma unidade.

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	A unidade não é válida.
S_FALSE	Falha por algum outro motivo.

Comentários

Os métodos MoveUp e MoveDown são semelhantes aos métodos MoveLeft e MoveRight , exceto que refletem o comportamento das teclas Seta para Cima, Seta para Baixo, Página Para Cima e Page Down no teclado de cursor.

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