Skip to main content

XtraInputBox.Show(IWin32Window, String, String, String) Method

Displays an input box with the specified title, prompt, and default response.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

public static string Show(
    IWin32Window owner,
    string prompt,
    string title,
    string defaultResponse
)

Parameters

Name Type Description
owner IWin32Window

An IWin32Window object that shares its look-and-feel settings with this Input Box.

prompt String

The text above the editor.

title String

The text in the title bar.

defaultResponse String

The text that is the editor’s default value.

Returns

Type Description
String

The entered value, or null if nothing was entered.

Example

The code snippet below shows how to display a dialog box with custom settings.

using DevExpress.XtraEditors;

// Display an iput box with the specifiedx prompt, title, and default response.
XtraInputBox.Show("Enter a new value", "Change Settings", "Default");
XtraInputBox.Show(this, "Enter a new value", "Change Settings", "Default");

// Initialize a new XtraInputBoxArgs instance.
XtraInputBoxArgs args = new XtraInputBoxArgs();
// Specify settings.
args.Caption = "Shipping options";
args.Prompt = "Delivery date";
args.DefaultButtonIndex = 0;
// Initialize a new DateEdit instance.
DateEdit editor = new DateEdit();
// Specify settings.
editor.Properties.CalendarView = DevExpress.XtraEditors.Repository.CalendarView.TouchUI;
editor.Properties.Mask.EditMask = "MMMM d, yyyy";
// Assign the editor to the input box settings.
args.Editor = editor;
// Specify the editor's default value.
args.DefaultResponse = DateTime.Now.Date.AddDays(3);
// Display an input box and assign the result to a variable.
var result = XtraInputBox.Show(args);

// You can also use the generic method and specify the return value's type.
DateTime resultDateTime = XtraInputBox.Show<DateTime>(args);
See Also