WPF ウィンドウの概要

[アーティクル]
08/09/2011

ユーザーは、ウィンドウをとおして Windows Presentation Foundation (WPF) スタンドアロンアプリケーションとやり取りします。ウィンドウの主な目的は、データを視覚化してユーザーがデータと対話できるようにするコンテンツをホストすることです。スタンドアロンの WPF アプリケーションには、Window クラスを使用した独自のウィンドウがあります。ここでは、Window について説明してから、スタンドアロンアプリケーションにおけるウィンドウの作成と管理の基本について説明します。

メモ
XAML browser applications (XBAPs) や Loose Extensible Application Markup Language (XAML) のページなど、ブラウザーによってホストされる WPF アプリケーションには、独自のウィンドウはありません。その代わり、Windows Internet Explorer で提供されるウィンドウでホストされます。「WPF XAML ブラウザーアプリケーションの概要」を参照してください。

XAML browser applications (XBAPs) や Loose Extensible Application Markup Language (XAML) のページなど、ブラウザーによってホストされる WPF アプリケーションには、独自のウィンドウはありません。その代わり、Windows Internet Explorer で提供されるウィンドウでホストされます。「WPF XAML ブラウザーアプリケーションの概要」を参照してください。

このトピックは、次のセクションで構成されています。

ウィンドウクラス
ウィンドウの実装
MSBuild 用のウィンドウ定義の構成
ウィンドウの有効期間
ウィンドウの位置
ウィンドウのサイズ
サイズ設定プロパティの優先順位
ウィンドウの状態
ウィンドウの外観
セキュリティの考慮事項
その他の種類のウィンドウ
関連トピック

ウィンドウクラス

次の図は、ウィンドウの構成部品を示しています。

ウィンドウ要素

ウィンドウは、非クライアント領域とクライアント領域の 2 つに分かれます。

ウィンドウの非クライアント領域は、WPF によって実装され、多くのウィンドウに共通のウィンドウ部品が含まれます。これらの部品には次のものがあります。

境界線
タイトルバー
アイコン
最小化ボタン、最大化ボタン、および復元ボタン
閉じるボタン。
ウィンドウを最小化、最大化、元のサイズに戻す、移動、サイズ変更、および閉じるためのメニュー項目を含むシステムメニュー。

ウィンドウのクライアント領域は、ウィンドウの非クライアント領域の内側の領域であり、開発者が使用して、メニューバー、ツールバー、コントロールなどのアプリケーション固有のコンテンツを追加します。

WPF では、ウィンドウは Window クラスでカプセル化され、これにより以下の操作を行うことができます。

ウィンドウを表示する。
ウィンドウのサイズ、位置、および外観を構成する。
アプリケーション固有のコンテンツをホストする。
ウィンドウの有効期間を管理する。

ウィンドウの実装

一般的なウィンドウの実装は、外観と動作で構成されます。外観では、ユーザーに対するウィンドウの表示方法を定義します。動作では、ユーザーがウィンドウと対話するときにウィンドウが機能を果たす方法を定義します。 WPF では、コードまたは XAML マークアップを使用して、ウィンドウの外観と動作を実装できます。

ただし、通常は、次の例に示すように、XAML マークアップを使用してウィンドウの外観を実装し、分離コードを使用してウィンドウの動作を実装します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.MarkupAndCodeBehindWindow">

  <!-- Client area (for content) -->

</Window>


Imports System.Windows ' Window

Namespace SDKSample
    Partial Public Class MarkupAndCodeBehindWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub
    End Class
End Namespace

using System.Windows; // Window

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

XAML マークアップファイルと分離コードファイルを連携させるには、次のことが必要です。

