Back to Devexpress

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

windowsforms-devexpress-dot-xtraeditors-dot-xtrainputbox-dot-show-x28-system-dot-windows-dot-forms-dot-iwin32window-system-dot-string-system-dot-string-system-dot-string-x29.md

latest4.7 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
public static string Show(
    IWin32Window owner,
    string prompt,
    string title,
    string defaultResponse
)
vb
Public Shared Function Show(
    owner As IWin32Window,
    prompt As String,
    title As String,
    defaultResponse As String
) As String

Parameters

NameTypeDescription
ownerIWin32Window

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

TypeDescription
String

The entered value, or null if nothing was entered.

|

Example

The following code snippet displays a dialog box with default settings:

csharp
using DevExpress.XtraEditors;

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

// Display an input box with the specified owner, prompt, title, and default response.
XtraInputBox.Show(this, "Enter a new value", "Change Settings", "Default");
vb
Imports DevExpress.XtraEditors

' Display an input box with the specified owner, prompt, title, and default response.
XtraInputBox.Show("Enter a new value", "Change Settings", "Default")

' Display an input box with the specified owner, prompt, title, and default response.
XtraInputBox.Show(Me, "Enter a new value", "Change Settings", "Default")

The following code snippet displays an input box with the specified text, caption, and editor:

csharp
using DevExpress.XtraEditors;

// Create a DateEdit and customize its settings.
DateEdit dateEditor = new DateEdit();

dateEditor.Properties.CalendarView = DevExpress.XtraEditors.Repository.CalendarView.TouchUI;
dateEditor.Properties.Mask.EditMask = "MMMM d, yyyy";

// Initialize a new XtraInputBoxArgs instance with the specified settings.
XtraInputBoxArgs args = new XtraInputBoxArgs()
{
    Caption = "Shipping Options",
    Prompt = "Delivery Date",
    DefaultButtonIndex = 0,
    Editor = dateEditor,
    DefaultResponse = DateTime.Now.Date.AddDays(3) // The date editor's default value
};

// Display the input box and assign the dialog result to a variable.
var result = XtraInputBox.Show(args);
vb
Imports DevExpress.XtraEditors

' Create a DateEdit and customize its settings.
Dim dateEditor As New DateEdit()

dateEditor.Properties.CalendarView = DevExpress.XtraEditors.Repository.CalendarView.TouchUI
dateEditor.Properties.Mask.EditMask = "MMMM d, yyyy"

' Initialize a new XtraInputBoxArgs instance with the specified settings.
Dim args As New XtraInputBoxArgs() With {
    .Caption = "Shipping Options",
    .Prompt = "Delivery Date",
    .DefaultButtonIndex = 0,
    .Editor = dateEditor,
    .DefaultResponse = DateTime.Now.Date.AddDays(3) ' The date editor's default value
}

' Display the input box and assign the dialog result to a variable.
Dim result = XtraInputBox.Show(args)

See Also

Input Box

XtraInputBox Class

XtraInputBox Members

DevExpress.XtraEditors Namespace