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

Artigo
08/26/2023

Imita a funcionalidade das teclas Seta para baixo e Page Down.

Sintaxe

HRESULT MoveDown(
  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 Baixo	Move para baixo uma linha. Esse é o padrão.
tomParagraph	Ctrl+Seta para Baixo	Move um parágrafo para baixo.
tomScreen	Page Down	Move uma tela para baixo.
tomWindow	Ctrl+Page Down	Move para o último 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*

Ponteiro para uma variável que recebe a contagem real de unidades em que o ponto de inserção ou a extremidade ativa é movido para baixo. Recolher a seleção conta como uma unidade. Este parâmetro 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	A unidade não é válida.
S_FALSE	Falha por algum outro motivo.

Comentários

Os métodos ITextSelection::MoveUp e ITextSelection::MoveDown são semelhantes aos métodos ITextSelection::MoveLeft e ITextSelection::MoveRight , exceto pelo fato de refletirem o comportamento das teclas Seta para cima, Seta para baixo, Page Up 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