マークアップの Window 要素に、x:Class 属性を含める必要があります。アプリケーションのビルド時にマークアップファイルに x:Class 属性が含まれていると、Microsoft build engine (MSBuild) は、x:Class 属性で指定された名前を持つ、Window から派生したpartialクラスを作成します。そのためには、XAML スキーマ (xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml") に XML 名前空間宣言を追加する必要があります。生成されたpartialクラスは InitializeComponent メソッドを実装します。このメソッドを呼び出すとイベントが登録され、マークアップで実装されるプロパティが設定されます。
分離コードでは、クラスは、マークアップ内の x:Class 属性で指定されている名前を持つpartialクラスでなければなりません。また、Window から派生する必要があります。これによって、分離コードファイルと、アプリケーションのビルド時にマークアップファイル用に生成されるpartialクラスとが関連付けられます (「WPF アプリケーション (WPF) のビルド」を参照)。
分離コードでは、Window クラスが実装するコンストラクターで InitializeComponent メソッドを呼び出す必要があります。 InitializeComponent は、マークアップファイル用に生成された partial クラスによって実装されるもので、イベントの登録と、マークアップで定義されたプロパティの設定を実行します。

メモ
Microsoft Visual Studio を使用してプロジェクトに新しい Window を追加すると、ここで説明したように、マークアップと分離コードの両方を使用して Window が実装され、マークアップファイルと分離コードファイル間の関連付けの作成に必要な構成が組み込まれます。

この構成が組み込まれると、XAML マークアップでウィンドウの外観を定義し、分離コードでウィンドウの動作を実装することに集中できます。ボタンを含むウィンドウを XAML マークアップで実装し、そのボタンの Click イベントのイベントハンドラーを分離コードで実装する例を次に示します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.MarkupAndCodeBehindWindow">
  <!-- Client area (for content) -->
  <Button Click="button_Click">Click This Button</Button>
</Window>


Imports System.Windows

Namespace SDKSample
    Partial Public Class MarkupAndCodeBehindWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            MessageBox.Show("Button was clicked.")
        End Sub
    End Class
End Namespace

using System.Windows;

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

        void button_Click(object sender, RoutedEventArgs e)
        {
            MessageBox.Show("Button was clicked.");
        }
    }
}

MSBuild 用のウィンドウ定義の構成

ウィンドウを実装する方法によって、MSBuild を構成する方法が決定します。 XAML マークアップと分離コードの両方を使用して定義したウィンドウには、次の要件があります。

XAML マークアップファイルは、MSBuild の Page 項目として構成する必要があります。
分離コードファイルは、MSBuild の Compile 項目として構成する必要があります。

これを次の MSBuild プロジェクトファイルに示します。

<Project ... xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    ...
    <Page Include="MarkupAndCodeBehindWindow.xaml" />
    <Compile Include=" MarkupAndCodeBehindWindow.xaml.cs" />
    ...
</Project>

WPF アプリケーションのビルドの詳細については、「WPF アプリケーション (WPF) のビルド」を参照してください。

ウィンドウの有効期間

クラスと同様に、ウィンドウにも有効期間があります。有効期間は、ウィンドウが開いてインスタンス化されたときに開始し、アクティブ化と非アクティブ化を経て、最後に閉じられるまで継続します。

ここでは、次の項目について説明します。

ウィンドウを開く
ウィンドウのアクティブ化
ウィンドウを閉じる
ウィンドウの有効期間イベント

ウィンドウを開く

ウィンドウを開くには、次の例に示すように最初にインスタンスを作成します。

<Application
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.App"
    Startup="app_Startup">
</Application>


Imports System.Windows

Namespace SDKSample
    Partial Public Class App
        Inherits Application
        Private Sub app_Startup(ByVal sender As Object, ByVal e As StartupEventArgs)
            ' Create a window
            Dim window As New MarkupAndCodeBehindWindow()

            ' Open a window
            window.Show()
        End Sub
    End Class
End Namespace

using System.Windows;
namespace SDKSample
{
    public partial class App : Application
    {
        void app_Startup(object sender, StartupEventArgs e)
        {
            // Create a window
            MarkupAndCodeBehindWindow window = new MarkupAndCodeBehindWindow();

            // Open a window
            window.Show();
        }
    }
}

この例では、Startup イベントが発生してアプリケーションが起動するときに MarkupAndCodeBehindWindow がインスタンス化されます。

ウィンドウがインスタンス化されると、Application オブジェクトが管理するウィンドウのリストにそのウィンドウへの参照が自動的に追加されます (Application.Windows を参照)。さらに、インスタンス化される最初のウィンドウは、既定で Application によってメインアプリケーションウィンドウとして設定されます (Application.MainWindow を参照)。

最後に Show メソッドを呼び出すことによってウィンドウが開き、次の図に示すような結果になります。

Window.Show の呼び出しによって開いたウィンドウ

Show を呼び出すことによって開いたウィンドウは、モードレスウィンドウです。これは、ユーザーが同じアプリケーションで他のウィンドウをアクティブ化できるモードでアプリケーションが動作することを意味します。

