GetScrollInfo

O GetScrollInfo função recupera os parâmetros de um barra de rolagem, incluindo o mínimo e máxima posições de rolagem, tamanho de página e a posição do caixa de rolagem (polegar).

(BOOL GetScrollInfo HWND  hwnd, / / identificador para janela com barra de rolagemintfnBar, / / scroll barra bandeiraLPSCROLLINFOlpsi / / ponteiro para estrutura para parâmetros de rolagem);
 

Parâmetros

hwnd
Identificador para um Controlarar de barra de rolagem ou uma janela com uma padrão barra de rolagem, depending on o valor do parâmetro fnBar.
fnBar
Especifica o tipo de barra de rolagem para o qual recuperar parâmetros. Este parâmetro pode ser uma dos seguinte valores:
Valor Significado
SB_CTL Recupera os parâmetros para um controle de barra de rolagem. O parâmetro de hwnd deve ser o identificador para o Controlarar de barra de rolagem.
SB_HORZ Recupera os parâmetros para a barra de rolagem horizontal padrão da janela determinado.
SB_VERT Recupera os parâmetros para a barra de rolagem vertical padrão da janela determinado.

lpsi
Ponteiro para uma estrutura SCROLLINFO . Antes chamado GetScrollInfo, defina o cbSize membro da estrutura para sizeof(SCROLLINFO) e defina o fMask membro para especificar os parâmetros barra de rolagem para recuperar. Antes de retornar, a função copia os parâmetros especificados para o apropriado membros da estrutura.

O fMask membro pode ser uma combinação dos seguintes valores:
Valor Significado
SIF_PAGE Copia a página de rolagem para a nPage membro das SCROLLINFO estrutura apontada pelo lpsi.
SIF_POS Copia a posição de rolagem para o nPos membro das SCROLLINFO estrutura apontada pelo lpsi.
SIF_RANGE Copia o intervalo de rolagem para a nMin e nMax Os Membros das SCROLLINFO estrutura apontada pelo lpsi.
SIF_TRACKPOS Cópias da caixa de rolagem atual rastreamento posição para o nTrackPos membro das SCROLLINFO estrutura apontada pelo lpsi.

Retornar valores

Se a função recuperada quaisquer valores, o valor de retorno é diferente de zero.

Se a função não recuperar quaisquer valores, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

O GetScrollInfo função permite que aplicativos usar posições de rolagem 32 bits. Embora as mensagens que indicam posição barra de rolagem, WM_HSCROLL e WM_VSCROLL, fornecem apenas 16 bits de dados posição, as funções SetScrollInfo e GetScrollInfo fornecer 32 bits de rolagem-barra posição dados. Assim, um aplicativo pode chamar GetScrollInfo ao processamento do WM_HSCROLL ou WM_VSCROLL mensagens para obter 32-bit rolagem-barra posição dados.

Para get de 32-bit posição da caixa de rolagem (polegar) durante uma notificação de SB_THUMBTRACK em uma mensagem WM_HSCROLL ou WM_VSCROLL, chame GetScrollInfo com o valor SIF_TRACKPOS in a fMask membro das SCROLLINFO estrutura. A função retorna o rastreamento posição do caixa de rolagem na nTrackPos membro das SCROLLINFO estrutura. Isso permite que você obter a posição do caixa de rolagem enquanto o usuário se move-lo. O exemplo de código a seguir ilustra a técnica.

Si SCROLLINFO;
caso WM_HSCROLL:
    Switch(LOWORD(wParam)) {
        caso SB_THUMBTRACK:
          / / Inicializar a estrutura SCROLLINFO
 
            ZeroMemory (amp; si, sizeof(SCROLLINFO));
            si.cbSize = sizeof (SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / Chamar GetScrollInfo para obter atual rastreamento / / posição no si.nTrackPos
 
            if (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                retornar 1; / / GetScrollInfo falhou
            quebra;
        .
        .
        .
    } 

QuickInfo

nbsp; Windows &NT: requer versão 3.51 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Rolar visão geral barras, barra de rolagem funciona, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index