ダイアログボックスの概要

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

通常、スタンドアロンアプリケーションにはメインウィンドウがあります。ここには、アプリケーションが処理を行うメインデータが表示されるほか、メニューバー、ツールバー、ステータスバーのようなユーザーインターフェイス (UI) メカニズムによってそのデータを処理する機能も表示されます。また、高度なアプリケーションでは、次の処理を行うウィンドウも表示されます。

ユーザーに特定の情報を表示する。
ユーザーから情報を収集する。
情報の表示と収集の両方を行う。

これらの種類のウィンドウは、ダイアログボックスと呼ばれ、モーダルおよびモードレスの 2 種類があります。

モーダルダイアログボックスは、関数が続行するためにユーザーからの追加データを必要とする場合に、関数により表示されます。関数は、データを収集するためにモーダルダイアログボックスを必要とするため、このダイアログボックスが開いている間、ユーザーはアプリケーションで他のウィンドウをアクティブにすることができません。ほとんどの場合、モーダルダイアログボックスでは、ユーザーが [OK] ボタンまたは [キャンセル] ボタンをクリックすることにより、モーダルダイアログボックスを終了することを通知できます。[OK] ボタンのクリックは、ユーザーがデータの入力を完了し、関数がそのデータの処理を継続することを示します。[キャンセル] ボタンのクリックは、関数が実行を完全に停止することを意味します。モーダルダイアログボックスの最も一般的な例は、データを開く、保存する、および印刷するダイアログボックスです。

一方、モードレスダイアログボックスでは、このダイアログボックスが開いている間、ユーザーが他のウィンドウをアクティブにすることができます。たとえば、ユーザーがドキュメント内で特定の単語の出現箇所を検索する場合は、一般に、メインウィンドウ上に検索対象の単語の入力を求めるダイアログボックスが開きます。ただし、単語の検索中でもユーザーがドキュメントを編集することはできるので、このダイアログボックスがモーダルである必要はありません。モードレスダイアログボックスには、少なくともダイアログボックスを閉じるための閉じるボタンがあります。また、単語検索の検索条件と一致する次の単語を検索する [次を検索] ボタンなど、特定の関数を実行する他のボタンが存在することもあります。

Windows Presentation Foundation (WPF) では、メッセージボックス、コモンダイアログボックス、およびカスタムダイアログボックスなど、複数の種類のダイアログボックスを作成できます。ここでは、それぞれのダイアログボックスの種類について説明します。各種類に対応するサンプルについては、「ダイアログボックスのサンプル」を参照してください。

このトピックには次のセクションが含まれています。

メッセージボックス
コモンダイアログボックス
カスタムダイアログボックス
関連トピック

メッセージボックス

メッセージボックスは、テキスト情報を表示し、ユーザーにボタンによる判断を求めるために使用できるダイアログボックスです。テキスト情報を表示し、質問を表示したうえで、質問に回答するための 3 つのボタンを表示するメッセージボックスを次の図に示します。

[ワードプロセッサ] ダイアログボックス

メッセージボックスを作成するには、MessageBox クラスを使用します。MessageBox を使用すると、次のようなコードを使用して、メッセージボックスのテキスト、タイトル、アイコン、およびボタンを構成できます。

メッセージボックスを表示するには、次のコードに示すように static Show メソッドを呼び出します。

メッセージボックスを表示するコードが、ユーザーの決定 (ボタンを押す) の検出と処理を行う必要がある場合、コードは次のコードに示すようにメッセージボックスの結果を検査できます。

メッセージボックスの使い方の詳細については、「MessageBox」、「MessageBox のサンプル」、および「ダイアログボックスのサンプル」を参照してください。

MessageBox を使用すると、ダイアログボックスの単純なユーザーエクスペリエンスを実現できますが、MessageBox を使用することの利点は、XAML ブラウザアプリケーション (XBAP) などの部分信頼セキュリティサンドボックス内で実行されているアプリケーションによって表示可能なウィンドウは、このウィンドウだけであるという点です (「Windows Presentation Foundation のセキュリティ」を参照してください)。

テキスト、選択 (チェックボックス)、相互に排他的な選択 (ラジオボタン)、およびリスト選択 (リストボックス、コンボボックス、ドロップダウンリストボックス) など、ほとんどのダイアログボックスは、メッセージボックスの結果よりも複雑なデータを表示および収集します。このため、Windows Presentation Foundation (WPF) では、いくつかのコモンダイアログボックスが用意されているだけでなく、独自のダイアログボックスを作成することもできます。ただし、どのダイアログボックスを使用する場合も、完全信頼で実行されるアプリケーションだけに制限されます。