メモ
ShowDialog は、ダイアログボックスなどのウィンドウをモーダルで開くために呼び出されます。詳細については、「ダイアログボックスの概要」を参照してください。

Show を呼び出すと、ウィンドウは表示される前に初期化処理を実行して、ユーザーの入力を受け取ることのできるインフラストラクチャを確立します。ウィンドウが初期化されると、SourceInitialized イベントが発生し、ウィンドウが表示されます。

簡単な方法として、StartupUri を設定して、アプリケーションの起動時に自動的に開く最初のウィンドウを指定できます。

<Application
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.App"
    StartupUri="PlainWindow.xaml" />

アプリケーションが起動したら、StartupUri の値で指定されたウィンドウがモードレスで開きます。内部的には、ウィンドウはその Show メソッドを呼び出すことによって開きます。

ウィンドウの所有権

Show メソッドを使用して開いたウィンドウと、そのウィンドウを作成したウィンドウには、暗黙的な関係はありません。ユーザーは、どちらのウィンドウとも、もう一方のウィンドウに関係なく対話できます。つまり、どちらのウィンドウでも次の作業ができます。

もう一方のウィンドウの上に表示する (いずれかのウィンドウの Topmost プロパティが true に設定されている場合を除く)。
もう一方のウィンドウに影響を与えずに、最小化し、最大化し、元のサイズに戻す。

一部のウィンドウには、そのウィンドウを開いたウィンドウとの関係が必要です。たとえば、Integrated Development Environment (IDE) アプリケーションでは、プロパティウィンドウやツールウィンドウのように、一般的に作成元のウィンドウの上に表示されるウィンドウが開く場合があります。また、そのようなウィンドウは、必ず作成元のウィンドウと一緒に閉じ、最小化し、最大化し、元のサイズに戻す必要があります。このような関係を確立するには、あるウィンドウが別のウィンドウを所有するようにします。そのためには、所有されているウィンドウの Owner プロパティに、オーナーウィンドウへの参照を設定します。これを次の例に示します。

' Create a window and make this window its owner
Dim ownedWindow As New Window()
ownedWindow.Owner = Me
ownedWindow.Show()

// Create a window and make this window its owner
Window ownedWindow = new Window();
ownedWindow.Owner = this;
ownedWindow.Show();

所有権が確立されると、次のようになります。

所有されているウィンドウは Owner プロパティの値を調べることによって、オーナーウィンドウを参照できます。
オーナーウィンドウは、OwnedWindows プロパティの値を調べることによって、所有するすべてのウィンドウを検出できます。

ウィンドウのアクティブ化の防止

表示されてもアクティブにしないことが適切なウィンドウもあります。インターネットメッセンジャーのようなアプリケーションの対話ウィンドウや、電子メールアプリケーションの通知ウィンドウなどです。

表示されたときにアクティブにしないウィンドウがアプリケーションにある場合は、Show メソッドの初回呼び出し前に、ShowActivated プロパティを false に設定します。結果は次のようになります。

ウィンドウはアクティブになりません。
ウィンドウの Activated イベントは発生しません。
現在アクティブなウィンドウは、アクティブのままです。

ただし、ユーザーがクライアント領域または非クライアント領域をクリックすると、ウィンドウは直ちにアクティブになります。この場合、結果は次のようになります。

ウィンドウはアクティブになります。
ウィンドウの Activated イベントが発生します。
直前にアクティブだったウィンドウは非アクティブになります。
その後、ウィンドウの Deactivated および Activated イベントが、ユーザーの操作への応答として発生します。

ウィンドウのアクティブ化

ウィンドウを最初に開いたときは、そのウィンドウがアクティブウィンドウになります (ShowActivated が false に設定されている場合を除く)。アクティブウィンドウは、キーストロークやマウスクリックなどのユーザー入力を現在キャプチャしているウィンドウです。ウィンドウがアクティブになると、Activated イベントが発生します。

メモ
ウィンドウが最初に開くとき、Loaded イベントおよび ContentRendered イベントは、Activated イベントが発生した後にのみ発生します。そのため、ウィンドウは ContentRendered が発生した場合にのみ開いたと見なされます。

ウィンドウがアクティブになった後で、ユーザーは同じアプリケーションの別のウィンドウをアクティブ化したり、別のアプリケーションをアクティブ化したりできます。このとき、現在アクティブなウィンドウが非アクティブ化され、Deactivated イベントが発生します。同様に、ユーザーが現在非アクティブなウィンドウを選択すると、ウィンドウは再びアクティブになり、Activated が発生します。

