Comment créer une zone de liste Owner-Drawn
Cette rubrique montre comment implémenter une zone de liste dessinée par le propriétaire.
L’exemple de code C++ de cette rubrique montre comment dessiner une zone de liste qui contient cinq éléments dessinés par le propriétaire : quatre implémentations de dessin et une duplication. Chaque élément de liste s’affiche sous la forme d’une bitmap suivie du nom de l’objet. Un bouton invite l’utilisateur à sélectionner un élément qui n’est pas comme les autres. Le choix du bouton avec la duplication sélectionnée affiche un message « Vous avez raison ! » et ferme la boîte de dialogue. Le fait de choisir le bouton avec tout autre élément de liste sélectionné affiche un message « Réessayez ! ».
La zone de liste a les styles LBS_OWNERDRAWFIXED et LBS_HASSTRINGS , en plus des styles de zone de liste standard.
Bon à savoir
Technologies
Prérequis
- C/C++
- Programmation de l’interface utilisateur Windows
Instructions
Pour initialiser une zone de liste dessinée par le propriétaire, votre application doit charger la chaîne de texte et l’image bitmap associée pour chaque élément de zone de liste.
Dans l’exemple de code C++ suivant, la procédure de boîte de dialogue initialise la zone de liste, IDC_LIST_STUFF, en envoyant le message LB_ADDSTRING pour définir le texte, puis envoie le message LB_SETITEMDATA pour associer un bitmap à chaque élément de zone de liste. Le code définit également la hauteur de chaque élément de zone de liste en traitant le message WM_MEASUREITEM et dessine le texte et l’image bitmap de chaque élément en traitant le WM_DRAWITEM message.
#define XBITMAP 48
#define YBITMAP 48
#define BUFFER MAX_PATH
HBITMAP hbmpPencil, hbmpCrayon, hbmpMarker, hbmpPen, hbmpFork;
HBITMAP hbmpPicture, hbmpOld;
void AddItem(HWND hwnd, PTSTR pstr, HBITMAP hbmp)
{
int lbItem;
lbItem = SendMessage(hwnd, LB_ADDSTRING, 0, (LPARAM)pstr);
SendMessage(hwnd, LB_SETITEMDATA, (WPARAM)lbItem, (LPARAM)hbmp);
}
INT_PTR CALLBACK DlgDrawProc(HWND hDlg, UINT message,
UINT wParam, LONG lParam)
{
HWND hListBox;
PMEASUREITEMSTRUCT pmis;
PDRAWITEMSTRUCT pdis;
HDC hdcMem;
HBITMAP hbmp;
TCHAR achBuffer[BUFFER];
size_t cch;
int yPos;
int lbItem;
TEXTMETRIC tm;
RECT rcBitmap;
HRESULT hr;
switch (message)
{
case WM_INITDIALOG:
// Load the bitmaps. g_hInst is the global HINSTANCE handle.
hbmpPencil = LoadBitmap(g_hInst, MAKEINTRESOURCE(IDB_PENCIL));
hbmpCrayon = LoadBitmap(g_hInst, MAKEINTRESOURCE(IDB_CRAYON));
hbmpMarker = LoadBitmap(g_hInst, MAKEINTRESOURCE(IDB_MARKER));
hbmpPen = LoadBitmap(g_hInst, MAKEINTRESOURCE(IDB_PEN));
hbmpFork = LoadBitmap(g_hInst, MAKEINTRESOURCE(IDB_FORK));
// Retrieve the list box handle.
hListBox = GetDlgItem(hDlg, IDC_LIST_STUFF);
// Initialize the list box text and associate a bitmap
// with each list box item.
AddItem(hListBox, L"pencil", hbmpPencil);
AddItem(hListBox, L"crayon", hbmpCrayon);
AddItem(hListBox, L"marker", hbmpMarker);
AddItem(hListBox, L"pen", hbmpPen);
AddItem(hListBox, L"fork", hbmpFork);
SetFocus(hListBox);
SendMessage(hListBox, LB_SETCURSEL, 0, 0);
return TRUE;
case WM_MEASUREITEM:
pmis = (PMEASUREITEMSTRUCT) lParam;
// Set the height of the list box items.
pmis->itemHeight = YBITMAP;
return TRUE;
case WM_DRAWITEM:
pdis = (PDRAWITEMSTRUCT) lParam;
// If there are no list box items, skip this message.
if (pdis->itemID == -1)
{
break;
}
// Draw the bitmap and text for the list box item. Draw a
// rectangle around the bitmap if it is selected.
switch (pdis->itemAction)
{
case ODA_SELECT:
case ODA_DRAWENTIRE:
// Draw the bitmap associated with the item.
//
// Get the item bitmap.
hbmpPicture = (HBITMAP)SendMessage(pdis->hwndItem,
LB_GETITEMDATA, pdis->itemID, 0);
// Create a compatible device context.
hdcMem = CreateCompatibleDC(pdis->hDC);
// Select the item bitmap into the compatible device
// context and save the old bitmap.
hbmpOld = (HBITMAP) SelectObject(hdcMem, hbmpPicture);
// Copy the bitmap into the compatible device context.
BitBlt(pdis->hDC,
pdis->rcItem.left, pdis->rcItem.top,
pdis->rcItem.right - pdis->rcItem.left,
pdis->rcItem.bottom - pdis->rcItem.top,
hdcMem, 0, 0, SRCCOPY);
// Draw the string associated with the item.
//
// Get the item string from the list box.
SendMessage(pdis->hwndItem, LB_GETTEXT,
pdis->itemID, (LPARAM)achBuffer);
// Get the metrics for the current font.
GetTextMetrics(pdis->hDC, &tm);
// Calculate the vertical position for the item string
// so that the string will be vertically centered in the
// item rectangle.
yPos = (pdis->rcItem.bottom + pdis->rcItem.top -
tm.tmHeight) / 2;
// Get the character length of the item string.
hr = StringCchLength(achBuffer, BUFFER, &cch);
if (FAILED(hr))
{
// TODO: Handle error.
}
// Draw the string in the item rectangle, leaving a six
// pixel gap between the item bitmap and the string.
TextOut(pdis->hDC, XBITMAP + 6, yPos, achBuffer, cch);
// Clean up.
SelectObject(hdcMem, hbmpOld);
DeleteDC(hdcMem);
// Is the item selected?
if (pdis->itemState & ODS_SELECTED)
{
// Set RECT coordinates to surround only the
// bitmap.
rcBitmap.left = pdis->rcItem.left;
rcBitmap.top = pdis->rcItem.top;
rcBitmap.right = pdis->rcItem.left + XBITMAP;
rcBitmap.bottom = pdis->rcItem.top + YBITMAP;
// Draw a rectangle around bitmap to indicate
// the selection.
DrawFocusRect(pdis->hDC, &rcBitmap);
}
break;
case ODA_FOCUS:
// Do not process focus changes. The focus caret
// (outline rectangle) indicates the selection.
// The IDOK button indicates the final
// selection.
break;
}
return TRUE;
case WM_COMMAND:
switch (LOWORD(wParam))
{
case IDOK:
// Get the selected item's text.
lbItem = SendMessage(GetDlgItem(hDlg, IDC_LIST_STUFF),
LB_GETCURSEL, 0, 0);
// Get the selected item's bitmap.
hbmp = (HBITMAP) SendMessage(GetDlgItem(hDlg, IDC_LIST_STUFF),
LB_GETITEMDATA, lbItem, 0);
// If the item is not the correct answer, tell the
// user to try again.
//
// If the item is the correct answer, congratulate
// the user and destroy the dialog box.
if (hbmp != hbmpFork)
{
MessageBox(hDlg, L"Try again!", L"Oops", MB_OK);
return FALSE;
}
else
{
MessageBox(hDlg, L"You're right!",
L"Congratulations.", MB_OK);
// Fall through.
}
case IDCANCEL:
// Destroy the dialog box.
EndDialog(hDlg, TRUE);
return TRUE;
default:
return FALSE;
}
case WM_DESTROY:
// Free the bitmap resources.
DeleteObject(hbmpPencil);
DeleteObject(hbmpCrayon);
DeleteObject(hbmpMarker);
DeleteObject(hbmpPen);
DeleteObject(hbmpFork);
return TRUE;
default:
return FALSE;
}
return FALSE;
}
Rubriques connexes