ListView_Scroll macro (commctrl.h)

Artigo
10/24/2024

Rola o conteúdo de um controle de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_SCROLL explicitamente.

Sintaxe

BOOL ListView_Scroll(
   HWND hwndLV,
   int  dx,
   int  dy
);

Parâmetros

hwndLV

Tipo: HWND

Um identificador para o controle de exibição de lista.

dx

Tipo: int

Um valor do tipo int que especifica a quantidade de rolagem horizontal, em pixels, em relação à posição atual do conteúdo da exibição de lista. Se o controle de exibição de lista estiver no modo de exibição de lista, esse valor será arredondado para o número mais próximo de pixels que formam uma coluna inteira.

dy

Tipo: int

Um valor do tipo int que especifica a quantidade de rolagem vertical, em pixels, em relação à posição atual do conteúdo da exibição de lista.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Quando o controle de exibição de lista está no modo de exibição de relatório, o controle só pode ser rolado verticalmente em incrementos de linha inteiros. Portanto, o parâmetro dy será arredondado para o número mais próximo de pixels que formam um incremento de linha inteiro. Por exemplo, se a altura de uma linha for de 16 pixels e 8 for passada para dy, a lista será rolada por 16 pixels (1 linha). Se 7 for passado para dy, a lista será rolada 0 pixels (0 linhas).

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via