一般に、Activated と Deactivated を処理するのは、ウィンドウがアクティブなときにのみ実行できる機能を有効または無効にするためです。たとえば、ゲームやビデオプレーヤーなど、ユーザーの一定の入力や介入が必要な双方向コンテンツが表示されるウィンドウがあります。この動作を実装するために Activated および Deactivated を処理する方法を、次の簡単なビデオプレーヤーの例で示します。

<Window
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.CustomMediaPlayerWindow"
    Activated="window_Activated"
    Deactivated="window_Deactivated">

    <!-- Media Player -->
    <MediaElement 
      Name="mediaElement" 
      Stretch="Fill" 
      LoadedBehavior="Manual" 
      Source="numbers.wmv" />

</Window>


Imports System ' EventArgs
Imports System.Windows ' Window

Namespace SDKSample
    Partial Public Class CustomMediaPlayerWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub window_Activated(ByVal sender As Object, ByVal e As EventArgs)
            ' Recommence playing media if window is activated
            Me.mediaElement.Play()
        End Sub

        Private Sub window_Deactivated(ByVal sender As Object, ByVal e As EventArgs)
            ' Pause playing if media is being played and window is deactivated
            Me.mediaElement.Pause()
        End Sub
    End Class
End Namespace

using System; // EventArgs
using System.Windows; // Window

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

        void window_Activated(object sender, EventArgs e)
        {
            // Recommence playing media if window is activated
            this.mediaElement.Play();
        }

        void window_Deactivated(object sender, EventArgs e)
        {
            // Pause playing if media is being played and window is deactivated
            this.mediaElement.Pause();
        }
    }
}

ウィンドウが非アクティブでも、バックグラウンドでコードを実行できるアプリケーションもあります。たとえば、メールクライアントは、ユーザーが他のアプリケーションを使用している間もメールサーバーへのポーリングを続けています。このようなアプリケーションは、メインウィンドウが非アクティブのときにも、別の動作や追加の動作を頻繁に実行します。メールプログラムでは、新規のメールを受信トレイに追加し、システムトレイに通知アイコンを追加することがあります。通知アイコンは、メールウィンドウがアクティブでないときにのみ表示する必要があります。メールウィンドウがアクティブかどうかは、IsActive プロパティを調べることで確認できます。

バックグラウンドタスクの完了時に、ユーザーに緊急に通知する必要がある場合は、Activate メソッドを呼び出します。 Activate を呼び出したときに、ユーザーが別のアクティブなアプリケーションと対話している場合は、ウィンドウのタスクバーボタンが点滅します。ユーザーが現在のアプリケーションと対話している場合は、Activate を呼び出すと、ウィンドウが前面に表示されます。

メモ
Application.Activated イベントおよび Application.Deactivated イベントを使用して、アプリケーションスコープのアクティベーションを処理できます。

ウィンドウを閉じる

ウィンドウの有効期間は、表示されたときに開始し、ユーザーが閉じたときに終了します。ウィンドウを閉じるには、非クライアント領域の要素を使用します。これには、次のものが含まれます。

システム メニューの [閉じる] 項目。
Alt キーを押しながら F4 キーを押す。
閉じるボタン。

クライアント領域に機構を追加してウィンドウを閉じることもできます。その一般的な例を次に示します。

一般にメインアプリケーションウィンドウにある、[ファイル] メニューの [終了] 項目。
一般にアプリケーションの 2 次ウィンドウにある、[ファイル] メニューの [閉じる] 項目。
一般にモーダルダイアログボックスにある [キャンセル] ボタン。
一般にモードレスダイアログボックスにある閉じるボタン。

これらのカスタム機構に対応したウィンドウを閉じるには、Close メソッドを呼び出す必要があります。 [ファイル] メニューの [終了] をクリックすることでウィンドウを閉じる機能を実装する方法を、次の例に示します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.WindowWithFileExit">

  <Menu>
    <MenuItem Header="_File">
      <MenuItem Header="E_xit" Click="fileExitMenuItem_Click" />
    </MenuItem>
  </Menu>

</Window>


Imports System.Windows ' window, RoutedEventArgs

Namespace SDKSample
    Partial Public Class WindowWithFileExit
        Inherits System.Windows.Window
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub fileExitMenuItem_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Close this window
            Me.Close()
        End Sub
    End Class
