Microsoft KB Archive/24646

From BetaArchive Wiki
< Microsoft KB Archive
Revision as of 08:59, 21 July 2020 by X010 (talk | contribs) (Text replacement - "<" to "<")

HOWTO: Create Captions for Dialog List Boxes


The information in this article applies to:

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


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.


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),
           for (i = 0; i < CSTR; i++) {
               LoadString(hInstTemplate, IDSSTR1+i, (LPSTR)szWaters, 12);
               SendDlgItemMessage(hWndDlg, IDDLISTBOX, LB_ADDSTRING, 0,
           SendDlgItemMessage(hWndDlg, IDDLISTBOX, LB_SETCURSEL, iSel, 0L);
           return TRUE;
       case WM_COMMAND:

Additional query words:

Keywords : kbCtrl kbListBox kbOSWinNT kbGrpDSUser kbOSWin
Issue type : kbhowto
Technology : kbWin32SDKSearch kbAudDeveloper kbSDKSearch kbWin32sSearch kbWinSDKSearch

Last Reviewed: July 15, 1999
© 2001 Microsoft Corporation. All rights reserved. Terms of Use.