Window.ShowDialog Metod

public:
 Nullable<bool> ShowDialog();

[System.Security.SecurityCritical]
public bool? ShowDialog();

public bool? ShowDialog();

[<System.Security.SecurityCritical>]
member this.ShowDialog : unit -> Nullable<bool>

member this.ShowDialog : unit -> Nullable<bool>

Public Function ShowDialog () As Nullable(Of Boolean)

Returer

Ett Nullable<T> värde av typen Boolean som anger om aktiviteten accepterades (true) eller avbröts (false). Returvärdet är värdet för DialogResult egenskapen innan ett fönster stängs.

Attribut

SecurityCriticalAttribute

Undantag

Exempel

Följande exempel visar hur du öppnar ett modalt fönster.

// Instantiate window
DialogBox dialogBox = new DialogBox();

// Show window modally
// NOTE: Returns only when window is closed
Nullable<bool> dialogResult = dialogBox.ShowDialog();

' Instantiate window
Dim dialogBox As New DialogBox()

' Show window modally
' NOTE: Returns only when window is closed
Dim dialogResult? As Boolean = dialogBox.ShowDialog()

Kommentarer

När en Window klass instansieras visas den inte som standard. ShowDialog visar fönstret, inaktiverar alla andra fönster i programmet och returnerar endast när fönstret stängs. Den här typen av fönster kallas för ett modalt fönster.

Modala fönster används främst som dialogrutor. En dialogruta är en särskild typ av fönster som program använder för att interagera med användare för att slutföra uppgifter, till exempel att öppna filer eller skriva ut dokument. Med dialogrutor kan användare vanligtvis acceptera eller avbryta den uppgift som de visades för innan dialogrutan stängs. ShowDialog returnerar ett Nullable<T>Boolean värde som anger om aktiviteten accepterades eller avbröts. Returvärdet är värdet för DialogResult egenskapen innan ett fönster stängs. Mer information finns i DialogResult.

Ett fönster som öppnas genom att anropa ShowDialog metoden har inte automatiskt en relation med fönstret som öppnade det. Det öppnade fönstret vet inte vilket fönster som öppnade det. Den här relationen kan upprättas med hjälp av Owner egenskapen och hanteras med hjälp av OwnedWindows egenskapen . Om du vill ha stöd för UI automation (se UI Automation Overview) måste Owner anges för ett fönster som öppnas genom att anropa ShowDialog.

När ett modalt WPF fönster (ett fönster som öppnas genom att anropa ShowDialog) stängs återaktiveras det tidigare aktiverade fönstret. Om ett modalt WPF fönster har ett ägarfönster (se Owner) återaktiveras inte ägarfönstret när det modala WPF fönstret stängs om det inte var det tidigare aktiverade fönstret.

Se även

• Close()
• WindowState