コモンダイアログボックス

Windows は、ファイルを開く、保存する、印刷するためのダイアログボックスなど、すべてのアプリケーションに共通の各種の再利用可能なダイアログボックスを実装しています。これらのダイアログボックスはオペレーティングシステムにより実装されるため、オペレーティングシステムで実行されるすべてのアプリケーション間で共有できます。これは、ユーザーエクスペリエンスを一貫したものにするのに役立ちます。ユーザーが、オペレーティングシステムで用意されているダイアログボックスを、特定のアプリケーションで使い慣れている場合、他のアプリケーションでそのダイアログボックスの使用方法を学習する必要はありません。これらのダイアログボックスはすべてのアプリケーションで使用でき、一貫したユーザーエクスペリエンスを提供するのに役立つため、コモンダイアログボックスと呼ばれます。

Windows Presentation Foundation (WPF) では、ファイルを開く、保存する、印刷するためのコモンダイアログボックスが、スタンドアロンアプリケーションで使用できるように、カプセル化され、マネージクラスとして表示されています。ここでは、各ダイアログボックスについて簡単に説明します。

ファイルを開くダイアログボックス

ファイルを開くダイアログボックス (次の図を参照) は、開くファイルの名前を取得するために、ファイルを開く機能によって使用されます。

[開く] ダイアログボックス

ファイルを開くコモンダイアログボックスは OpenFileDialog クラスとして実装され、Microsoft.Win32 名前空間に存在します。この種類のダイアログボックスを作成、構成、および表示して、結果を処理する方法を次のコード例に示します。

ファイルを開くダイアログボックスの詳細については、Microsoft.Win32.OpenFileDialog を参照してください。

メモ :
OpenFileDialog は、部分信頼で実行されているアプリケーションで安全にファイル名を取得するために使用できます (「Windows Presentation Foundation のセキュリティ」を参照してください)。例については、「XBAP からの安全なファイルのアップロードのサンプル」を参照してください。

ファイルの保存ダイアログボックス

ファイルの保存ダイアログボックス (次の図を参照) は、保存するファイルの名前を取得するために、ファイルの保存機能によって使用されます。

[名前を付けて保存] ダイアログボックス

ファイルの保存コモンダイアログボックスは SaveFileDialog クラスとして実装され、Microsoft.Win32 名前空間に存在します。この種類のダイアログボックスを作成、構成、および表示して、結果を処理する方法を次のコード例に示します。

ファイルの保存ダイアログボックスの詳細については、Microsoft.Win32.SaveFileDialog を参照してください。

印刷ダイアログボックス

印刷ダイアログボックス (次の図を参照) は、ユーザーがデータの印刷に使用するプリンタを選択および構成するために、印刷機能によって使用されます。

[印刷] ダイアログボックス

印刷コモンダイアログボックスは PrintDialog クラスとして実装され、System.Windows.Controls 名前空間に存在します。この種類のダイアログボックスを作成、構成、および表示する方法を次のコード例に示します。

印刷ダイアログボックスの詳細については、System.Windows.Controls.PrintDialog を参照してください。WPF での印刷の詳細については、「印刷の概要」を参照してください。

カスタムダイアログボックス

コモンダイアログボックスは便利で、可能な場合は使用することをお勧めしますが、ドメイン固有のダイアログボックスの要件はサポートしていません。そのような場合は、独自のダイアログボックスを作成する必要があります。次に示すように、ダイアログボックスは特殊な処理を行うウィンドウです。Window は、そのような処理を実装するため、カスタムのモーダルダイアログボックスおよびモードレスダイアログボックスを作成するには、Window を使用します。

モーダルカスタムダイアログボックスの作成

このトピックでは、Window を使用して一般的なモーダルダイアログボックス実装を作成する方法について説明します。Margins ダイアログボックスを例として使用します (「ダイアログボックスのサンプル」を参照してください)。Margins ダイアログボックスを次の図に示します。

[余白] ダイアログボックス

モーダルダイアログボックスの構成

一般的なダイアログボックスのユーザーインターフェイスには、次のような機能および条件があります。

