Share via


TASKDIALOG_FLAGS (Compact 2013)

3/28/2014

This enumeration specifies the behaviors of the task dialog.

Syntax

enum _TASKDIALOG_FLAGS {
    TDF_USE_HICON_MAIN              = 0x0002,
    TDF_USE_COMMAND_LINKS_NO_ICON   = 0x0020,
    TDF_VERIFICATION_FLAG_CHECKED   = 0x0100,
    TDF_RTL_LAYOUT                  = 0x2000,
    TDF_NO_DEFAULT_RADIO_BUTTON     = 0x4000
} TASKDIALOG_FLAGS;

Parameters

  • TDF_USE_HICON_MAIN
    Specifies that the dialog use the icon referred to by the handle in the hMainIcon member of TASKDIALOGCONFIG as the primary icon in the task dialog. If this flag is specified, the pszMainIcon member is ignored.
  • TDF_USE_COMMAND_LINKS_NO_ICON
    Specifies that the buttons specified in the pButtons member of TASKDIALOGCONFIG with ID values between TDCBID_COMMANDLINK_FIRST and TBCBID_COMMANDLINK_LAST be displayed as command links in the task dialog client area instead of central menu items or soft keys. This value is ignored if cButtons is zero.
  • TDF_VERIFICATION_FLAG_CHECKED
    Specifies that the verification checkbox in the dialog is checked when the dialog is initially displayed. This flag is ignored if the pszVerificationText member of TASKDIALOGCONFIG is NULL.
  • TDF_RTL_LAYOUT
    Specifies that text is displayed reading right to left.
  • TDF_NO_DEFAULT_RADIO_BUTTON
    Specifies that no default item will be selected.

Remarks

TASKDIALOGCONFIG uses these flags to specify various task dialog behaviors. These structures do not support the following values defined in Windows Vista:

TDF_ENABLE_HYPERLINKS           = 0x0001
TDF_USE_HICON_FOOTER            = 0x0004
TDF_ALLOW_DIALOG_CANCELLATION   = 0x0008
TDF_USE_COMMAND_LINKS           = 0x0010
TDF_EXPAND_FOOTER_AREA          = 0x0040
TDF_EXPANDED_BY_DEFAULT         = 0x0080
TDF_SHOW_PROGRESS_BAR           = 0x0200
TDF_SHOW_MARQUEE_PROGRESS_BAR   = 0x0400
TDF_CALLBACK_TIMER              = 0x0800
TDF_POSITION_RELATIVE_TO_WINDOW = 0x1000
TDF_CAN_BE_MINIMIZED            = 0x8000

Requirements

Header

shellctrls.h

See Also

Reference

Task Dialogs Enumerations
TASKDIALOGCONFIG