Window.DialogResult Özellik

Tanım

yönteminden ShowDialog() döndürülen değer olan iletişim sonucu değerini alır veya ayarlar.

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public bool? DialogResult { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))>]
member this.DialogResult : Nullable<bool> with get, set
Public Property DialogResult As Nullable(Of Boolean)

Özellik Değeri

Nullable<T> türünde Booleanbir değer. Varsayılan değer: false.

Öznitelikler

Özel durumlar

DialogResult , bir pencere çağrılarak ShowDialog()açılmadan önce ayarlanır.

-veya-

DialogResult , çağrılarak Show()açılan bir pencerede ayarlanır.

Örnekler

Aşağıdaki örnekte, uygun DialogResultdeğerini döndürmek için Tamam düğmesinin ve İptal düğmesinin nasıl yapılandırıldığından emin olun.

<Button IsDefault="True" Click="acceptButton_Click">OK (IsDefault=True)</Button>
<Button IsCancel="True">Cancel (IsCancel=True)</Button>
using System;
using System.Windows;
using System.Windows.Controls;

namespace CSharp
{
    public partial class DialogBox : Window
    {
        public DialogBox()
        {
            InitializeComponent();
        }

        // The accept button is a button whose IsDefault property is set to true.
        // This event is raised whenever this button is clicked, or the ENTER key
        // is pressed.
        void acceptButton_Click(object sender, RoutedEventArgs e)
        {
            // Accept the dialog and return the dialog result
            this.DialogResult = true;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls

Namespace VisualBasic
    Partial Public Class DialogBox
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        ' The accept button is a button whose IsDefault property is set to true.
        ' This event is raised whenever this button is clicked, or the ENTER key
        ' is pressed.
        Private Sub acceptButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Accept the dialog and return the dialog result
            Me.DialogResult = True
        End Sub
    End Class
End Namespace

Açıklamalar

DialogResult kullanıcının iletişim kutusunu kabul edip etmediğini (true) veya iptalfalse edip etmediğini belirlemek için iletişim kutusunu gösteren koddan kullanılabilir. Bir iletişim kutusu kabul edildiyse, bu, kullanıcı tarafından toplanan verileri almak ve işlemek için iletişim kutusunu açan koda işaret eder. Bununla birlikte, bir iletişim kutusu iptal edildiyse, bu durum kodu çağırmanın daha fazla işlemeyi durdurması gerektiğini gösterir.

Varsayılan olarak, kullanıcı aşağıdakilerden birini yaptığı zaman iletişim kutusu iptal edilir:

  • PRESSESALT+F4 tuşlarına basın.

  • Kapat düğmesine tıklar.

  • Sistem menüsünden Kapat'ı seçer.

Tüm bu durumlarda varsayılan DialogResult değerdir false .

İletişim kutusu genellikle, özelliği olarak ayarlanmış trueolan bir iletişim kutusunu iptal etmek için özel bir düğme IsCancel sağlar. Bu şekilde yapılandırılan bir düğme, bir pencereye basıldığında veya ESC tuşuna basıldığında pencereyi otomatik olarak kapatır. Bu iki durumda DialogResult da kalır false.

İletişim kutusu genellikle özelliği olarak ayarlanmış trueolan bir kabul et düğmesi IsDefault de sağlar. Bu şekilde yapılandırılan bir düğme, bu düğmeye veya ENTER tuşuna basıldığında olayı tetikler Click . Ancak, iletişim kutusunu otomatik olarak kapatmaz ve olarak trueayarlayamazDialogResult. Bu kodu genellikle varsayılan düğmenin olay işleyicisinden Click el ile yazmanız gerekir.

DialogResult , null iletişim kutusunun gösterildiği ancak kabul edilmediğinde veya iptal edilmediğinde olduğu durumdur.

İletişim kutusu kapatıldıktan sonra, yöntem tarafından ShowDialog döndürülen değerden veya özelliğini inceleyerek DialogResult iletişim kutusu sonucunu alabilirsiniz.

DialogResult yalnızca bir Window yöntemi çağrılarak ShowDialog açıldığında ayarlanabilir.

Not

Bir pencere tarayıcıda barındırıldığında bu özelliği ayarlayamaz veya alamazsınız.

Şunlara uygulanır