CWnd::GetScrollInfo

Artigo
06/10/2015

Chamar essa função de membro para recuperar informações que a estrutura de SCROLLINFO mantém sobre um barra de rolagem.

BOOL GetScrollInfo( 
   int nBar, 
   LPSCROLLINFO lpScrollInfo, 
   UINT nMask = SIF_ALL  
);

Parâmetros

nBar
Especifica se a barra de rolagem é um controle ou uma parte da área de nonclient de uma janela. Se é parte da área de nonclient, nBar também indica se a barra de rolagem é posicionado horizontalmente, verticalmente, ou ambos. Deve ser um dos seguintes:
- SB_CTL recupera os parâmetros para o controle de barra de rolagem. O membro de dados de m_hWnd deve ser o identificador do controle de barra de rolagem.
- SB_HORZ recupera os parâmetros para a barra de rolagem horizontal padrão da janela.
- SB_VERT recupera os parâmetros para a barra de rolagem vertical padrão da janela.
lpScrollInfo
Um ponteiro a estrutura de SCROLLINFO . Consulte Windows SDK para obter mais informações sobre essa estrutura.
nMask
Especifica os parâmetros de barra de rolagem para recuperar. a opção especifica uma combinação de SIF_PAGE, de SIF_POS, de SIF_TRACKPOS, e de SIF_RANGE. Consulte SCROLLINFO para obter mais informações sobre os valores de nMask .

Valor de retorno

Se a mensagem recuperou os valores, o retorno é Verdadeiro. Caso contrário, é Falso.

Comentários

GetScrollInfo permite que aplicativos usar posições de 32 bits de rolagem.

A estrutura de SCROLLINFO contém informações sobre uma barra de rolagem, incluindo as posições de rolagem mínimo e máximo de, o tamanho da página, e a posição da caixa de rolagem (o thumb). Consulte o tópico de estrutura de SCROLLINFO em Windows SDK para obter mais informações sobre como alterar as opções de estrutura.

Os manipuladores de mensagens do windows MFC que indica a posição, o CWnd::OnHScroll e o CWnd::OnVScrollde barra de rolagem, fornecem apenas 16 bits de dados de posição. GetScrollInfo e fornecem SetScrollInfo 32 bits de dados da posição de barra de rolagem. Assim, um aplicativo pode chamar GetScrollInfo ao processar CWnd::OnHScroll ou CWnd::OnVScroll para obter a barra de rolagem de 32 bits posicionar dados.