必要なデータを収集するのに必要な各種のコントロール。
ユーザーがダイアログボックスを閉じ、関数に戻って処理を続行するための [OK] ボタンを表示する。
ユーザーがダイアログボックスを閉じ、関数の処理を停止するための [キャンセル] ボタンを表示する。
タイトルバーに閉じるボタンを表示する。
アイコンを表示する。
最小化ボタン、最大化ボタン、および元に戻すボタンを表示する。
ダイアログボックスを最小化、最大化、元に戻す、および閉じるためのシステムメニューを表示する。
ダイアログボックスを開いたウィンドウの上および中央で開く。
ダイアログボックスは可能な場合はサイズを変更できる必要があり、ダイアログボックスが小さくなりすぎないように、および使用しやすい既定のサイズを提供するために、既定のサイズと最小サイズの両方をそれぞれ設定しておく必要があります。
Esc キーを押す操作は、[キャンセル] ボタンをクリックするショートカットキーとして構成する。これは、[キャンセル] ボタンの IsCancel プロパティを true に設定することによって行います。
Enter (または Return) キーを押す操作は、[OK] ボタンをクリックするショートカットキーとして構成する。これは、[OK] ボタンの IsDefault プロパティを true に設定することによって行います。

この構成の例を次に示します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.MarginsDialogBox"
    xmlns:local="clr-namespace:SDKSample"
    Title="Margins"
    Height="190"
    Width="300"
    MinHeight="10"
    MinWidth="300"
    ResizeMode="CanResizeWithGrip"
    ShowInTaskbar="False"
    WindowStartupLocation="CenterOwner" 
    FocusManager.FocusedElement="{Binding ElementName=leftMarginTextBox}">

  <Grid>


...


    <!-- Accept or Cancel -->
    <StackPanel Grid.Column="0" Grid.ColumnSpan="2" Grid.Row="4">
      <Button Name="okButton" Click="okButton_Click" IsDefault="True">OK</Button>
      <Button Name="cancelButton" IsCancel="True">Cancel</Button>
    </StackPanel>

  </Grid >

</Window>

Imports System.Windows ' Window, RoutedEventArgs, IInputElement, DependencyObject
Imports System.Windows.Controls ' Validation
Imports System.Windows.Input ' Keyboard

Namespace SDKSample


Public Class MarginsDialogBox
    Inherits Window
    Public Sub New()
        Me.InitializeComponent()
    End Sub


...


End Class

End Namespace

using System.Windows; // Window, RoutedEventArgs, IInputElement, DependencyObject
using System.Windows.Controls; // Validation
using System.Windows.Input; // Keyboard

namespace SDKSample
{
    public partial class MarginsDialogBox : Window
    {
        public MarginsDialogBox()
        {
            InitializeComponent();
        }


...


    }
}

ダイアログボックスに関するユーザーエクスペリエンスは、ダイアログボックスを開くウィンドウのメニューバーにも及びます。関数が続行するためにダイアログボックスを介したユーザー操作を必要とする関数が、メニュー項目により実行された場合、この例に示されているように関数のメニュー項目のヘッダーに省略記号が表示されます。

<!--Main Window-->


...


<MenuItem Name="formatMarginsMenuItem" Header="_Margins..." Click="formatMarginsMenuItem_Click" />

[バージョン情報] ダイアログボックスなど、ユーザー操作を必要としないダイアログボックスを表示する関数がメニュー項目により実行された場合、省略記号は不要です。

モーダルダイアログボックスを開く

ダイアログボックスは、ワードプロセッサで文書の余白を設定するなど、通常ユーザーがメニュー項目を選択してドメイン固有の関数を実行した結果として表示されます。ウィンドウをダイアログボックスとして表示することは、通常のウィンドウを表示するのと同様ですが、ダイアログボックス固有の追加構成が必要です。ダイアログボックスを初期化する、構成する、および開く処理全体を次のコード例に示します。

Imports System '  EventArgs
Imports System.ComponentModel '  CancelEventArgs
Imports System.Windows '  Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls '  TextChangedEventArgs
Imports Microsoft.Win32 '  OpenFileDialog

Namespace SDKSample

Public Class MainWindow
    Inherits Window


...


Private Sub formatMarginsMenuItem_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Instantiate the dialog box
    Dim dlg As New MarginsDialogBox

    ' Configure the dialog box
    dlg.Owner = Me
    dlg.DocumentMargin = Me.documentTextBox.Margin

    ' Open the dialog box modally 
    dlg.ShowDialog()



...


End Sub


...


End Class

End Namespace

using System; // EventArgs
using System.ComponentModel; // CancelEventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextChangedEventArgs
using Microsoft.Win32; // OpenFileDialog

namespace SDKSample
{
    public partial class MainWindow : Window
    {


...


void formatMarginsMenuItem_Click(object sender, RoutedEventArgs e)
{
    // Instantiate the dialog box
    MarginsDialogBox dlg = new MarginsDialogBox();

    // Configure the dialog box
    dlg.Owner = this;
    dlg.DocumentMargin = this.documentTextBox.Margin;

    // Open the dialog box modally 
    dlg.ShowDialog();



...


}


...


    }
}