End Namespace

using System.Windows; // window, RoutedEventArgs

namespace SDKSample
{
    public partial class WindowWithFileExit : System.Windows.Window
    {
        public WindowWithFileExit()
        {
            InitializeComponent();
        }

        void fileExitMenuItem_Click(object sender, RoutedEventArgs e)
        {
            // Close this window
            this.Close();
        }
    }
}

ウィンドウが閉じるとき、Closing と Closed の 2 つのイベントが発生します。

Closing はウィンドウが閉じる前に発生し、ウィンドウが閉じるのを防ぐことができる機構を提供します。ウィンドウが閉じるのを防ぐのは、一般的に、ウィンドウコンテンツに変更したデータが含まれている場合です。この場合、Closing イベントを処理して、データが変更されているかどうかを確認できます。変更されている場合は、ユーザーにデータを保存しないでウィンドウを閉じるか、またはウィンドウを閉じる操作をキャンセルするかどうかを確認できます。 Closing を処理するときの要点を次の例に示します。


Imports System ' EventArgs
Imports System.ComponentModel ' CancelEventArgs
Imports System.Windows ' window

Namespace VisualBasic
    Partial Public Class DataWindow
        Inherits Window
        ' Is data dirty
        Private isDataDirty As Boolean = False


...


        Private Sub DataWindow_Closing(ByVal sender As Object, ByVal e As CancelEventArgs)
            MessageBox.Show("Closing called")

            ' If data is dirty, notify user and ask for a response
            If Me.isDataDirty Then
                Dim msg As String = "Data is dirty. Close without saving?"
                Dim result As MessageBoxResult = MessageBox.Show(msg, "Data App", MessageBoxButton.YesNo, MessageBoxImage.Warning)
                If result = MessageBoxResult.No Then
                    ' If user doesn't want to close, cancel closure
                    e.Cancel = True
                End If
            End If
        End Sub
    End Class
End Namespace

using System; // EventArgs
using System.ComponentModel; // CancelEventArgs
using System.Windows; // window

namespace CSharp
{
    public partial class DataWindow : Window
    {
        // Is data dirty
        bool isDataDirty = false;


...


        void DataWindow_Closing(object sender, CancelEventArgs e)
        {
            MessageBox.Show("Closing called");

            // If data is dirty, notify user and ask for a response
            if (this.isDataDirty)
            {
                string msg = "Data is dirty. Close without saving?";
                MessageBoxResult result = 
                  MessageBox.Show(
                    msg, 
                    "Data App", 
                    MessageBoxButton.YesNo, 
                    MessageBoxImage.Warning);
                if (result == MessageBoxResult.No)
                {
                    // If user doesn't want to close, cancel closure
                    e.Cancel = true;
                }
            }
        }
    }
}

Closing イベントハンドラーに CancelEventArgs が渡されます。これにより、true に設定するとウィンドウが閉じるのを防ぐ Boolean 型の Cancel プロパティを実装します。

Closing が処理されない場合、または処理されたがキャンセルされていない場合、ウィンドウは閉じられます。ウィンドウが実際に閉じる直前に、Closed が発生します。この時点で、ウィンドウが閉じるのを防ぐことはできません。

メモ
メインアプリケーションウィンドウを閉じるか、最後のウィンドウを閉じるときに、アプリケーションが自動的にシャットダウンされるように構成することができます (MainWindow を参照)。詳細については、「ShutdownMode」を参照してください。

非クライアント領域およびクライアント領域に提供される機構によって、ウィンドウを明示的に閉じることができます。また、次のような場合に、アプリケーションまたは Windows の他の部分の動作の結果として、ウィンドウを暗黙的に閉じることもできます。

ユーザーが Windows からログオフしたか、Windows をシャットダウンした場合。
ウィンドウのオーナーが閉じた場合 (Owner を参照)。
メインアプリケーションウィンドウが閉じられ、ShutdownMode が OnMainWindowClose である場合。
Shutdown が呼び出されます。

メモ
ウィンドウを閉じると、再度開くことはできません。

ウィンドウの有効期間イベント

次の図は、ウィンドウの有効期間内における主要なイベントのシーケンスを示しています。

ウィンドウの有効期間

次の図は、アクティブ化しないで表示されるウィンドウの有効期間内における主要なイベントのシーケンスを示しています。ウィンドウが表示される前に ShowActivated は false に設定されています。

