Função GetScrollRange (winuser.h)

Artigo
08/27/2023

A função GetScrollRange recupera as posições de caixa de rolagem mínima e máxima atual (polegar) para a barra de rolagem especificada.

Nota A função GetScrollRange é fornecida apenas para compatibilidade. Novos aplicativos devem usar a função GetScrollInfo .

Sintaxe

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

Parâmetros

[in] hWnd

Tipo: HWND

Manipule para um controle de barra de rolagem ou uma janela com uma barra de rolagem padrão, dependendo do valor do parâmetro nBar .

[in] nBar

Tipo: int

Especifica a barra de rolagem da qual as posições são recuperadas. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
SB_CTL	Recupera as posições de um controle de barra de rolagem. O parâmetro hWnd deve ser o identificador para o controle de barra de rolagem.
SB_HORZ	Recupera as posições da barra de rolagem horizontal padrão da janela.
SB_VERT	Recupera as posições da barra de rolagem vertical padrão da janela.

[out] lpMinPos

Tipo: LPINT

Ponteiro para a variável de inteiro que recebe a posição mínima.

[out] lpMaxPos

Tipo: LPINT

Ponteiro para a variável de inteiro que recebe a posição máxima.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se a janela especificada não tiver barras de rolagem padrão ou não for um controle de barra de rolagem, a função GetScrollRange copiará zero para os parâmetros lpMinPos e lpMaxPos .

O intervalo padrão para uma barra de rolagem padrão é de 0 a 100. O intervalo padrão para um controle de barra de rolagem está vazio (ambos os valores são zero).

As mensagens que indicam a posição da barra de rolagem, WM_HSCROLL e WM_VSCROLL, são limitadas a 16 bits de dados de posição. No entanto, como SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos e GetScrollRange dão suporte a dados de posição da barra de rolagem de 32 bits, há uma maneira de contornar a barreira de 16 bits do WM_HSCROLL e WM_VSCROLL mensagens. Consulte a função GetScrollInfo para obter uma descrição da técnica.

Se o parâmetro nBar for SB_CTL e a janela especificada pelo parâmetro hWnd não for um controle de barra de rolagem do sistema, o sistema enviará a mensagem SBM_GETRANGE para a janela para obter informações da barra de rolagem. Isso permite que GetScrollRange opere em um controle personalizado que imita uma barra de rolagem. Se a janela não manipular a mensagem SBM_GETRANGE , a função GetScrollRange falhará.

Requisitos


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	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll