/// <summary>
/// Displays a task dialog that has a message and that returns a result.
/// </summary>
/// <param name="owner">
/// The <see cref="T:System.Windows.Window"/> that owns this dialog.
/// </param>
/// <param name="messageText">
/// A <see cref="T:System.String"/> that specifies the text to display.
/// </param>
/// <returns>
/// A <see cref="T:TaskDialogInterop.TaskDialogSimpleResult"/> value that
/// specifies which button is clicked by the user.
/// </returns>
public static TaskDialogSimpleResult ShowMessage(Window owner, string messageText)
{
TaskDialogOptions options = TaskDialogOptions.Default;
options.Owner = owner;
options.Content = messageText;
options.CommonButtons = TaskDialogCommonButtons.Close;
return(Show(options).Result);
}
/// <summary>
/// Displays a task dialog that has a message and that returns a result.
/// </summary>
/// <param name="owner">
/// The <see cref="T:System.Windows.Window"/> that owns this dialog.
/// </param>
/// <param name="messageText">
/// A <see cref="T:System.String"/> that specifies the text to display.
/// </param>
/// <param name="caption">
/// A <see cref="T:System.String"/> that specifies the title bar
/// caption to display.
/// </param>
/// <param name="buttons">
/// A <see cref="T:TaskDialogInterop.TaskDialogCommonButtons"/> value that
/// specifies which button or buttons to display.
/// </param>
/// <param name="icon">
/// A <see cref="T:TaskDialogInterop.VistaTaskDialogIcon"/> that specifies the
/// icon to display.
/// </param>
/// <returns>
/// A <see cref="T:TaskDialogInterop.TaskDialogSimpleResult"/> value that
/// specifies which button is clicked by the user.
/// </returns>
public static TaskDialogSimpleResult ShowMessage(Window owner, string messageText, string caption, TaskDialogCommonButtons buttons, VistaTaskDialogIcon icon)
{
TaskDialogOptions options = TaskDialogOptions.Default;
options.Owner = owner;
options.Title = caption;
options.Content = messageText;
options.CommonButtons = buttons;
options.MainIcon = icon;
return(Show(options).Result);
}
/// <summary>
/// Displays a task dialog with the given configuration options.
/// </summary>
/// <param name="options">
/// A <see cref="T:TaskDialogInterop.TaskDialogOptions"/> that specifies the
/// configuration options for the dialog.
/// </param>
/// <returns>
/// A <see cref="T:TaskDialogInterop.TaskDialogResult"/> value that specifies
/// which button is clicked by the user.
/// </returns>
public static TaskDialogResult Show(TaskDialogOptions options)
{
TaskDialogResult result = null;
// Make a copy since we'll let Showing event possibly modify them
TaskDialogOptions configOptions = options;
OnShowing(new TaskDialogShowingEventArgs(ref configOptions));
if (!VistaTaskDialog.IsAvailableOnThisOS)
{
throw new PlatformNotSupportedException("Windows 7 or newer is required for task dialogs.");
}
result = ShowTaskDialog(configOptions);
OnClosed(new TaskDialogClosedEventArgs(result));
return(result);
}
/// <summary>
/// Displays a task dialog that has a message and that returns a result.
/// </summary>
/// <param name="owner">
/// The <see cref="T:System.Windows.Window"/> that owns this dialog.
/// </param>
/// <param name="title">
/// A <see cref="T:System.String"/> that specifies the title bar
/// caption to display.
/// </param>
/// <param name="mainInstruction">
/// A <see cref="T:System.String"/> that specifies the main text to display.
/// </param>
/// <param name="content">
/// A <see cref="T:System.String"/> that specifies the body text to display.
/// </param>
/// <param name="expandedInfo">
/// A <see cref="T:System.String"/> that specifies the expanded text to display when toggled.
/// </param>
/// <param name="verificationText">
/// A <see cref="T:System.String"/> that specifies the text to display next to a checkbox.
/// </param>
/// <param name="footerText">
/// A <see cref="T:System.String"/> that specifies the footer text to display.
/// </param>
/// <param name="buttons">
/// A <see cref="T:TaskDialogInterop.TaskDialogCommonButtons"/> value that
/// specifies which button or buttons to display.
/// </param>
/// <param name="mainIcon">
/// A <see cref="T:TaskDialogInterop.VistaTaskDialogIcon"/> that specifies the
/// main icon to display.
/// </param>
/// <param name="footerIcon">
/// A <see cref="T:TaskDialogInterop.VistaTaskDialogIcon"/> that specifies the
/// footer icon to display.
/// </param>
/// <returns></returns>
public static TaskDialogSimpleResult ShowMessage(Window owner, string title, string mainInstruction, string content, string expandedInfo, string verificationText, string footerText, TaskDialogCommonButtons buttons, VistaTaskDialogIcon mainIcon, VistaTaskDialogIcon footerIcon)
{
TaskDialogOptions options = TaskDialogOptions.Default;
if (owner != null)
{
options.Owner = owner;
}
if (!String.IsNullOrEmpty(title))
{
options.Title = title;
}
if (!String.IsNullOrEmpty(mainInstruction))
{
options.MainInstruction = mainInstruction;
}
if (!String.IsNullOrEmpty(content))
{
options.Content = content;
}
if (!String.IsNullOrEmpty(expandedInfo))
{
options.ExpandedInfo = expandedInfo;
}
if (!String.IsNullOrEmpty(verificationText))
{
options.VerificationText = verificationText;
}
if (!String.IsNullOrEmpty(footerText))
{
options.FooterText = footerText;
}
options.CommonButtons = buttons;
options.MainIcon = mainIcon;
options.FooterIcon = footerIcon;
return(Show(options).Result);
}
private static TaskDialogResult ShowTaskDialog(TaskDialogOptions options)
{
VistaTaskDialog vtd = new VistaTaskDialog();
vtd.WindowTitle = options.Title;
vtd.MainInstruction = options.MainInstruction;
vtd.Content = options.Content;
vtd.ExpandedInformation = options.ExpandedInfo;
vtd.Footer = options.FooterText;
if (options.CommandButtons != null && options.CommandButtons.Length > 0)
{
List <VistaTaskDialogButton> lst = new List <VistaTaskDialogButton>();
for (int i = 0; i < options.CommandButtons.Length; i++)
{
try
{
VistaTaskDialogButton button = new VistaTaskDialogButton();
button.ButtonId = GetButtonIdForCommandButton(i);
button.ButtonText = options.CommandButtons[i];
lst.Add(button);
}
catch (FormatException)
{
}
}
vtd.Buttons = lst.ToArray();
if (options.DefaultButtonIndex.HasValue &&
options.DefaultButtonIndex >= 0 &&
options.DefaultButtonIndex.Value < vtd.Buttons.Length)
{
vtd.DefaultButton = vtd.Buttons[options.DefaultButtonIndex.Value].ButtonId;
}
}
else if (options.RadioButtons != null && options.RadioButtons.Length > 0)
{
List <VistaTaskDialogButton> lst = new List <VistaTaskDialogButton>();
for (int i = 0; i < options.RadioButtons.Length; i++)
{
try
{
VistaTaskDialogButton button = new VistaTaskDialogButton();
button.ButtonId = GetButtonIdForRadioButton(i);
button.ButtonText = options.RadioButtons[i];
lst.Add(button);
}
catch (FormatException)
{
}
}
vtd.RadioButtons = lst.ToArray();
vtd.NoDefaultRadioButton = (!options.DefaultButtonIndex.HasValue || options.DefaultButtonIndex.Value == -1);
if (options.DefaultButtonIndex.HasValue &&
options.DefaultButtonIndex >= 0 &&
options.DefaultButtonIndex.Value < vtd.RadioButtons.Length)
{
vtd.DefaultButton = vtd.RadioButtons[options.DefaultButtonIndex.Value].ButtonId;
}
}
bool hasCustomCancel = false;
if (options.CustomButtons != null && options.CustomButtons.Length > 0)
{
List <VistaTaskDialogButton> lst = new List <VistaTaskDialogButton>();
for (int i = 0; i < options.CustomButtons.Length; i++)
{
try
{
VistaTaskDialogButton button = new VistaTaskDialogButton();
button.ButtonId = GetButtonIdForCustomButton(i);
button.ButtonText = options.CustomButtons[i];
if (!hasCustomCancel)
{
hasCustomCancel =
(button.ButtonText == "Close" ||
button.ButtonText == "Cancel");
}
lst.Add(button);
}
catch (FormatException)
{
}
}
vtd.Buttons = lst.ToArray();
if (options.DefaultButtonIndex.HasValue &&
options.DefaultButtonIndex.Value >= 0 &&
options.DefaultButtonIndex.Value < vtd.Buttons.Length)
{
vtd.DefaultButton = vtd.Buttons[options.DefaultButtonIndex.Value].ButtonId;
}
vtd.CommonButtons = VistaTaskDialogCommonButtons.None;
}
else
{
vtd.CommonButtons = ConvertCommonButtons(options.CommonButtons);
if (options.DefaultButtonIndex.HasValue &&
options.DefaultButtonIndex >= 0)
{
vtd.DefaultButton = GetButtonIdForCommonButton(options.CommonButtons, options.DefaultButtonIndex.Value);
}
}
vtd.MainIcon = options.MainIcon;
vtd.CustomMainIcon = options.CustomMainIcon;
vtd.FooterIcon = options.FooterIcon;
vtd.CustomFooterIcon = options.CustomFooterIcon;
vtd.EnableHyperlinks = DetectHyperlinks(options.Content, options.ExpandedInfo, options.FooterText);
vtd.AllowDialogCancellation =
(options.AllowDialogCancellation ||
hasCustomCancel ||
options.CommonButtons == TaskDialogCommonButtons.Close ||
options.CommonButtons == TaskDialogCommonButtons.OKCancel ||
options.CommonButtons == TaskDialogCommonButtons.YesNoCancel);
vtd.CallbackTimer = options.EnableCallbackTimer;
vtd.ExpandedByDefault = options.ExpandedByDefault;
vtd.ExpandFooterArea = options.ExpandToFooter;
vtd.PositionRelativeToWindow = true;
vtd.RightToLeftLayout = false;
vtd.NoDefaultRadioButton = false;
vtd.CanBeMinimized = false;
vtd.ShowProgressBar = options.ShowProgressBar;
vtd.ShowMarqueeProgressBar = options.ShowMarqueeProgressBar;
vtd.UseCommandLinks = (options.CommandButtons != null && options.CommandButtons.Length > 0);
vtd.UseCommandLinksNoIcon = false;
vtd.VerificationText = options.VerificationText;
vtd.VerificationFlagChecked = options.VerificationByDefault;
vtd.ExpandedControlText = "Hide details";
vtd.CollapsedControlText = "Show details";
vtd.Callback = options.Callback;
vtd.CallbackData = options.CallbackData;
vtd.Config = options;
TaskDialogResult result = null;
int diagResult = 0;
TaskDialogSimpleResult simpResult = TaskDialogSimpleResult.None;
bool verificationChecked = false;
int radioButtonResult = -1;
int? commandButtonResult = null;
int? customButtonResult = null;
diagResult = vtd.Show((vtd.CanBeMinimized ? null : options.Owner), out verificationChecked, out radioButtonResult);
if (diagResult >= CommandButtonIDOffset)
{
simpResult = TaskDialogSimpleResult.Command;
commandButtonResult = diagResult - CommandButtonIDOffset;
}
else if (radioButtonResult >= RadioButtonIDOffset)
{
simpResult = (TaskDialogSimpleResult)diagResult;
radioButtonResult -= RadioButtonIDOffset;
}
else if (diagResult >= CustomButtonIDOffset)
{
simpResult = TaskDialogSimpleResult.Custom;
customButtonResult = diagResult - CustomButtonIDOffset;
}
else
{
simpResult = (TaskDialogSimpleResult)diagResult;
}
result = new TaskDialogResult(
simpResult,
(String.IsNullOrEmpty(options.VerificationText) ? null : (bool?)verificationChecked),
((options.RadioButtons == null || options.RadioButtons.Length == 0) ? null : (int?)radioButtonResult),
((options.CommandButtons == null || options.CommandButtons.Length == 0) ? null : commandButtonResult),
((options.CustomButtons == null || options.CustomButtons.Length == 0) ? null : customButtonResult));
return(result);
}
/// <summary>
/// Initializes a new instance of the <see cref="TaskDialogShowingEventArgs"/> class.
/// </summary>
/// <param name="configOptions">The configuration options for the TaskDialog.</param>
internal TaskDialogShowingEventArgs(ref TaskDialogOptions configOptions)
{
ConfigurationOptions = configOptions;
}