ウィンドウの有効期間 (Window.ShowActivated = False)

ウィンドウの位置

ウィンドウが開いているとき、ウィンドウはデスクトップに対して相対的な x 座標と y 座標の位置にあります。この位置は、Left プロパティと Top プロパティをそれぞれ調べることで確認できます。これらのプロパティを設定して、ウィンドウの位置を変更できます。

WindowStartupLocation プロパティを次の WindowStartupLocation 列挙値のいずれかに設定して、Window が最初に表示されるときの初期位置を指定することもできます。

開始位置が Manual と指定され、Left プロパティと Top プロパティが設定されていない場合、Window は表示する位置を Windows に問い合わせます。

最上位ウィンドウと Z オーダー

ウィンドウには、x 位置と y 位置のほかに、他のウィンドウを基準にして垂直位置を決定する z 次元の位置もあります。これはウィンドウの z オーダーともいい、標準 z オーダーと最上位 z オーダーの 2 種類があります。標準 z オーダーにあるウィンドウの位置は、そのウィンドウが現在アクティブかどうかによって決まります。既定では、ウィンドウは標準 z オーダーにあります。最上位 z オーダーにあるウィンドウの位置も、そのウィンドウが現在アクティブかどうかによって決まります。また、最上位 z オーダーにあるウィンドウは、常に、標準 z オーダーにあるウィンドウの上に位置します。ウィンドウを最上位 z オーダーに配置するには、ウィンドウの Topmost プロパティを true に設定します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    Topmost="True">


...


</Window>

各 z オーダー内では、現在アクティブなウィンドウは、同じ z オーダーにある他のすべてのウィンドウの上に表示されます。

ウィンドウのサイズ

ウィンドウには、デスクトップの位置のほかに、さまざまな幅と高さのプロパティや SizeToContent プロパティなど、複数のプロパティによって決定されるサイズがあります。

MinWidth、Width、および MaxWidth を使用して、有効期間中にウィンドウが取ることができる幅の範囲を管理します。これは、次の例に示すように構成します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    MinWidth="300" Width="400" MaxWidth="500">


...


</Window>

ウィンドウの高さは、MinHeight、Height、および MaxHeight によって管理します。これは、次の例に示すようにして構成します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    MinHeight="300" Height="400" MaxHeight="500">


...


</Window>

さまざまな幅の値と高さの値はそれぞれ範囲を指定しているため、サイズを変更できるウィンドウの幅と高さは、それぞれの寸法に指定された範囲内のいずれかの値を取ります。現在の幅と高さを検出するには、それぞれ ActualWidth と ActualHeight を調べます。

ウィンドウの幅と高さを、ウィンドウのコンテンツのサイズに合わせたサイズにする場合は、SizeToContent プロパティを使用できます。これは、次の値を取ります。

Manual. 無効 (既定値)。
Width. コンテンツの幅に合わせます。MinWidth と MaxWidth の両方をコンテンツの幅に設定するのと同じ効果です。
Height. コンテンツの高さに合わせます。MinHeight と MaxHeight の両方をコンテンツの高さに設定するのと同じ効果です。
WidthAndHeight. コンテンツの幅と高さに合わせます。MinHeight と MaxHeight の両方をコンテンツの高さに設定し、MinWidth と MaxWidth の両方をコンテンツの幅に設定するのと同じ効果です。

次のコードは、最初に表示するときに、垂直方向と水平方向の両方で自動的にコンテンツにサイズを合わせるウィンドウを示しています。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    SizeToContent="WidthAndHeight">


...


</Window>

サイズ設定プロパティの優先順位

基本的に、ウィンドウのさまざまなサイズのプロパティを組み合わせて、サイズを変更できるウィンドウの幅と高さの範囲を定義します。有効な範囲を確認するために、Window は次の優先順位でサイズプロパティの値を評価します。

高さのプロパティ

幅のプロパティ

優先順位は、ウィンドウが最大化されたときのサイズも決定します。これは、WindowState プロパティで管理します。

ウィンドウの状態

サイズを変更できるウィンドウは、有効期間中、通常、最小化、最大化の 3 つの状態を持っています。通常の状態のウィンドウは、ウィンドウの既定の状態です。この状態のウィンドウは、サイズ変更グリップ、またはサイズ変更可能な場合は境界線を使用して、ユーザーが移動したりサイズ変更したりできます。

