Szöveg görgetése
Ez a szakasz azokat a módosításokat ismerteti, amelyek az alkalmazás főablakában módosíthatók, hogy a felhasználó görgethesse a szöveget. Ebben a szakaszban a példa szövegsztringek tömbjeit hozza létre és jeleníti meg, és feldolgozza WM_HSCROLL és WM_VSCROLL görgetősáv-üzeneteket, hogy a felhasználó függőlegesen és vízszintesen is görgethesse a szöveget.
Amit tudnia kell
Technológiák
Előfeltételek
- C/C++
- Windows felhasználói felület programozása
Előírás
A WM_CREATE üzenet feldolgozása
A görgetési egységek általában a WM_CREATE üzenet feldolgozása során vannak beállítva. A görgetőegységeket kényelmesen az ablak eszközkörnyezetéhez (DC) társított betűtípus méretére alapozhatja. Egy adott DC betűméreteinek lekéréséhez használja a GetTextMetrics függvényt.
Ebben a szakaszban a példában egy függőleges görgetőegység egyenértékű egy karaktercella magasságával, valamint a külső bevezetővel. Egy vízszintes görgetőegység egyenértékű egy karaktercella átlagos szélességével. A vízszintes görgetési pozíciók tehát nem felelnek meg a tényleges karaktereknek, kivéve, ha a képernyő betűtípusa rögzített szélességű.
A WM_SIZE üzenet feldolgozása
A WM_SIZE üzenet feldolgozásakor célszerű úgy beállítani a görgetési tartományt és a görgetési pozíciót, hogy az tükrözze az ügyfélterület méreteit, valamint a megjelenítendő szövegsorok számát.
A SetScrollInfo függvény beállítja a görgetősáv minimális és maximális pozícióértékét, az oldalméretet és a görgetési pozíciót.
A WM_HSCROLL és WM_VSCROLL üzenetek feldolgozása
A görgetősáv WM_HSCROLL és WM_VSCROLL üzeneteket küld az ablakműveletnek, amikor a felhasználó a görgetősávra kattint, vagy húzza a görgetődobozt. Az egyes WM_VSCROLL és WM_HSCROLL alacsonyrendű szavai egy kéréskódot tartalmaznak, amely a görgetési művelet irányát és mértékét jelzi.
A WM_HSCROLL és WM_VSCROLL üzenetek feldolgozásakor a rendszer megvizsgálja a görgetősáv kérési kódját, és kiszámítja a görgetési növekményt. Miután a növekményt az aktuális görgetési pozícióra alkalmazta, az ablak az ScrollWindowEx függvénnyel az új pozícióba kerül, a görgetőmező pozícióját pedig a SetScrollInfo függvénnyel módosíthatja.
Amikor egy ablakot görgetnek, annak kliens területének egy része érvénytelenné válik. Az érvénytelen régió frissítésének biztosítása érdekében a UpdateWindow függvényt használja egy WM_PAINT üzenet létrehozásához.
A WM_PAINT üzenet feldolgozása
A WM_PAINT üzenet feldolgozásakor kényelmesen megrajzolhatja az ablak érvénytelen részén megjeleníteni kívánt szövegsorokat. Az alábbi példa az aktuális görgetési pozíciót és az érvénytelen régió dimenzióit használja az érvénytelen régión belüli vonalak tartományának meghatározásához a megjelenítésükhöz.
Példa a szöveg görgetésére
Az alábbi példa egy ablakművelet, amely az ügyfélterületen szöveget jelenít meg. A példa bemutatja, hogyan görgetheti a szöveget a vízszintes és függőleges görgetősávok bemenetére válaszul.
#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);
}
Kapcsolódó témakörök