ここでは、このコードはダイアログボックスに既定の情報 (現在の余白) を渡しています。また、Window.Owner プロパティに、ダイアログボックスを表示しているウィンドウへの参照も設定しています。通常、すべてのダイアログボックスに共通する、ウィンドウの状態関連の動作を提供するには、必ずダイアログボックスの所有者を設定する必要があります (詳細については「WPF ウィンドウの概要」を参照してください)。

メモ :
ダイアログボックスでユーザーインターフェイス (UI) オートメーションをサポートするには、所有者を指定する必要があります (「UI オートメーションの概要」を参照してください)。

ダイアログボックスを構成した後で ShowDialog メソッドを呼び出すと、ダイアログボックスがモーダルで表示されます。

ユーザー指定のデータの検証

ダイアログボックスが開き、ユーザーが必要なデータを入力する際、次の理由により、ダイアログボックスは入力されたデータが有効であることを確認する必要があります。

セキュリティ上の観点から、すべての入力を検証する必要があります。
ドメイン固有の観点では、データを検証することで、誤入力データがコードで処理されたため、例外がスローされる可能性を排除します。
ユーザーエクペリエンスの観点では、入力データの中で間違っていたものを表示することによって、ユーザーを支援します。
パフォーマンスの観点では、多階層アプリケーションでデータを検証することで、特にアプリケーションが Web サービスまたはサーバーベースのデータベースで構成されている場合に、クライアント層とアプリケーション層の間のラウンドトリップ数が減少します。

WPF でバインドされたコントロールを検証するには、検証規則を作成し、その規則を該当するバインディングに関連付ける必要があります。検証規則は ValidationRule から派生するカスタムクラスです。バインドされた値が Double であり、指定した範囲内にあることを確認する MarginValidationRule を次の例に示します。

Imports System.Globalization
Imports System.Windows.Controls

Namespace SDKSample

Public Class MarginValidationRule
    Inherits ValidationRule

    Private _maxMargin As Double
    Private _minMargin As Double

    Public Property MaxMargin() As Double
        Get
            Return Me._maxMargin
        End Get
        Set(ByVal value As Double)
            Me._maxMargin = value
        End Set
    End Property

    Public Property MinMargin() As Double
        Get
            Return Me._minMargin
        End Get
        Set(ByVal value As Double)
            Me._minMargin = value
        End Set
    End Property

    Public Overrides Function Validate(ByVal value As Object, ByVal cultureInfo As CultureInfo) As ValidationResult

        Dim margin As Double

        ' Is a number?
        If Not Double.TryParse(CStr(value), margin) Then
            Return New ValidationResult(False, "Not a number.")
        End If

        ' Is in range?
        If ((margin < Me.MinMargin) OrElse (margin > Me.MaxMargin)) Then
            Dim msg As String = String.Format("Margin must be between {0} and {1}.", Me.MinMargin, Me.MaxMargin)
            Return New ValidationResult(False, msg)
        End If

        ' Number is valid
        Return New ValidationResult(True, Nothing)

    End Function

End Class

End Namespace

using System.Globalization;
using System.Windows.Controls;

namespace SDKSample
{
    public class MarginValidationRule : ValidationRule
    {
        double minMargin;
        double maxMargin;

        public double MinMargin
        {
            get { return this.minMargin; }
            set { this.minMargin = value; }
        }

        public double MaxMargin
        {
            get { return this.maxMargin; }
            set { this.maxMargin = value; }
        }

        public override ValidationResult Validate(object value, CultureInfo cultureInfo)
        {
            double margin;

            // Is a number?
            if (!double.TryParse((string)value, out margin))
            {
                return new ValidationResult(false, "Not a number.");
            }

            // Is in range?
            if ((margin < this.minMargin) || (margin > this.maxMargin))
            {
                string msg = string.Format("Margin must be between {0} and {1}.", this.minMargin, this.maxMargin);
                return new ValidationResult(false, msg);
            }

            // Number is valid
            return new ValidationResult(true, null);
        }
    }
}

このコードでは、データを検証して該当する ValidationResult を返す Validate メソッドをオーバーライドすることにより、検証規則の検証ロジックが実装されます。

バインドされたコントロールに検証規則を関連付けるには、次のマークアップを使用します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.MarginsDialogBox"
    xmlns:local="clr-namespace:SDKSample"
    Title="Margins"
    Height="190"
    Width="300"
    MinHeight="10"
    MinWidth="300"
    ResizeMode="CanResizeWithGrip"
    ShowInTaskbar="False"
    WindowStartupLocation="CenterOwner" 
    FocusManager.FocusedElement="{Binding ElementName=leftMarginTextBox}">

  <Grid>



