Window.ShowDialog Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Bir pencere açar ve yalnızca yeni açılan pencere kapatıldığında döndürür.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

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

Public Function ShowDialog () As Nullable(Of Boolean)

Döndürülenler

Nullable<Boolean>

Nullable<T> Etkinliğin kabul edilip edilmediğini (true) veya iptal edilip edilmediğini (false) belirten tür Boolean değeri. Dönüş değeri, bir pencere kapanmadan önce özelliğin DialogResult değeridir.

Özel durumlar

InvalidOperationException

ShowDialog() kapatılan (Closing) veya kapatılmış (Closed) bir pencerede çağrılır.

Örnekler

Aşağıdaki örnek, kalıcı bir pencerenin nasıl açılabilir olduğunu gösterir.

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

Açıklamalar

Bir Window sınıf örneği oluşturulurken, varsayılan olarak görünmez. ShowDialog pencereyi gösterir, uygulamadaki diğer tüm pencereleri devre dışı bırakır ve yalnızca pencere kapatıldığında döndürür. Bu pencere türü kalıcı pencere olarak bilinir.

Kalıcı pencereler öncelikli olarak iletişim kutuları olarak kullanılır. İletişim kutusu, uygulamaların dosya açma veya belge yazdırma gibi görevleri tamamlamak için kullanıcılarla etkileşimde bulunurken kullandığı özel bir pencere türüdür. İletişim kutuları genellikle kullanıcıların iletişim kutusu kapatilmeden önce gösterdikleri görevi kabul etmelerine veya iptal etmelerine olanak sağlar. ShowDialog etkinliğin kabul edilip edilmediğini veya iptal edilip edilmediğini belirten bir Nullable<T>Boolean değer döndürür. Dönüş değeri, bir pencere kapanmadan önce özelliğin DialogResult değeridir. Daha fazla bilgi için bkz. DialogResult.

yöntemi çağrılarak ShowDialog açılan bir pencerenin, onu açan pencereyle otomatik olarak bir ilişkisi yoktur; özellikle, açılan pencere onu hangi pencerenin açtığını bilmez. Bu ilişki özelliği kullanılarak Owner oluşturulabilir ve özelliği kullanılarak OwnedWindows yönetilebilir. UI otomasyonlarını desteklemek için (bkz . UI Otomasyonuna Genel Bakış), Owner çağrılarak ShowDialogaçılan bir pencere için ayarlanmalıdır.

Kalıcı bir WPF penceresi (çağrılarak ShowDialogaçılan bir pencere) kapatıldığında, önceden etkinleştirilen pencere yeniden etkinleştirilir. Kalıcı BIR WPF penceresinde sahip penceresi varsa (bkz Owner. ), daha önce etkinleştirilen pencere olmadığı sürece kalıcı WPF penceresi kapatıldığında sahip penceresi yeniden etkinleştirilmez.

Not

Bir pencere tarayıcıda barındırıldığında bu yöntem çağrılamaz.

Ayrıca bkz.

• Close()
• WindowState