DTBLRADIOBUTTON

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 one radio button that will be part of a radio button group. The radio button group will be used in a dialog box that is built from a display table.

Header file:

Mapidefs.h

typedef struct _DTBLRADIOBUTTON
{
  ULONG ulbLpszLabel;
  ULONG ulFlags;
  ULONG ulcButtons;
  ULONG ulPropTag;
  long lReturnValue;
} DTBLRADIOBUTTON, FAR *LPDTBLRADIOBUTTON;

Members

  • ulbLpszLabel
    Position in memory of the character string label for the radio button.

  • ulFlags
    Bitmask of flags used to designate the format of the label pointed to by the ulbLpszLabel 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.
  • ulcButtons
    Count of buttons in the radio button group. The DTBLRADIOBUTTON structures for the other buttons in the group must be contained in successive rows of the display table. Each of these rows should contain the same value for the ulcButtons member.

  • ulPropTag
    Property tag for a property of type PT_LONG. The initial selection in the radio button group is based on the initial value of this property. Each button in the group must have ulPropTag set to the same property.

  • lReturnValue
    Unique number that identifies the selected button.

Remarks

A DTBLRADIOBUTTON structure describes a radio button a button control that is associated with a group of buttons. Only one button in the group can be checked; setting one button causes the other buttons in the group to be unset.

The button count is the number of radio buttons in the group. The structures for the other radio buttons in the group must be in subsequent rows in the display table. Each of these structures should have the same value for its button count.

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

BuildDisplayTable

DTCTL

SizedDtblButton

Concepts

MAPI Structures