...


<Label Grid.Column="0" Grid.Row="0">Left Margin:</Label>
<TextBox Name="leftMarginTextBox" Grid.Column="1" Grid.Row="0">
  <TextBox.Text>
    <Binding Path="Left" UpdateSourceTrigger="PropertyChanged">
      <Binding.ValidationRules>
        <local:MarginValidationRule MinMargin="0" MaxMargin="10" />
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>


...


</Window>

検証規則を関連付けた後、バインドされたコントロールにデータが入力されると、WPF は検証規則を自動的に適用します。コントロールに無効なデータが含まれている場合、次の図に示すように、WPF は無効なコントロールの周りに赤い境界線を表示します。

無効な左余白

WPF では、有効なデータが入力されるまでユーザーを無効なコントロールに縛り付けることはありません。この動作はダイアログボックスに適しています。ユーザーは、入力したデータが有効かどうかに関係なく、ダイアログボックス内のコントロール群を自由に移動できる必要があります。ただし、これは、ユーザーが無効なデータを入力して [OK] ボタンをクリックできることを意味します。したがって、Click イベントを処理することにより [OK] ボタンがクリックされた場合、コードでダイアログボックス内のすべてのコントロールを検証することも必要です。

Imports System.Windows ' Window, RoutedEventArgs, IInputElement, DependencyObject
Imports System.Windows.Controls ' Validation
Imports System.Windows.Input ' Keyboard

Namespace SDKSample


Public Class MarginsDialogBox
    Inherits Window


...


Private Sub okButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Don't accept the dialog box if there is invalid data
    If Not Me.IsValid(Me) Then Return


...


    End Sub

    ' Validate all dependency objects in a window
    Private Function IsValid(ByVal node As DependencyObject) As Boolean

        ' Check if dependency object was passed and if dependency object is valid.
        ' NOTE: Validation.GetHasError works for controls that have validation rules attached 
        If ((Not node Is Nothing) AndAlso Validation.GetHasError(node)) Then
            ' If the dependency object is invalid, and it can receive the focus,
            ' set the focus
            If TypeOf node Is IInputElement Then
                Keyboard.Focus(DirectCast(node, IInputElement))
            End If
            Return False
        End If

        ' If this dependency object is valid, check all child dependency objects
        Dim subnode As Object
        For Each subnode In LogicalTreeHelper.GetChildren(node)
            If (TypeOf subnode Is DependencyObject AndAlso Not Me.IsValid(DirectCast(subnode, DependencyObject))) Then
                ' If a child dependency object is invalid, return false immediately,
                ' otherwise keep checking
                Return False
            End If
        Next

        ' All dependency objects are valid
        Return True

    End Function

End Class

End Namespace

using System.Windows; // Window, RoutedEventArgs, IInputElement, DependencyObject
using System.Windows.Controls; // Validation
using System.Windows.Input; // Keyboard

namespace SDKSample
{
    public partial class MarginsDialogBox : Window
    {


...


void okButton_Click(object sender, RoutedEventArgs e)
{
    // Don't accept the dialog box if there is invalid data
    if (!IsValid(this)) return;


...


        }

        // Validate all dependency objects in a window
        bool IsValid(DependencyObject node)
        {
            // Check if dependency object was passed
            if (node != null)
            {
                // Check if dependency object is valid.
                // NOTE: Validation.GetHasError works for controls that have validation rules attached 
                bool isValid = !Validation.GetHasError(node);
                if (!isValid)
                {
                    // If the dependency object is invalid, and it can receive the focus,
                    // set the focus
                    if (node is IInputElement) Keyboard.Focus((IInputElement)node);
                    return false;
                }
            }

            // If this dependency object is valid, check all child dependency objects
            foreach (object subnode in LogicalTreeHelper.GetChildren(node))
            {
                if (subnode is DependencyObject)
                {   
                    // If a child dependency object is invalid, return false immediately,
                    // otherwise keep checking
                    if (IsValid((DependencyObject)subnode) == false) return false;
                }
            }

            // All dependency objects are valid
            return true;
        }
    }
}

このコードは、ウィンドウ上のすべての依存関係オブジェクトを列挙します。無効なオブジェクトがある場合は (GetHasError によって返される値で判断)、無効なコントロールがフォーカスを取得し、IsValid メソッドが false を返し、ウィンドウが無効と見なされます。

ダイアログボックスが有効である場合は、安全に閉じ、制御を返すことができます。返す処理の一部として、結果を呼び出し元の関数に返す必要があります。

モーダルダイアログボックスの結果の設定

