Window.ShowDialog Metódus

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

Megnyit egy ablakot, és csak akkor ad vissza, ha az újonnan megnyitott ablak be van zárva.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog();

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

Public Function ShowDialog () As Nullable(Of Boolean)

Válaszok

Nullable<Boolean>

A Nullable<T> tevékenység elfogadását () vagy megszakítását (Booleantrue) meghatározó típusértékfalse. A visszatérési érték a tulajdonság értéke az DialogResult ablak bezárása előtt.

Kivételek

InvalidOperationException

ShowDialog() egy bezárt (Closing) vagy bezárt (Closed) ablakban van meghívva.

Példák

Az alábbi minta bemutatja, hogyan nyithat meg egy modális ablakot.

// 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()

Megjegyzések

Window Az osztály példányosításakor alapértelmezés szerint nem látható. ShowDialog megjeleníti az ablakot, letiltja az alkalmazás összes többi ablakát, és csak akkor ad vissza, ha az ablak be van zárva. Ezt az ablaktípust modális ablaknak nevezzük.

A modális ablakokat elsősorban párbeszédpanelekként használják. A párbeszédpanel egy speciális ablaktípus, amelyet az alkalmazások a felhasználókkal való interakcióra használnak a feladatok elvégzéséhez, például fájlok megnyitásához vagy dokumentumok nyomtatásához. A párbeszédpanelek általában lehetővé teszik a felhasználók számára, hogy elfogadják vagy megszakítják azt a feladatot, amelynek a párbeszédpanel bezárása előtt jelentek meg. ShowDialog egy Nullable<T>Boolean értéket ad vissza, amely meghatározza, hogy a tevékenységet elfogadták vagy megszakították-e. A visszatérési érték a tulajdonság értéke az DialogResult ablak bezárása előtt. További információért lásd DialogResult.

A metódus meghívásával ShowDialog megnyitott ablak nem kapcsolódik automatikusan a megnyitott ablakhoz, pontosabban a megnyitott ablak nem tudja, hogy melyik ablak nyitotta meg. Ez a kapcsolat a Owner tulajdonság használatával hozható létre, és a OwnedWindows tulajdonság használatával kezelhető. A UI automation támogatásához (lásd: UI-automatizálás Áttekintés) Owner kell beállítani a ShowDialog hívásával megnyitott ablakhoz.

Ha egy modális WPF ablak (ShowDialog meghívásával megnyitott ablak) bezárul, a korábban aktivált ablak újraaktiválódik. Ha egy modális WPF ablak rendelkezik tulajdonosi ablakkal (lásd Owner), a tulajdonosablak nem aktiválódik újra a modális WPF ablak bezárásakor, kivéve, ha az korábban aktivált ablak volt.

Note

Ez a metódus nem hívható meg, ha egy ablakot böngészőben üzemeltetnek.

Lásd még

• Close()
• WindowState