最小化された状態のウィンドウは、ShowInTaskbar が true に設定されている場合は、折りたたまれてタスクバーボタンになります。それ以外の場合は、折りたたまれて、可能な最小のサイズになり、デスクトップの左下隅に自動的に再配置されます。最小化されたウィンドウはいずれの種類も、境界線またはサイズ変更グリップを使用してサイズ変更できません。ただし、タスクバーに表示されていない最小化されたウィンドウはデスクトップの任意の場所にドラッグできます。

最大化された状態のウィンドウは、拡大されて、可能な最大のサイズになります。これは、MaxWidth プロパティ、MaxHeight プロパティ、および SizeToContent プロパティが指定するのと同じサイズです。最小化されたウィンドウと同様、最大化されたウィンドウは、サイズ変更グリップを使用したり、境界線をドラッグしたりすることによってサイズ変更できません。

メモ
ウィンドウが現在最大化または最小化されている場合でも、ウィンドウの Top、Left、Width、および Height の各プロパティの値は、通常の状態の値を常に表します。

ウィンドウの状態は、WindowState プロパティを設定することによって構成できます。これは、次の WindowState 列挙値のいずれかを取ります。

Normal (既定値)
Maximized
Minimized

開くときに最大化されて表示されるウィンドウを作成する方法を次の例に示します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    WindowState="Maximized">


...


</Window>

通常は、WindowState を設定してウィンドウの初期状態を構成する必要があります。サイズ変更可能なウィンドウが表示されると、ユーザーはウィンドウのタイトルバーにある最小化ボタン、最大化ボタン、および元に戻すボタンを使用して、ウィンドウの状態を変更できます。

ウィンドウの外観

ウィンドウのクライアント領域の外観を変更するために、ボタン、ラベル、テキストボックスなど、ウィンドウ固有のコンテンツを追加します。非クライアント領域を構成するために、Window には、ウィンドウのアイコンを設定する Icon、タイトルを設定する Title など、いくつかのプロパティが用意されています。

また、ウィンドウのサイズ変更モード、ウィンドウスタイル、デスクトップのタスクバーにボタンとして表示するかどうかを設定して、非クライアント領域の境界線の外観と動作も変更できます。

ここでは、次の項目について説明します。

サイズ変更モード
ウィンドウスタイル
タスクバーのプレゼンス

サイズ変更モード

WindowStyle プロパティによって、ユーザーがどのようにウィンドウのサイズを変更するか、またはウィンドウのサイズを変更できるかどうかを制御できます。ウィンドウスタイルの選択は、ユーザーがマウスで境界線をドラッグすることによってウィンドウのサイズを変更できるかどうか、最小化ボタン、最大化ボタン、およびサイズ変更ボタンが非クライアント領域に表示されるかどうか、表示される場合にボタンが有効かどうかに影響を与えます。

ウィンドウのサイズ変更方法は、ResizeMode プロパティを設定することによって構成できます。これは、次の ResizeMode 列挙値のいずれかを取ります。

WindowStyle と同様に、ウィンドウのサイズ変更モードは、有効期間中に変更される可能性はほとんどありません。したがって、多くの場合は XAML マークアップから設定します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    ResizeMode="CanResizeWithGrip">


...


</Window>

WindowState プロパティを調べることによって、ウィンドウが最大化されているか、最小化されているか、元のサイズに戻されているかを検出できます。

ウィンドウスタイル

ウィンドウの非クライアント領域から公開される境界線は、多くのアプリケーションに適しています。ただし、ウィンドウの種類によって、異なる種類の境界線が必要な状況や、境界線がまったく必要ない状況があります。

ウィンドウが取得する境界線の種類を制御するには、WindowStyle プロパティを次の WindowStyle 列挙値のいずれかに設定します。

これらのウィンドウスタイルの効果については、次の図で説明します。

ウィンドウスタイル

XAML マークアップまたはコードのいずれかを使用して WindowStyle を設定できます。ウィンドウの有効期間中に変更される可能性はほとんどないため、多くの場合は XAML マークアップで設定します。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    WindowStyle="ToolWindow">


...


</Window>

四角形以外のウィンドウスタイル

WindowStyle で使用できる境界線のスタイルでは十分でない状況もあります。たとえば、Microsoft Windows Media Player が使用するような、四角形以外の境界線を持つアプリケーションを作成する場合があります。