ShowDialog を使用してダイアログボックスを開くのは、基本的にはメソッドの呼び出しと似ています。ShowDialog を使用してダイアログボックスを開いたコードは、ShowDialog から制御が返されるまで待機します。ShowDialog から制御が返されると、呼び出し元のコードは、ユーザーが [OK] ボタンをクリックしたか [キャンセル] ボタンをクリックしたかに基づいて、処理を続行するか停止するかを決定する必要があります。この決定を行いやすくするため、ダイアログボックスはユーザーの選択内容を、ShowDialog メソッドから返された Boolean 値として返す必要があります。

[OK] ボタンがクリックされた場合、ShowDialog は true を返す必要があります。これは、[OK] ボタンがクリックされた場合のダイアログボックスの DialogResult プロパティを設定することによって行います。

DialogResult プロパティを設定すると、ウィンドウが自動的に閉じられるため、Close を明示的に呼び出す手間を省くことができます。

[キャンセル] ボタンがクリックされた場合、ShowDialog は false を返す必要があります。さらに、DialogResult プロパティも設定する必要があります。

Imports System.Windows ' Window, RoutedEventArgs, IInputElement, DependencyObject
Imports System.Windows.Controls ' Validation
Imports System.Windows.Input ' Keyboard

Namespace SDKSample


Public Class MarginsDialogBox
    Inherits Window


...


Private Sub cancelButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Dialog box canceled
    Me.DialogResult = False
End Sub


...


End Class

End Namespace

using System.Windows; // Window, RoutedEventArgs, IInputElement, DependencyObject
using System.Windows.Controls; // Validation
using System.Windows.Input; // Keyboard

namespace SDKSample
{
    public partial class MarginsDialogBox : Window
    {


...


void cancelButton_Click(object sender, RoutedEventArgs e)
{
    // Dialog box canceled
    this.DialogResult = false;
}


...


    }
}

ボタンの IsCancel プロパティが true に設定された状態で、ユーザーが [キャンセル] ボタンまたは Esc キーを押した場合は、DialogResult が自動的に false に設定されます。次のマークアップには、Click イベントを処理しなくても、前のコードと同じ効果があります。

<Button Name="cancelButton" IsCancel="True">Cancel</Button>

ダイアログボックスは、ユーザーがタイトルバーの閉じるボタンをクリックするか、システムメニューの [閉じる] メニュー項目を選択すると、結果として自動的に true を返します。

モーダルダイアログボックスから返されたデータの処理

DialogResult がダイアログボックスによって設定されると、ダイアログボックスを開いた関数は、ShowDialog から制御が返されたときに、DialogResult プロパティを調べてそのダイアログボックスの結果を取得できます。

Imports System '  EventArgs
Imports System.ComponentModel '  CancelEventArgs
Imports System.Windows '  Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls '  TextChangedEventArgs
Imports Microsoft.Win32 '  OpenFileDialog

Namespace SDKSample

Public Class MainWindow
    Inherits Window


...


Private Sub formatMarginsMenuItem_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)


...


    ' Process data entered by user if dialog box is accepted
    If (dlg.DialogResult.GetValueOrDefault = True) Then
        Me.documentTextBox.Margin = dlg.DocumentMargin
    End If
End Sub


...


End Class

End Namespace

using System; // EventArgs
using System.ComponentModel; // CancelEventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextChangedEventArgs
using Microsoft.Win32; // OpenFileDialog

namespace SDKSample
{
    public partial class MainWindow : Window
    {


...


void formatMarginsMenuItem_Click(object sender, RoutedEventArgs e)
{


...


    // Process data entered by user if dialog box is accepted
    if (dlg.DialogResult == true)
    {
        // Update fonts
        this.documentTextBox.Margin = dlg.DocumentMargin;
    }
}


...


    }
}

ダイアログの結果が true になった場合、関数はユーザーが入力した値の取得および処理を開始します。

メモ :
ShowDialog から制御が返された後は、ダイアログボックスを再度開くことはできません。代わりに、新しいインスタンスを作成する必要があります。

ダイアログの結果が false の場合、関数は処理を適切に終了する必要があります。

モードレスカスタムダイアログボックスの作成

次の図に示されている FindDialogBox のようなモードレスダイアログボックスは、基本的な外観はモーダルダイアログボックスと同じです。

[検索] ダイアログボックス

ただし、以下のセクションで説明するように、動作は若干異なります。

モードレスダイアログボックスを開く

モードレスダイアログボックスは Show メソッドを呼び出すことによって開かれます。

<!--Main Window-->

