Como rolar texto

Artigo
02/14/2024

Esta seção descreve as alterações que você pode fazer no procedimento da janela principal de um aplicativo para permitir que um usuário role o texto. O exemplo nesta seção cria e exibe uma matriz de cadeias de caracteres de texto e processa WM_HSCROLL e WM_VSCROLL mensagens da barra de rolagem para que o usuário possa rolar o texto vertical e horizontalmente.

O que você precisa saber

Tecnologias

Controles do Windows

Pré-requisitos

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

Instruções

Processando a mensagem WM_CREATE

As unidades de rolagem são normalmente definidas durante o processamento da mensagem WM_CREATE. É conveniente basear as unidades de rolagem nas dimensões da fonte associada ao contexto do dispositivo (DC) da janela. Para recuperar as dimensões da fonte para um controlador de domínio específico, use a função GetTextMetrics.

No exemplo desta seção, uma unidade de rolagem vertical é equivalente à altura de uma célula de caractere, além de entrelinha externa. Uma unidade de rolagem horizontal é equivalente à largura média de uma célula de caractere. As posições de rolagem horizontal, portanto, não correspondem aos caracteres reais, a menos que a fonte da tela seja de largura fixa.

Processando a mensagem WM_SIZE

Ao processar a mensagem WM_SIZE, é conveniente ajustar o intervalo de rolagem e a posição de rolagem para refletir as dimensões da área do cliente, bem como o número de linhas de texto que serão exibidas.

A função SetScrollInfo define os valores de posição mínima e máxima, o tamanho da página e a posição de rolagem para uma barra de rolagem.

Processando as mensagens WM_HSCROLL e WM_VSCROLL

A barra de rolagem envia mensagens de WM_HSCROLL e WM_VSCROLL para o procedimento de janela sempre que o usuário clica na barra de rolagem ou arrasta a caixa de rolagem. As palavras de ordem baixa de WM_VSCROLL e WM_HSCROLL contêm um código de solicitação que indica a direção e a magnitude da ação de rolagem.

Quando as mensagens WM_HSCROLL e WM_VSCROLL são processadas, o código de solicitação de barra de rolagem é examinado e o incremento de rolagem é calculado. Depois que o incremento é aplicado à posição de rolagem atual, a janela é rolada para a nova posição usando a função ScrollWindowEx e a posição da caixa de rolagem é ajustada usando a função SetScrollInfo.

Depois que uma janela é rolada, parte de sua área de cliente é tornada inválida. Para garantir que a região inválida seja atualizada, a função UpdateWindow é usada para gerar uma mensagem WM_PAINT.

Processando a mensagem WM_PAINT

Ao processar a mensagem WM_PAINT , é conveniente desenhar as linhas de texto que você deseja que apareçam na parte inválida da janela. O exemplo a seguir usa a posição de rolagem atual e as dimensões da região inválida para determinar o intervalo de linhas dentro da região inválida para exibi-las.

Exemplo de rolagem de texto

O exemplo a seguir é um procedimento de janela para uma janela que exibe texto em sua área de cliente. O exemplo demonstra como rolar o texto em resposta à entrada das barras de rolagem horizontal e vertical.

#include "strsafe.h"

LRESULT CALLBACK MyTextWindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
HDC hdc; 
PAINTSTRUCT ps; 
TEXTMETRIC tm; 
SCROLLINFO si; 
 
// These variables are required to display text. 
static int xClient;     // width of client area 
static int yClient;     // height of client area 
static int xClientMax;  // maximum width of client area 
 
static int xChar;       // horizontal scrolling unit 
static int yChar;       // vertical scrolling unit 
static int xUpper;      // average width of uppercase letters 
 
static int xPos;        // current horizontal scrolling position 
static int yPos;        // current vertical scrolling position 
 
int i;                  // loop counter 
int x, y;               // horizontal and vertical coordinates
 
int FirstLine;          // first line in the invalidated area 
int LastLine;           // last line in the invalidated area 
HRESULT hr;
size_t abcLength;        // length of an abc[] item 

