Прокрутка текста

Статья
02/14/2024

В этом разделе описываются изменения, которые можно внести в основную процедуру окна приложения, чтобы пользователь мог прокручивать текст. Пример в этом разделе создает и отображает массив текстовых строк, а также обрабатывает WM_HSCROLL и WM_VSCROLL сообщения полосы прокрутки, чтобы пользователь смог прокручивать текст как по вертикали, так и по горизонтали.

Это важно знать

Технологии

Элементы управления Windows

Необходимые компоненты

C/C++
Программирование пользовательского интерфейса Windows

Instructions

Обработка сообщения WM_CREATE

Единицы прокрутки обычно задаются при обработке сообщения WM_CREATE . Удобно основывать единицы прокрутки на измерениях шрифта, связанного с контекстом устройства окна (DC). Чтобы получить измерения шрифта для определенного контроллера домена, используйте функцию GetTextMetrics .

В этом разделе один блок прокрутки по вертикали эквивалентен высоте ячейки символов, а также внешнему началу. Одна единица горизонтальной прокрутки эквивалентна средней ширине ячейки символов. Таким образом, позиции горизонтальной прокрутки не соответствуют фактическим символам, если шрифт экрана не имеет фиксированной ширины.

Обработка сообщения WM_SIZE

При обработке сообщения WM_SIZE удобно настроить диапазон прокрутки и положение прокрутки, чтобы отразить размеры клиентской области, а также количество отображаемых строк текста.

Функция SetScrollInfo задает минимальные и максимальные значения позиции, размер страницы и положение прокрутки для полосы прокрутки.

Обработка сообщений WM_HSCROLL и WM_VSCROLL

Полоса прокрутки отправляет WM_HSCROLL и WM_VSCROLL сообщения в процедуру окна всякий раз, когда пользователь щелкает полосу прокрутки или перетаскивает окно прокрутки. Слова с низким порядком WM_VSCROLL и WM_HSCROLL содержат код запроса, указывающий направление и величину действия прокрутки.

При обработке WM_HSCROLL и WM_VSCROLL сообщений код запроса на полосу прокрутки проверяется и вычисляется увеличение прокрутки. После применения приращения к текущей позиции прокрутки окно прокручивается до новой позиции с помощью функции ScrollWindowEx, а положение поля прокрутки настраивается с помощью функции SetScrollInfo.

После прокрутки окна часть клиентской области становится недопустимой. Чтобы убедиться, что недопустимый регион обновлен, функция UpdateWindow используется для создания сообщения WM_PAINT.

Обработка сообщения WM_PAINT

При обработке сообщения WM_PAINT удобно нарисовать строки текста, которые нужно отображать в недопустимой части окна. В следующем примере используется текущая позиция прокрутки и размеры недопустимого региона для определения диапазона строк в недопустимом регионе для их отображения.

Пример прокрутки текста

В следующем примере показана процедура окна для окна, отображающего текст в клиентской области. В примере показано, как прокручивать текст в ответ на входные данные из горизонтальных и вертикальных полос прокрутки.

#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);
}

Использование полос прокрутки
Демонстрация общих элементов управления Windows (CppWindowsCommonControls)

Поделиться через

Прокрутка текста

Это важно знать

Технологии

Необходимые компоненты

Instructions

Обработка сообщения WM_CREATE

Обработка сообщения WM_SIZE

Обработка сообщений WM_HSCROLL и WM_VSCROLL

Обработка сообщения WM_PAINT

Пример прокрутки текста

Обратная связь

Дополнительные ресурсы

Поделиться через

Прокрутка текста

Это важно знать

Технологии

Необходимые компоненты

Instructions

Обработка сообщения WM_CREATE

Обработка сообщения WM_SIZE

Обработка сообщений WM_HSCROLL и WM_VSCROLL

Обработка сообщения WM_PAINT

Пример прокрутки текста

См. также

Обратная связь

Дополнительные ресурсы