Imports System '  EventArgs
Imports System.ComponentModel '  CancelEventArgs
Imports System.Windows '  Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls '  TextChangedEventArgs
Imports Microsoft.Win32 '  OpenFileDialog

Namespace SDKSample

Public Class MainWindow
    Inherits Window


...


Private Sub editFindMenuItem_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim dlg As New FindDialogBox(Me.documentTextBox)
    dlg.Owner = Me
    AddHandler dlg.TextFound, New TextFoundEventHandler(AddressOf Me.dlg_TextFound)
    dlg.Show()
End Sub

using System; // EventArgs
using System.ComponentModel; // CancelEventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextChangedEventArgs
using Microsoft.Win32; // OpenFileDialog

namespace SDKSample
{
    public partial class MainWindow : Window
    {


...


void editFindMenuItem_Click(object sender, RoutedEventArgs e)
{
    // Instantiate the dialog box
    FindDialogBox dlg = new FindDialogBox(this.documentTextBox);

    // Configure the dialog box
    dlg.Owner = this;
    dlg.TextFound += new TextFoundEventHandler(dlg_TextFound);

    // Open the dialog box modally
    dlg.Show();
}


...


    }
}

ShowDialog とは異なり、Show はすぐに制御が戻ります。このため、呼び出し元のウィンドウは、モードレスダイアログボックスが閉じられるタイミングを判別できません。したがって、ダイアログボックスの結果を確認したり、ダイアログボックスからデータを取得してさらに処理したりするタイミングも認識できません。ダイアログボックスは、呼び出し元のウィンドウにデータを返して処理を託すために、別の方法を用意する必要があります。

モードレスダイアログボックスから返されたデータの処理

この例では、FindDialogBox は、頻度を特に指定せずに検索されているテキストに応じて、1 つ以上の検索結果をメインウィンドウに返す場合があります。モーダルダイアログボックスと同様に、モードレスダイアログボックスはプロパティを使用して結果を返すことができます。ただし、ダイアログボックスを所有しているウィンドウで、これらのプロパティを確認するタイミングを認識できる必要があります。これを実現する方法の 1 つは、テキストが検出されるたびに発生するイベントをダイアログボックスに実装することです。FindDialogBox は、この目的で TextFoundEvent を実装しています。これには、まずデリゲートが必要です。

Namespace SDKSample
Public Delegate Sub TextFoundEventHandler(ByVal sender As Object, ByVal e As EventArgs)
End Namespace

using System;
namespace SDKSample
{
    public delegate void TextFoundEventHandler(object sender, EventArgs e);
}

TextFoundEventHandler デリゲートを使用して、FindDialogBox は TextFoundEvent を実装します。

Imports System ' EventArgs
Imports System.Windows ' Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls ' TextBox, TextChangedEventArgs
Imports System.Text.RegularExpressions ' Regex

Namespace SDKSample

Public Class FindDialogBox
    Inherits Window
    Public Event TextFound As TextFoundEventHandler
    Protected Overridable Sub OnTextFound()
        RaiseEvent TextFound(Me, EventArgs.Empty)
    End Sub


...


End Class

End Namespace

using System; // EventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextBox, TextChangedEventArgs
using System.Text.RegularExpressions; // Regex

namespace SDKSample
{
    public partial class FindDialogBox : Window
    {
        public event TextFoundEventHandler TextFound;
        protected virtual void OnTextFound()
        {
            TextFoundEventHandler textFound = this.TextFound;
            if (textFound != null) textFound(this, EventArgs.Empty);
        }


...


    }
}

これにより、Find は検索結果が見つかったときに、このイベントを発生させることができます。

Imports System ' EventArgs
Imports System.Windows ' Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls ' TextBox, TextChangedEventArgs
Imports System.Text.RegularExpressions ' Regex

Namespace SDKSample

Public Class FindDialogBox
    Inherits Window


...


Private Sub findNextButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)


...


Me.Index = match.Index
Me.Length = match.Length
RaiseEvent TextFound(Me, EventArgs.Empty)


...


End Sub


...


End Class

End Namespace

using System; // EventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextBox, TextChangedEventArgs
using System.Text.RegularExpressions; // Regex

namespace SDKSample
{
    public partial class FindDialogBox : Window
    {


...


void findNextButton_Click(object sender, RoutedEventArgs e)
{


...


// Text found
this.index = match.Index;
this.length = match.Length;
OnTextFound();


...


}


...


    }
}

次に、オーナーウィンドウはこのイベントを登録し、処理する必要があります。

Imports System '  EventArgs
Imports System.ComponentModel '  CancelEventArgs
Imports System.Windows '  Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls '  TextChangedEventArgs
Imports Microsoft.Win32 '  OpenFileDialog