// Create an array of lines to display. 
#define LINES 28 
static TCHAR *abc[] = { 
       TEXT("anteater"),  TEXT("bear"),      TEXT("cougar"), 
       TEXT("dingo"),     TEXT("elephant"),  TEXT("falcon"), 
       TEXT("gazelle"),   TEXT("hyena"),     TEXT("iguana"), 
       TEXT("jackal"),    TEXT("kangaroo"),  TEXT("llama"), 
       TEXT("moose"),     TEXT("newt"),      TEXT("octopus"), 
       TEXT("penguin"),   TEXT("quail"),     TEXT("rat"), 
       TEXT("squid"),     TEXT("tortoise"),  TEXT("urus"), 
       TEXT("vole"),      TEXT("walrus"),    TEXT("xylophone"), 
       TEXT("yak"),       TEXT("zebra"),
       TEXT("This line contains words, but no character. Go figure."),
       TEXT("")
     }; 
 
switch (uMsg) 
{ 
    case WM_CREATE : 
        // Get the handle to the client area's device context. 
        hdc = GetDC (hwnd); 
 
        // Extract font dimensions from the text metrics. 
        GetTextMetrics (hdc, &tm); 
        xChar = tm.tmAveCharWidth; 
        xUpper = (tm.tmPitchAndFamily & 1 ? 3 : 2) * xChar/2; 
        yChar = tm.tmHeight + tm.tmExternalLeading; 
 
        // Free the device context. 
        ReleaseDC (hwnd, hdc); 
 
        // Set an arbitrary maximum width for client area. 
        // (xClientMax is the sum of the widths of 48 average 
        // lowercase letters and 12 uppercase letters.) 
        xClientMax = 48 * xChar + 12 * xUpper; 
 
        return 0; 
 
    case WM_SIZE: 
 
        // Retrieve the dimensions of the client area. 
        yClient = HIWORD (lParam); 
        xClient = LOWORD (lParam); 
 
        // Set the vertical scrolling range and page size
        si.cbSize = sizeof(si); 
        si.fMask  = SIF_RANGE | SIF_PAGE; 
        si.nMin   = 0; 
        si.nMax   = LINES - 1; 
        si.nPage  = yClient / yChar; 
        SetScrollInfo(hwnd, SB_VERT, &si, TRUE); 
 
        // Set the horizontal scrolling range and page size. 
        si.cbSize = sizeof(si); 
        si.fMask  = SIF_RANGE | SIF_PAGE; 
        si.nMin   = 0; 
        si.nMax   = 2 + xClientMax / xChar; 
        si.nPage  = xClient / xChar; 
        SetScrollInfo(hwnd, SB_HORZ, &si, TRUE); 
 
        return 0; 
    case WM_HSCROLL:
        // Get all the vertial scroll bar information.
        si.cbSize = sizeof (si);
        si.fMask  = SIF_ALL;

        // Save the position for comparison later on.
        GetScrollInfo (hwnd, SB_HORZ, &si);
        xPos = si.nPos;
        switch (LOWORD (wParam))
        {
        // User clicked the left arrow.
        case SB_LINELEFT: 
            si.nPos -= 1;
            break;
              
        // User clicked the right arrow.
        case SB_LINERIGHT: 
            si.nPos += 1;
            break;
              
        // User clicked the scroll bar shaft left of the scroll box.
        case SB_PAGELEFT:
            si.nPos -= si.nPage;
            break;
              
        // User clicked the scroll bar shaft right of the scroll box.
        case SB_PAGERIGHT:
            si.nPos += si.nPage;
            break;
              
        // User dragged the scroll box.
        case SB_THUMBTRACK: 
            si.nPos = si.nTrackPos;
            break;
              
        default :
            break;
        }

        // Set the position and then retrieve it.  Due to adjustments
        // by Windows it may not be the same as the value set.
        si.fMask = SIF_POS;
        SetScrollInfo (hwnd, SB_HORZ, &si, TRUE);
        GetScrollInfo (hwnd, SB_HORZ, &si);
         
        // If the position has changed, scroll the window.
        if (si.nPos != xPos)
        {
            ScrollWindow(hwnd, xChar * (xPos - si.nPos), 0, NULL, NULL);
        }

        return 0;
         
    case WM_VSCROLL:
        // Get all the vertial scroll bar information.
        si.cbSize = sizeof (si);
        si.fMask  = SIF_ALL;
        GetScrollInfo (hwnd, SB_VERT, &si);

        // Save the position for comparison later on.
        yPos = si.nPos;
        switch (LOWORD (wParam))
        {

        // User clicked the HOME keyboard key.
        case SB_TOP:
            si.nPos = si.nMin;
            break;
              
        // User clicked the END keyboard key.
        case SB_BOTTOM:
            si.nPos = si.nMax;
            break;
              
        // User clicked the top arrow.
        case SB_LINEUP:
            si.nPos -= 1;
            break;
              
        // User clicked the bottom arrow.
        case SB_LINEDOWN:
            si.nPos += 1;
            break;
              
        // User clicked the scroll bar shaft above the scroll box.
        case SB_PAGEUP:
            si.nPos -= si.nPage;
            break;
              
        // User clicked the scroll bar shaft below the scroll box.
        case SB_PAGEDOWN:
            si.nPos += si.nPage;
            break;
              
        // User dragged the scroll box.
        case SB_THUMBTRACK:
            si.nPos = si.nTrackPos;
            break;
              
        default:
            break; 
        }

        // Set the position and then retrieve it.  Due to adjustments
        // by Windows it may not be the same as the value set.
        si.fMask = SIF_POS;
        SetScrollInfo (hwnd, SB_VERT, &si, TRUE);
        GetScrollInfo (hwnd, SB_VERT, &si);

        // If the position has changed, scroll window and update it.
        if (si.nPos != yPos)
        {                    
            ScrollWindow(hwnd, 0, yChar * (yPos - si.nPos), NULL, NULL);
            UpdateWindow (hwnd);
        }

        return 0;
         
    case WM_PAINT :
        // Prepare the window for painting.
        hdc = BeginPaint (hwnd, &ps);

        // Get vertical scroll bar position.
        si.cbSize = sizeof (si);
        si.fMask  = SIF_POS;
        GetScrollInfo (hwnd, SB_VERT, &si);
        yPos = si.nPos;

        // Get horizontal scroll bar position.
        GetScrollInfo (hwnd, SB_HORZ, &si);
        xPos = si.nPos;

        // Find painting limits.
        FirstLine = max (0, yPos + ps.rcPaint.top / yChar);
        LastLine = min (LINES - 1, yPos + ps.rcPaint.bottom / yChar);
         
        for (i = FirstLine; i <= LastLine; i++)
        {
            x = xChar * (1 - xPos);
            y = yChar * (i - yPos);
              
            // Note that "55" in the following depends on the 
            // maximum size of an abc[] item. Also, you must include
            // strsafe.h to use the StringCchLength function.
            hr = StringCchLength(abc[i], 55, &abcLength);
            if ((FAILED(hr))|(abcLength == NULL))
            {
                //
                // TODO: write error handler
                //
            }

            // Write a line of text to the client area.
            TextOut(hdc, x, y, abc[i], abcLength); 
        }

        // Indicate that painting is finished.
        EndPaint (hwnd, &ps);
        return 0;
         
    case WM_DESTROY :
        PostQuitMessage (0);
        return 0;
    }

    return DefWindowProc (hwnd, uMsg, wParam, lParam);
}

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

Compartilhar via

Como rolar texto

O que você precisa saber

Tecnologias

Pré-requisitos

Instruções

Processando a mensagem WM_CREATE

Processando a mensagem WM_SIZE

Processando as mensagens WM_HSCROLL e WM_VSCROLL

Processando a mensagem WM_PAINT

Exemplo de rolagem de texto

Comentários

Recursos adicionais

Compartilhar via

Como rolar texto

O que você precisa saber

Tecnologias

Pré-requisitos

Instruções

Processando a mensagem WM_CREATE

Processando a mensagem WM_SIZE

Processando as mensagens WM_HSCROLL e WM_VSCROLL

Processando a mensagem WM_PAINT

Exemplo de rolagem de texto

Tópicos relacionados

Comentários

Recursos adicionais