DLGTEMPLATE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure defines the dimensions and style of a dialog box. This structure, always the first in a dialog box template, also specifies the number of controls in the dialog box and therefore specifies the number of subsequent DLGITEMTEMPLATE structures in the template.

Syntax

typedef struct {
  DWORD style; 
  DWORD dwExtendedStyle; 
  WORD cdit; 
  short x; 
  short y; 
  short cx; 
  short cy; 
} DLGTEMPLATE; 

Members

• style
  Specifies the style of the dialog box. It can be a combination of window style values (such as WS_CAPTION) and one or more of the following dialog box style values.

  Value	Description
  DS_CENTER	Centers the dialog box in the working area; that is, the area not obscured by the tray
  DS_LOCALEDIT	Applies to 16-bit applications only. This style directs edit controls in the dialog box to allocate memory from the application data segment. Otherwise, edit controls allocate storage from a global memory object.
  DS_MODALFRAME	Creates a dialog box with a modal dialog-box frame that can be combined with a title bar and window menu by specifying the WS_CAPTION and WS_SYSMENU styles.
  DS_SETFONT	Indicates that the header of the dialog box template contains additional data specifying the font to use for text in the client area and controls of the dialog box. The font data begins on the WORD boundary that follows the title array. It specifies a 16-bit point size value and a Unicode font name string. If possible, the system creates a font according to the specified values. Then the system passes the handle of the font to the dialog box and to each control by sending them the WM_SETFONT message. If this style is not specified, the dialog box template does not include the font data. You cannot set the font inside dialog boxes in Windows CE 1.0 and 1.01, but you can in Windows CE 2.0 and later.
  DS_SETFOREGROUND	Causes the system to use the SetForegroundWindow function to bring the dialog box to the foreground.

• dwExtendedStyle
  Specifies extended styles for a window. This member is not used to create dialog boxes, but applications that use dialog box templates can use it to create other types of windows.

• cdit
  Specifies the number of items in the dialog box.

• x
  Specifies the x-coordinate, in dialog box units, of the upper-left corner of the dialog box.

• y
  Specifies the y-coordinate, in dialog box units, of the upper-left corner of the dialog box.

• cx
  Specifies the width, in dialog box units, of the dialog box.

• cy
  Specifies the height, in dialog box units, of the dialog box.

Remarks

To get default positioning, use the DS_CENTER style.

In a standard template for a dialog box, the DLGTEMPLATE structure is always immediately followed by three variable-length arrays that specify the menu, class, and title for the dialog box. When the DS_SETFONT style is given, these arrays are also followed by a 16-bit value specifying point size and another variable-length array specifying a typeface name. Each array consists of one or more 16-bit elements. The menu, class, title, and font arrays must be aligned on WORD boundaries.

Immediately following the DLGTEMPLATE structure is a menu array that, on Windows-based desktop platforms, identifies a menu resource for the dialog box. Windows Embedded CE, however, does not support the addition of menus to a dialog box.

Following the first array is a class array that identifies the window class of the control. If the first element of the array is 0x0000, the system uses the predefined dialog box class for the dialog box and the array has no other elements. If the first element is 0xFFFF, the array has one additional element that specifies the ordinal value of a predefined system window class. If the first element has any other value, the system treats the array as a null-terminated Unicode string that specifies the name of a registered window class.

Following the class array is a title array that specifies a null-terminated Unicode string that contains the title of the dialog box. If the first element of this array is 0x0000, the dialog box has no title and the array has no other elements.

The 16-bit point size value and the typeface array follow the title array, but only if the style member specifies the DS_SETFONT style. The point size value specifies the point size of the font to use for the text in the dialog box and its controls. The typeface array is a null-terminated Unicode string specifying the name of the typeface for the font. When these values are given, the system creates a font having the given size and typeface (if possible) and sends a WM_SETFONT message to the dialog box procedure and the control window procedures as it creates the dialog box and controls.

Following the DLGTEMPLATE header in a standard dialog box template are one or more DLGITEMTEMPLATE structures that define the dimensions and style of the controls in the dialog box. The cdit member specifies the number of DLGITEMTEMPLATE structures in the template. These DLGITEMTEMPLATE structures must be aligned on DWORD boundaries.

If you specify character strings in the class, title, or typeface arrays, you must use Unicode strings. Use the MultiByteToWideChar function to generate these Unicode strings.

The x, y, cx, and cy members specify values in dialog box units. You can convert these values to screen units (pixels) by using the MapDialogRect function.

The following dwStyle flags are not supported for dialog boxes:

• DS_ABSALIGN
• DS_CENTERMOUSE
• DS_CONTEXTHELP
• DS_FIXEDSYS
• DS_NOFAILCREATE
• DS_NOIDLEMSG
• DS_SYSMODAL

Requirements

See Also

Reference

CreateDialog
CreateDialogIndirect
CreateDialogIndirectParam
DialogBox
DialogBoxIndirect
DialogBoxIndirectParam
MapDialogRect
SetForegroundWindow
WM_SETFONT
DLGITEMTEMPLATE
Dialog Boxes Structures

Other Resources

MultiByteToWideChar