たとえば、次の図に示す音声のバブルウィンドウを想定します。

四角形以外のウィンドウ

この種類のウィンドウは、WindowStyle プロパティを None に設定し、Window が持つ透明度に対する特殊なサポートを使用することによって作成できます。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    WindowStyle="None"
    AllowsTransparency="True"
    Background="Transparent">


...


</Window>

値をこの組み合わせで使用し、ウィンドウが完全に透明にレンダリングされるように設定します。この状態では、ウィンドウの非クライアント領域の表示要素 ([閉じる] メニュー、最小化ボタン、最大化ボタン、元に戻すボタンなど) は使用できません。したがって、独自の表示要素を用意する必要があります。

タスクバーのプレゼンス

ウィンドウの既定の外観には、次の図に示すような、タスクバーボタンも含まれます。

タスクバーボタンがあるウィンドウ

メッセージボックスやダイアログボックスなど、ウィンドウの種類によっては、タスクバーボタンがありません (「ダイアログボックスの概要」を参照)。ウィンドウのタスクバーボタンを表示するかどうかは、ShowInTaskbar プロパティを設定することによって制御できます (既定値は true)。

<Window 
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    ShowInTaskbar="False">


...


</Window>

セキュリティの考慮事項

Window をインスタンス化するには、UnmanagedCode セキュリティアクセス許可が必要です。ローカルコンピューターにインストールされ、ローカルコンピューターから起動されるアプリケーションの場合は、アプリケーションに付与される許可セットの範囲内になります。

ただし、これは、ClickOnce を使用して、インターネットゾーンまたはローカルイントラネットゾーンから起動されるアプリケーションに付与される許可セットの範囲外になります。そのため、ユーザーは ClickOnce セキュリティ警告を受け取り、アプリケーションの許可セットを完全信頼に昇格させる必要があります。

さらに、XBAPs では、既定でウィンドウまたはダイアログボックスを表示できません。スタンドアロンアプリケーションのセキュリティに関する考慮事項については、「WPF のセキュリティ方針 - プラットフォームセキュリティ」を参照してください。

その他の種類のウィンドウ

NavigationWindow は、ナビゲーション可能なコンテンツをホストするように設計されたウィンドウです。詳細については、「ナビゲーションの概要」を参照してください。

ダイアログボックスは、ユーザーから情報を収集して機能を完了するためによく使用されるウィンドウです。たとえば、ユーザーがファイルを開く場合は、通常、ユーザーからファイル名を取得するために、アプリケーションによって [ファイルを開く] ダイアログボックスが表示されます。詳細については、「ダイアログボックスの概要」を参照してください。

参照

概念

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

WPF アプリケーション (WPF) のビルド

次の方法で共有

WPF ウィンドウの概要

ウィンドウクラス

ウィンドウの実装

MSBuild 用のウィンドウ定義の構成

ウィンドウの有効期間

ウィンドウを開く

ウィンドウの所有権

ウィンドウのアクティブ化の防止

ウィンドウのアクティブ化

ウィンドウを閉じる

ウィンドウの有効期間イベント

ウィンドウの位置

最上位ウィンドウと Z オーダー

ウィンドウのサイズ

サイズ設定プロパティの優先順位

ウィンドウの状態

ウィンドウの外観

サイズ変更モード

ウィンドウスタイル

四角形以外のウィンドウスタイル

タスクバーのプレゼンス

セキュリティの考慮事項

その他の種類のウィンドウ

参照

参照

概念

その他のリソース

次の方法で共有

WPF ウィンドウの概要

ウィンドウ クラス

ウィンドウの実装

MSBuild 用のウィンドウ定義の構成

ウィンドウの有効期間

ウィンドウを開く

ウィンドウの所有権

ウィンドウのアクティブ化の防止

ウィンドウのアクティブ化

ウィンドウを閉じる

ウィンドウの有効期間イベント

ウィンドウの位置

最上位ウィンドウと Z オーダー

ウィンドウのサイズ

サイズ設定プロパティの優先順位

ウィンドウの状態

ウィンドウの外観

サイズ変更モード

ウィンドウ スタイル

四角形以外のウィンドウ スタイル

タスク バーのプレゼンス

セキュリティの考慮事項

その他の種類のウィンドウ

参照

参照

概念

その他のリソース

ウィンドウクラス

ウィンドウスタイル

四角形以外のウィンドウスタイル

タスクバーのプレゼンス