Como criar barras de rolagem

  • Artigo

Ao criar uma janela sobreposta, pop-up ou filho, você pode adicionar barras de rolagem padrão usando a função CreateWindowEx e especificando WS_HSCROLL, WS_VSCROLL ou ambos os estilos.

O que você precisa saber

Tecnologias

Pré-requisitos

  • C/C++
  • Programação da interface do usuário do Windows

Instruções

Criar uma barra de rolagem

O exemplo a seguir cria uma janela com barras de rolagem horizontais e verticais padrão.

    hwnd = CreateWindowEx( 
        0,                     // no extended styles 
        g_szWindowClass,       // global string containing name of window class
        g_szTitle,             // global string containing title bar text 
        WS_OVERLAPPEDWINDOW |  
            WS_HSCROLL | WS_VSCROLL, // window styles 
        CW_USEDEFAULT,         // default horizontal position 
        CW_USEDEFAULT,         // default vertical position 
        CW_USEDEFAULT,         // default width 
        CW_USEDEFAULT,         // default height 
        (HWND) NULL,           // no parent for overlapped windows 
        (HMENU) NULL,          // use the window class menu 
        g_hInst,               // global instance handle  
        (PVOID) NULL           // pointer not needed 
    );

Para processar mensagens da barra de rolagem para essas barras de rolagem, você deve incluir o código apropriado no procedimento da janela principal.

Você pode usar a função CreateWindowEx para criar uma barra de rolagem especificando a classe de janela SCROLLBAR. Isso cria uma barra de rolagem horizontal ou vertical, dependendo se SBS_HORZ ou SBS_VERT é especificado como o estilo da janela. O tamanho da barra de rolagem e sua posição em relação à janela pai também podem ser especificados.

O exemplo a seguir cria uma barra de rolagem horizontal que é posicionada ao longo da parte inferior da área do cliente da janela pai.

// Description:
//   Creates a horizontal scroll bar along the bottom of the parent 
//   window's area.
// Parameters:
//   hwndParent - handle to the parent window.
//   sbHeight - height, in pixels, of the scroll bar.
// Returns:
//   The handle to the scroll bar.
HWND CreateAHorizontalScrollBar(HWND hwndParent, int sbHeight)
{
    RECT rect;

    // Get the dimensions of the parent window's client area;
    if (!GetClientRect(hwndParent, &rect))
        return NULL;

    // Create the scroll bar.
    return (CreateWindowEx( 
            0,                      // no extended styles 
            L"SCROLLBAR",           // scroll bar control class 
            (PTSTR) NULL,           // no window text 
            WS_CHILD | WS_VISIBLE   // window styles  
                | SBS_HORZ,         // horizontal scroll bar style 
            rect.left,              // horizontal position 
            rect.bottom - sbHeight, // vertical position 
            rect.right,             // width of the scroll bar 
            sbHeight,               // height of the scroll bar
            hwndParent,             // handle to main window 
            (HMENU) NULL,           // no menu 
            g_hInst,                // instance owning this window 
            (PVOID) NULL            // pointer not needed 
        )); 
}

Usando barras de rolagem

Demonstração de controles comuns do Windows (CppWindowsCommonControls)