輸入框

XtraInputBox是一個可皮膚化的對話框，它顯示一個編輯器，供最終用戶設(shè)置所需的值，以及確認或拒絕該值的OK/Cancel按鈕。這個對話框是XtraDialog控件的簡化版本，具有最少的自定義選項。

提示：輸入框被設(shè)計為返回用戶輸入的值：要么用戶輸入了一個值，要么消息被關(guān)閉，返回值為空。這些對象不返回DialogResult枚舉值，也不允許您識別用戶單擊了哪個消息按鈕，如果需要這種行為，請使用XtraDialogs。

輸入框完全由代碼創(chuàng)建和定制，為此，調(diào)用一個XtraInputBox.Show方法。

使用默認的TextEdit編輯器顯示輸入框

要顯示這種類型的輸入框，可以用三個字符串參數(shù)調(diào)用XtraInputBoxShow方法重載。

參數(shù)名稱	描述
Prompt	編輯器上方的文本字符串。
Title	對話框標題。
DefaultResponse	當輸入框出現(xiàn)在屏幕上時顯示的默認編輯器值。

下面的圖像和代碼說明了一個示例。

C#：

var result = XtraInputBox.Show("Enter a new value", "Change Settings", "Default");

點擊復(fù)制

VB.NET：

Dim result = XtraInputBox.Show("Enter a new value", "Change Settings", "Default")

點擊復(fù)制

當最終用戶單擊“OK”時，這個XtraInputBox.Show方法返回一個編輯器值。否則，它返回String.Empty。

使用自定義編輯器顯示輸入框

要顯示包含任何DevExpress編輯器的輸入框，請調(diào)用XtraInputBoxShow重載方法，該方法接受XtraInputBoxArgs類的一個實例作為參數(shù)，XtraInputBoxArgs類公開了以下公共屬性。

屬性	描述
XtraInputBoxArgs.Editor	輸入框顯示的編輯器
XtraInputBoxArgs.DefaultResponse	當輸入框出現(xiàn)在屏幕上時顯示的默認編輯器值。
XtraInputBoxArgs.Prompt	編輯器上方的文本。
XtraInputBoxArgs.Showing	此事件允許訪問和自定義對話框中的表單。例如，您可以設(shè)置一個對話框圖標。
DefaultButtonIndex	指定哪個輸入框按鈕是默認的。當用戶按下Enter鍵時，默認按鈕被認為已單擊，將此屬性設(shè)置為0，將“OK”按鈕設(shè)置為默認按鈕，或設(shè)置為1來讓“Cancel”按鈕變成默認按鈕。
Caption	輸入框標題。

在下面的圖中，輸入框顯示了一個日期編輯器。下面的代碼演示了如何創(chuàng)建這樣一個輸入框。

C#：

private void Args_Showing(object sender, XtraMessageShowingArgs e) {
private void Args_Showing(object sender, XtraMessageShowingArgs e) {
e.MessageBoxForm.Icon = this.Icon;using DevExpress.XtraEditors;

// Initialize a new XtraInputBoxArgs instance
XtraInputBoxArgs args = new XtraInputBoxArgs();
// Set required Input Box options
args.Caption = "Shipping options";
args.Prompt = "Delivery date";
args.DefaultButtonIndex = 0;
args.Showing += Args_Showing;
// Initialize a DateEdit editor with custom settings
DateEdit editor = new DateEdit();
editor.Properties.CalendarView = DevExpress.XtraEditors.Repository.CalendarView.TouchUI;
editor.Properties.Mask.EditMask = "MMMM d, yyyy";
args.Editor = editor;
// A default DateEdit value
args.DefaultResponse = DateTime.Now.Date.AddDays(3);
// Display an Input Box with the custom editor
var result = XtraInputBox.Show(args).ToString();
// Set a dialog icon

}

點擊復(fù)制

VB.NET：

Imports DevExpress.XtraEditors

' Initialize a new XtraInputBoxArgs instance
Dim args As New XtraInputBoxArgs()
' Set required Input Box options
args.Caption = "Shipping options"
args.Prompt = "Delivery date"
args.DefaultButtonIndex = 0
AddHandler args.Showing, AddressOf Args_Showing
' Initialize a DateEdit editor with custom settings
Dim editor As New DateEdit()
editor.Properties.CalendarView = DevExpress.XtraEditors.Repository.CalendarView.TouchUI
editor.Properties.Mask.EditMask = "MMMM d, yyyy"
args.Editor = editor
' A default DateEdit value
args.DefaultResponse = Date.Now.Date.AddDays(3)
' Display an Input Box with the custom editor
Dim result = XtraInputBox.Show(args).ToString()

Private Sub Args_Showing(ByVal sender As Object, ByVal e As XtraMessageShowingArgs)
e.MessageBoxForm.Icon = Me.Icon
End Sub

點擊復(fù)制

當最終用戶單擊“OK”時，這個XtraInputBox.Show方法返回一個Object，該對象是編輯器的編輯值。否則，該方法返回null。

輸入框

使用默認的TextEdit編輯器顯示輸入框

使用自定義編輯器顯示輸入框

用科技創(chuàng)就卓越

Create excellence with technology