HOWTO: Create Captions for Dialog List Boxes

• Microsoft Windows Software Development Kit (SDK)
• Microsoft Win32 Software Development Kit (SDK)

SUMMARY

To place text into the caption bar specified for a list box, use the SetWindowText() function. First, use GetDlgItem() to get the handle of the list box, then call SetWindowText() to set the list box caption.

MORE INFORMATION

The following code fragment illustrates the necessary steps. NOTE: The list box includes the WS_CAPTION window style:

   ...
   BOOL FAR PASCAL TemplateDlg(hWndDlg, message, wParam, lParam)
   ...
       switch (message)
        {
       case WM_INITDIALOG:
           ...
           /* The following line sets the Listbox caption */ 
           SetWindowText( GetDlgItem(hWndDlg, IDDLISTBOX),
                          (LPSTR)"Caption");
           for (i = 0; i < CSTR; i++) {
               LoadString(hInstTemplate, IDSSTR1+i, (LPSTR)szWaters, 12);
               SendDlgItemMessage(hWndDlg, IDDLISTBOX, LB_ADDSTRING, 0,
                   (LONG)(LPSTR)szWaters);
               }
           SendDlgItemMessage(hWndDlg, IDDLISTBOX, LB_SETCURSEL, iSel, 0L);
           ...
           return TRUE;
       case WM_COMMAND:
   ... 

Additional query words:

Keywords          : kbCtrl kbListBox kbNTOS kbGrpUser kbWinOS 
Version           : WINDOWS:
Platform          : WINDOWS 
Issue type        : kbhowto 

Last Reviewed: July 13, 1999