Cmdlet

New-ConsoleDialog

Module: ConsoleMonster
Inputs: System.Object
Outputs: FormDialog<T>[[AppState, ConsoleMonster, Version=0, Culture=neutral, PublicKeyToken=null]]

Creates a typed modal form for the running app's dialog service.

Syntax

New-ConsoleDialog
[-AcceptText <String>]
[-CancelText <String>]
[[-Content] <Object>]
[-DefaultAccept]
[-InitialFocus <String>]
[-MaxWidth <Int32>]
-Title <String>
[-Validate <Func`2>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

Construction does not read input. AppDialogs.Show hosts the form on the owning application thread and returns DialogResult of AppState through its completion callback.

Examples

Example 1

New-ConsoleDialog -Title Options -InitialFocus Destination -Content { New-ConsoleTextInput -Key Destination }

Define fields for an app-owned dialog.

Parameters

-AcceptText String optional: Affirmative button label.
-CancelText String optional: Cancellation button label.
-Content Object optionalposition: 0pipeline: True (ByValue): Retained widgets or a script block that emits fields.
-DefaultAccept SwitchParameter optional: Focuses the affirmative button initially instead of Cancel.
-InitialFocus String optional: Field key to focus instead of the default button.
-MaxWidth Int32 optional: Maximum width in terminal cells.
-Title String required: Visible heading.
-Validate Func<T1, T2> optional: App-thread validator returning an error string or null.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Outputs

ConsoleMonster.Interactive.FormDialog`1[[ConsoleMonster.Interactive.AppState, ConsoleMonster, Version=2.0.2.0, Culture=neutral, PublicKeyToken=null]]