DTBLLABEL

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Describes a label that will be used in a dialog box that is built from a display table.

Header file:	Mapidefs.h
Related macro	SizedDtblLabel

typedef struct _DTBLLABEL
{
  ULONG ulbLpszLabelName;
  ULONG ulFlags;
} DTBLLABEL, FAR *LPDTBLLABEL;

Members

• ulbLpszLabelName
  Position in memory of the character string label.

• ulFlags
  Bitmask of flags used to designate the format of the label pointed to by the ulbLpszLabelName member. The following flag can be set:

  • MAPI_UNICODE
    The label is in Unicode format. If the MAPI_UNICODE flag is not set, the label is in ANSI format.

Remarks

A DTBLLABEL structure describes a label control text that is displayed with another type of control to add meaning to that control. For example, most edit controls are positioned next to labels to inform the user of the type of information to be entered. Some controls, such as group boxes and radio buttons, hold their own labels.

The label can include a Windows accelerator, identified as the character following the ampersand (&). Pressing the accelerator key puts the focus in the first nonlabel, nonbutton control following this label in the display table.

There is no support for multiline labels. Showing multiple lines requires multiple labels.

It is not possible to use a label as a read-only edit control. The difference is that an edit control can be selected and copied whereas a label cannot.

For an overview of display tables, see Display Tables. For information about how to implement a display table, see Implementing a Display Table.

See Also

Reference

DTCTL

Concepts

MAPI Structures