DTCTL 

The DTCTL structure describes a control to be used in a dialog box built from a display table.

Quick Info

typedef struct

{ 

     ULONG      ulCtlType;

     ULONG      ulCtlFlags;     

     LPBYTE     lpbNotif;

     ULONG      cbNotif;     

     LPTSTR     lpszFilter;     

     ULONG      ulItemID;

     union

     {      

          LPVOID               lpv;

          LPDTBLLABEL          lplabel;

          LPDTBLEDIT           lpedit;

          LPDTBLLBX            lplbx;

          LPDTBLCOMBOBOX       lpcombobox;

          LPDTBLDDLBX          lpddlbx;

          LPDTBLCHECKBOX       lpcheckbox;

          LPDTBLGROUPBOX       lpgroupbox;

          LPDTBLBUTTON         lpbutton;

          LPDTBLRADIOBUTTON    lpradiobutton;

          LPDTBLMVLISTBOX      lpmvlbx;

          LPDTBLMVDDLBX        lpmvddlbx;

          LPDTBLPAGE           lppage;

     } ctl;

} DTCTL, FAR *LPDTCTL;

Members

ulCtlType

Type of control that is included in the ctl member and corresponds to the control s PR_CONTROL_TYPE112B02L property. Possible values are described in the following table. 

ulCtlFlags

Bitmask of flags that describes the control s features and corresponds to the control s PR_CONTROL_FLAGS5_R1_OJ property. These flags can be set for check boxes, combo boxes, list boxes, and edit controls only. Possible values are:

DT_ACCEPT_DBCS

Either the ANSI or DBCS format is accepted. This flag is valid for edit controls only.

DT_EDITABLE

A user can edit the text in the control.

DT_MULTILINE

The control can contain multiple text lines. This flag is valid for edit controls only.

DT_PASSWORD_EDIT

The control contains a password; therefore, the contents of the control should not be displayed to the user. This flag is valid for edit controls only.

DT_REQUIRED

The dialog box control is required. This flag is valid only for edit and combo box controls.

DT_SET_IMMEDIATE

Enables immediate output of a value upon a change in the control, allowing a dependency relationship to be established between two controls.

lpbNotif

Pointer to a structure made up of a globally unique identifier, or GUID14AUUS3 structure, to represent the service provider and an identifier for the control. The lpbNotif and cbNotif members correspond to the control s PR_CONTROL_ID218DGB7 property and are used to notify the user interface when the control needs updating.

cbNotif

Count of bytes in the structure pointed to by the lpbNotif member.

lpszFilter

Pointer to a character string that describes which characters can be entered into an edit or combo box control. For other types of controls, the lpszFilter member can be NULL. For edit and combo box controls, it should be a regular expression that applies to a single character at a time. The same filter is applied to all characters in the control.

The format of the filter string is as follows:

*   Any character is allowed (for example,  * ).

[  ] Defines a set of characters (for example,  [0123456789] ).

-   Indicates a range of characters (for example,  [a-z] ).

~  Indicates that these characters are not allowed (for example,  [~0-9] ).

\   Used to quote any of the above symbols (for example,  [\-\\\[\]]  means -, \, [, and ] characters are allowed).

ulItemID

Value that identifies the control in the dialog box resource. For tabbed pages   controls of type DTCT_PAGE   the ulItemID member is optionally used to load the component name for the page from a string resource.

ctl

A structure that holds the data for the control and corresponds to the control s PR_CONTROL_STRUCTUREJXTWZB property. Each type of control has a different structure.

Remarks

The DTCTL structure describes one control of any type. Most of its members are used to set properties on the control.

The ctl member is a union of structures that relate to a particular type of control. If the DTCTL structure is describing an edit control, for example, the ctl member will point to an DTBLEDITSTYJX7 structure. This structure corresponds to the control s PR_CONTROL_STRUCTUREJXTWZB property. The union has as its first member a variable of type LPVOID to permit compile time initialization of the DTCTL structure.

Although the BuildDisplayTableH3VFJX function uses the DTCTL structure for building the display table from control resources, the DTCTL structure never appears in the display table itself. This structure simply supplies information to BuildDisplayTable.

In the ulCtlFlags member, four flags   DT_ACCEPT_DBCS, DT_EDITABLE, DT_MULTILINE_and DT_PASSWORD_EDIT   affect edit controls only. Two others   DT_REQUIRED and DT_SET_IMMEDIATE   affect any editable control.

The controls available for a dialog box are label, edit box, ink-aware edit box, list box, drop-down list box, combo box, check box, group box, button, radio button, and tabbed page.

For an overview of display tables, see Display Tables12983_W. For information about implementing a display table, see Implementing a Display Table3Q3A1K.

See Also