Telerik UI for WinForms最新版下載

在Telerik UI for WinForms的R3 2020版本中，套件中添加了新的RadTaskDialog組件。 任務(wù)對話框是一個小窗口，它向用戶顯示信息并提示他們進(jìn)行響應(yīng)。 與常規(guī)消息框相比，任務(wù)對話框具有許多配置選項，可以顯示其他UI元素（如單選按鈕和進(jìn)度條），并支持事件處理。

概述

RadTaskDialog是Windows對話框和新發(fā)布的.NET 5的TaskDialog可替代選擇，該對話框是一個窗口，允許用戶執(zhí)行命令、向用戶提問、為用戶提供信息或指示進(jìn)度、正在進(jìn)行的任務(wù)。RadTaskDialog代表標(biāo)準(zhǔn)System.Windows.Forms.MessageBox和RadMessageBox的擴(kuò)展版本，與常規(guī)消息框相比，它可以顯示其他控件，例如進(jìn)度條，并支持事件處理。

功能

• Auto-Size：窗口的大小基于添加到頁面的內(nèi)容。
• 分頁：提供到新頁面的導(dǎo)航（通過從當(dāng)前屬性重建對話框），任務(wù)對話框可以充當(dāng)帶有多個頁面的小型向?qū)В琈icrosoft建議使用不超過三頁。
• 支持的元素：任務(wù)對話框支持各種預(yù)定義的元素（如平面按鈕、常規(guī)按鈕、進(jìn)度條、等待條、單選按鈕、復(fù)選框、擴(kuò)展器按鈕、擴(kuò)展器區(qū)域、頁腳），這些元素可以分配并自動排列 無需編寫任何布局邏輯。
• 圖標(biāo)：除了表示錯誤、警告、信息的標(biāo)準(zhǔn)圖標(biāo)外，任務(wù)對話框在整個標(biāo)題/標(biāo)題背景上還具有綠色、黃色、紅色、灰色或藍(lán)色的條形。 此外，開箱即用也支持自定義圖標(biāo)和圖像。
• 模態(tài)與非模態(tài)：可以通過ShowDialog或Show方法來模態(tài)或非模態(tài)顯示。
• 本地化：每個預(yù)定義字符串的本地化。
• 主題：超過25個預(yù)定義主題。
• 自定義：RadTaskDialog可以根據(jù)您需要滿足的特定要求進(jìn)行構(gòu)造，并允許添加或刪除任何元素以及自定義任何預(yù)定義元素。

它有一個包含所有必要用戶信息的主要元素 - RadTaskDialogPage，RadTaskDialogPage公開了一些有用的屬性，這些屬性使您可以僅用幾行代碼來設(shè)置整個對話框：

• Caption：顯示此頁面時，RadTaskDialogForm標(biāo)題欄中的文本。
• Icon：帶有矢量圖像，并可以顯示綠色、紅色、黃色、藍(lán)色或灰色的欄作為標(biāo)題背景。
• Heading: 頁面的header/title。
• Text：顯示有關(guān)對話框目的的描述性信息。
• ProgressBar：用于指示確定或不確定的進(jìn)度。
• RadioButtons：單選按鈕集合，允許用戶從不同選項中進(jìn)行選擇。
• ContentAreaButtons：顯示在對話框頂部的平面按鈕的集合，這些按鈕是扁平的，具有三個主要元素：圖標(biāo)、標(biāo)題和描述文本。
• Expander：定義詳細(xì)信息/描述文本，可以通過切換按鈕將其折疊。
• Verification：復(fù)選框可用于接收用戶的確認(rèn)。
• CommandAreaButtons：顯示在頁面底部的常規(guī)按鈕的集合。
• Footnote: 提供可選的其他說明和幫助，通常針對經(jīng)驗不足的用戶。

用法

在描述了對話框的主要功能之后，就該展示一些用例了。 但是在此之前，我們需要澄清兩件重要的事情：

• RadTaskDialog需要RadTaskDialogPage作為要顯示的參數(shù)。
• RadTaskDialog不返回System.Windows.Forms.DailogResult（例如MessageBox），而是返回用戶單擊的按鈕的實例。

這是PDF文件移動期間的示例案例，用戶必須決定是替換原始文件，取消還是保留兩個文件。

這是代碼，大多數(shù)行用于配置命令鏈接按鈕：

RadTaskDialogPage page = new RadTaskDialogPage()
{
SizeToContent = true,
Icon = RadTaskDialogIcon.ShieldBlueBar,
Caption = "Move File",
Heading = "There is already a file with the same name in this location.",
Text = "Click the file you want to keep",
CommandAreaButtons = {
RadTaskDialogButton.Cancel
},
AllowCancel = true,
UseWideContentArea = true
};

RadSvgImage pdfIcon = RadSvgImage.FromFile(@"..\..\Resources\file-pdf.svg");
pdfIcon.Size = new Size(50, 50);
RadTaskDialogCommandLinkButton moveButton = new RadTaskDialogCommandLinkButton(
"Move and Replace",
@"Replace the file in the destination folder with the file you are moving:" + Environment.NewLine +
"document.pdf" + Environment.NewLine + "Size: 275 KB" + Environment.NewLine + "Date Modified: 11.11.2018 12:45");
moveButton.SvgImage = pdfIcon;
page.ContentAreaButtons.Add(moveButton);