Namespace SDKSample

Public Class MainWindow
    Inherits Window


...


    Private Sub dlg_TextFound(ByVal sender As Object, ByVal e As EventArgs)
        Dim dlg As FindDialogBox = DirectCast(sender, FindDialogBox)
        Me.documentTextBox.Select(dlg.Index, dlg.Length)
        Me.documentTextBox.Focus()
    End Sub

End Class

End Namespace

using System; // EventArgs
using System.ComponentModel; // CancelEventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextChangedEventArgs
using Microsoft.Win32; // OpenFileDialog

namespace SDKSample
{
    public partial class MainWindow : Window
    {


...


        void dlg_TextFound(object sender, EventArgs e)
        {
            // Get the find dialog box that raised the event
            FindDialogBox dlg = (FindDialogBox)sender;

            // Get find results and select found text
            this.documentTextBox.Select(dlg.Index, dlg.Length);
            this.documentTextBox.Focus();
        }
    }
}

モードレスダイアログボックスを閉じる

DialogResult を設定する必要はないため、モードレスダイアログボックスは、システムに用意されている次のような機能を使用して閉じることができます。

タイトルバーの閉じるボタンをクリックする。
Alt キーを押しながら F4 キーを押す。
システムメニューの [閉じる] をクリックする。

または、閉じるボタンがクリックされたときに、コードによって Close を呼び出すことができます。

Imports System ' EventArgs
Imports System.Windows ' Window, MessageBoxXxx, RoutedEventArgs
Imports System.Windows.Controls ' TextBox, TextChangedEventArgs
Imports System.Text.RegularExpressions ' Regex

Namespace SDKSample

Public Class FindDialogBox
    Inherits Window


...


    Private Sub closeButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        MyBase.Close()
    End Sub
End Class

End Namespace

using System; // EventArgs
using System.Windows; // Window, MessageBoxXxx, RoutedEventArgs
using System.Windows.Controls; // TextBox, TextChangedEventArgs
using System.Text.RegularExpressions; // Regex

namespace SDKSample
{
    public partial class FindDialogBox : Window
    {


...


        void closeButton_Click(object sender, RoutedEventArgs e)
        {
            // Close dialog box
            this.Close();
        }
    }
}

参照

処理手順

ダイアログボックスのサンプル

ウィザードのサンプル

ColorPicker カスタムコントロールのサンプル

フォントダイアログボックスのデモ

概念

ポップアップの概要

Share via

ダイアログボックスの概要

メッセージボックス

コモンダイアログボックス

ファイルを開くダイアログボックス

ファイルの保存ダイアログボックス

印刷ダイアログボックス

カスタムダイアログボックス

モーダルカスタムダイアログボックスの作成

モーダルダイアログボックスの構成

モーダルダイアログボックスを開く

ユーザー指定のデータの検証

モーダルダイアログボックスの結果の設定

モーダルダイアログボックスから返されたデータの処理

モードレスカスタムダイアログボックスの作成

モードレスダイアログボックスを開く

モードレスダイアログボックスから返されたデータの処理

モードレスダイアログボックスを閉じる

参照

処理手順

概念

その他のリソース

Share via

ダイアログ ボックスの概要

メッセージ ボックス

コモン ダイアログ ボックス

ファイルを開くダイアログ ボックス

ファイルの保存ダイアログ ボックス

印刷ダイアログ ボックス

カスタム ダイアログ ボックス

モーダル カスタム ダイアログ ボックスの作成

モーダル ダイアログ ボックスの構成

モーダル ダイアログ ボックスを開く

ユーザー指定のデータの検証

モーダル ダイアログ ボックスの結果の設定

モーダル ダイアログ ボックスから返されたデータの処理

モードレス カスタム ダイアログ ボックスの作成

モードレス ダイアログ ボックスを開く

モードレス ダイアログ ボックスから返されたデータの処理

モードレス ダイアログ ボックスを閉じる

参照

処理手順

概念

その他のリソース

ダイアログボックスの概要

メッセージボックス

コモンダイアログボックス

ファイルを開くダイアログボックス

ファイルの保存ダイアログボックス

印刷ダイアログボックス

カスタムダイアログボックス

モーダルカスタムダイアログボックスの作成

モーダルダイアログボックスの構成

モーダルダイアログボックスを開く

モーダルダイアログボックスの結果の設定

モーダルダイアログボックスから返されたデータの処理

モードレスカスタムダイアログボックスの作成

モードレスダイアログボックスを開く

モードレスダイアログボックスから返されたデータの処理

モードレスダイアログボックスを閉じる