RadTaskDialogCommandLinkButton dontMoveButton = new RadTaskDialogCommandLinkButton(
"Don't move",
@"Replace the file in the destination folder with the file you are moving:" + Environment.NewLine +
"document.pdf" + Environment.NewLine + "Size: 275 KB" + Environment.NewLine + "Date Modified: 11.11.2018 12:45");
dontMoveButton.SvgImage = (RadSvgImage)pdfIcon.Clone();
page.ContentAreaButtons.Add(dontMoveButton);

RadTaskDialogCommandLinkButton keepBothButton = new RadTaskDialogCommandLinkButton(
"Move, but keep both files",
"The file you are moving will be renamed 'document(2).pdf'");
page.ContentAreaButtons.Add(keepBothButton);

RadTaskDialogButton clickedButton = RadTaskDialog.ShowDialog(page);
if (clickedButton == null || clickedButton == RadTaskDialogButton.Cancel)
{
// the user cancelled the action
}
else if (clickedButton == moveButton)
{
// move and replace
}
else if (clickedButton == dontMoveButton)
{
// do not move
}
else if (clickedButton == keepBothButton)
{
// move and keep both files
}

另一個有趣的情況是您需要創(chuàng)建一個多頁對話框。 要切換頁面，您只需要調(diào)用當(dāng)前顯示的RadTaskDialogPage的Navigate方法。

這是打印機(jī)安裝示例：

RadTaskDialogButton initialButtonYes = RadTaskDialogButton.Continue;
initialButtonYes.Enabled = false;
initialButtonYes.AllowCloseDialog = false;

RadTaskDialogPage initialPage = new RadTaskDialogPage()
{
Caption = "Hardware Installation",
Heading = "Installation Warning",
Text = "The software you are installing for this hardware:\nPrinters\nhas not passed Windows Logo testing to verify its compatibility with Windows",
Icon = RadTaskDialogIcon.ShieldWarningYellowBar,
AllowCancel = true,

Verification = new RadTaskDialogVerificationCheckBox()
{
Text = "Install anyway"
},

CommandAreaButtons =
{
initialButtonYes,
RadTaskDialogButton.Cancel
},
DefaultButton = RadTaskDialogButton.Cancel
};

RadTaskDialogPage inProgressPage = new RadTaskDialogPage()
{
Caption = "Hardware Installation",
Heading = "Installation in progress...",
Text = "Please wait while the installation is in progress.",
Icon = RadTaskDialogIcon.Information,

ProgressBar = new RadTaskDialogProgressBar()
{
State = RadTaskDialogProgressBarState.Marquee
},

Expander = new RadTaskDialogExpander()
{
Text = "Initializing...",
Position = RadTaskDialogExpanderPosition.AfterFootnote
},

CommandAreaButtons =
{
RadTaskDialogButton.Cancel
}
};

RadTaskDialogPage finishedPage = new RadTaskDialogPage()
{
Caption = "Hardware Installation",
Heading = "Success!",
Text = "The Printer installation completed successfully.",
Icon = RadTaskDialogIcon.ShieldSuccessGreenBar,
CommandAreaButtons =
{
new RadTaskDialogButton("Finish")
}
};

RadTaskDialogVerificationCheckBox checkBox = initialPage.Verification;
checkBox.CheckedChanged += (sender, e) =>
{
initialButtonYes.Enabled = checkBox.Checked;
};

initialButtonYes.Click += (sender, e) =>
{
initialPage.Navigate(inProgressPage);
};

inProgressPage.Created += delegate (object s, EventArgs e)
{
RadTaskDialogProgressBar progressBar = inProgressPage.ProgressBar;
Timer timer = new Timer();
timer.Interval = 2800;
int progressValue = 0;
timer.Start();
timer.Tick += delegate (object sender, EventArgs args)
{
timer.Interval = 40;
if (progressBar.State == RadTaskDialogProgressBarState.Marquee)
{
progressBar.State = RadTaskDialogProgressBarState.Normal;
}

progressBar.Value = progressValue;
inProgressPage.Expander.Text = string.Format("Installation Progress: {0} %", progressValue);
if (progressValue == 100)
{
timer.Stop();
timer.Dispose();
inProgressPage.Navigate(finishedPage);
}

progressValue++;
};
};

最后，技術(shù)團(tuán)隊還組件了三組不同的矢量圖標(biāo)：漸變、平面和白色：

我們添加了三種不同的方法，這些方法根據(jù)內(nèi)部需求返回不同的格式和大小。 要訪問這些圖像，可以使用以下代碼：

// Returns a vector image
RadSvgImage svgIcon = RadTaskDialogIcon.GetSvgImage(RadTaskDialogIconImage.FlatShieldQuestion);

// Returns a raster image with size 16x16px
Image smallIcon = RadTaskDialogIcon.GetSmallImage(RadTaskDialogIconImage.FlatShieldQuestion);

// Returns a raster image with size 26x26px
Image largeIcon = RadTaskDialogIcon.GetLargeImage(RadTaskDialogIconImage.FlatShieldQuestion);