WPF ウィンドウの概要

 

公開日: 2016年6月

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

System_CAPS_ICON_note.jpg メモ

XAML ブラウザー アプリケーション (XBAP) や Loose Extensible Application Markup Language (XAML) のページなど、ブラウザーによってホストされる WPF アプリケーションには、独自のウィンドウはありません。 その代わり、Entity with relative path '../Token/TLA%23tla_iegeneric_md.md' can not be found, for source topic '{"project_id":"3fedad16-eaf1-41a6-8f96-0c1949c68f32","entity_id":"737d04ec-8861-46c3-8d44-fa11d3528d23","entity_type":"Article","locale":"ja-JP"}'. で提供されるウィンドウでホストされます。 「WPF XAML ブラウザー アプリケーションの概要」を参照してください。

Entity with relative path '../Token/autoOutline_md.md' can not be found, for source topic '{"project_id":"3fedad16-eaf1-41a6-8f96-0c1949c68f32","entity_id":"737d04ec-8861-46c3-8d44-fa11d3528d23","entity_type":"Article","locale":"ja-JP"}'.

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

ウィンドウ要素

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

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

  • 境界線

  • タイトル バー

  • アイコン

  • 最小化ボタン、最大化ボタン、および復元ボタン

  • 閉じるボタン。

  • ウィンドウを最小化、最大化、元のサイズに戻す、移動、サイズ変更、および閉じるためのメニュー項目を含むシステム メニュー。

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

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

  • ウィンドウを表示する。

  • ウィンドウのサイズ、位置、および外観を構成する。

  • アプリケーション固有のコンテンツをホストする。

  • ウィンドウの有効期間を管理する。

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

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

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

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="http://schemas.microsoft.com/winfx/2006/xaml") に XML 名前空間宣言を追加する必要があります。 生成されたpartialクラスは InitializeComponent メソッドを実装します。このメソッドを呼び出すとイベントが登録され、マークアップで実装されるプロパティが設定されます。

  • 分離コードでは、クラスは、マークアップ内の x:Class 属性で指定されている名前を持つpartialクラスでなければなりません。また、Window から派生する必要があります。 これによって、分離コード ファイルと、アプリケーションのビルド時にマークアップ ファイル用に生成されるpartialクラスとが関連付けられます (「WPF アプリケーションのビルド」を参照)。

  • 分離コードでは、Window クラスが実装するコンストラクターで InitializeComponent メソッドを呼び出す必要があります。 InitializeComponent は、マークアップ ファイル用に生成された partial クラスによって実装されるもので、イベントの登録と、マークアップで定義されたプロパティの設定を実行します。

System_CAPS_ICON_note.jpg メモ

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

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

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

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 を構成する方法が決定します。 XAML マークアップと分離コードの両方を使用して定義したウィンドウには、次の要件があります。

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

  • 分離コード ファイルは、MSBuild の Compile 項目として構成する必要があります。

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

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

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

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

Entity with relative path '../Token/autoOutline_md.md' can not be found, for source topic '{"project_id":"3fedad16-eaf1-41a6-8f96-0c1949c68f32","entity_id":"737d04ec-8861-46c3-8d44-fa11d3528d23","entity_type":"Article","locale":"ja-JP"}'.

ウィンドウを開く

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

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

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

System_CAPS_ICON_note.jpg メモ

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

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

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

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

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

ウィンドウの所有権

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

  • もう一方のウィンドウの上に表示する (いずれかのウィンドウの Topmost プロパティが true に設定されている場合を除く)。

  • もう一方のウィンドウに影響を与えずに、最小化し、最大化し、元のサイズに戻す。

一部のウィンドウには、そのウィンドウを開いたウィンドウとの関係が必要です。 たとえば、Entity with relative path '../Token/TLA%23tla_ide_md.md' can not be found, for source topic '{"project_id":"3fedad16-eaf1-41a6-8f96-0c1949c68f32","entity_id":"737d04ec-8861-46c3-8d44-fa11d3528d23","entity_type":"Article","locale":"ja-JP"}'. アプリケーションでは、プロパティ ウィンドウやツール ウィンドウのように、一般的に作成元のウィンドウの上に表示されるウィンドウが開く場合があります。 また、そのようなウィンドウは、必ず作成元のウィンドウと一緒に閉じ、最小化し、最大化し、元のサイズに戻す必要があります。 このような関係を確立するには、あるウィンドウが別のウィンドウを所有するようにします。そのためには、所有されているウィンドウOwner プロパティに、オーナー ウィンドウへの参照を設定します。 これを次の例に示します。

            // 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 イベントが、ユーザーの操作への応答として発生します。

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

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

System_CAPS_ICON_note.jpg メモ

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

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

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

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://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>

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 を呼び出すと、ウィンドウが前面に表示されます。

System_CAPS_ICON_note.jpg メモ

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

ウィンドウを閉じる

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

  • システム メニューの [閉じる] 項目。

  • Alt キーを押しながら F4 キーを押す。

  • 閉じるボタン。

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

  • 一般にメイン アプリケーション ウィンドウにある、[ファイル] メニューの [終了] 項目。

  • 一般にアプリケーションの 2 次ウィンドウにある、[ファイル] メニューの [閉じる] 項目。

  • 一般にモーダル ダイアログ ボックスにある [キャンセル] ボタン。

  • 一般にモードレス ダイアログ ボックスにある閉じるボタン。

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

<Window 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="SDKSample.WindowWithFileExit">
  
  <Menu>
    <MenuItem Header="_File">
      <MenuItem Header="E_xit" Click="fileExitMenuItem_Click" />
    </MenuItem>
  </Menu>
  
</Window>

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();
        }
    }
}

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

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

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 が発生します。 この時点で、ウィンドウが閉じるのを防ぐことはできません。

System_CAPS_ICON_note.jpg メモ

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

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

  • ユーザーが Windows からログオフしたか、Windows をシャットダウンした場合。

  • ウィンドウのオーナーが閉じた場合 (Owner を参照)。

  • メイン アプリケーション ウィンドウが閉じられ、ShutdownModeOnMainWindowClose である場合。

  • Shutdown が呼び出されます。

System_CAPS_ICON_note.jpg メモ

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

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

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

ウィンドウの有効期間

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

ウィンドウの有効期間 (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="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    Topmost="True">

</Window>

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

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

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

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

</Window>

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

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

</Window>

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

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

  • Manual. 無効 (既定値)。

  • Width. コンテンツの幅に合わせます。MinWidthMaxWidth の両方をコンテンツの幅に設定するのと同じ効果です。

  • Height. コンテンツの高さに合わせます。MinHeightMaxHeight の両方をコンテンツの高さに設定するのと同じ効果です。

  • WidthAndHeight. コンテンツの幅と高さに合わせます。MinHeightMaxHeight の両方をコンテンツの高さに設定し、MinWidthMaxWidth の両方をコンテンツの幅に設定するのと同じ効果です。

次の例では最初に表示するときにコンテンツ方向と垂直方向に合わせるウィンドウを自動的に調整示します。

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

</Window>

次の例ではウィンドウのサイズ変更の内容に合わせて方法を指定するコードの SizeToContent のプロパティを設定する方法を示します。


            // Manually alter window height and width
            this.SizeToContent = SizeToContent.Manual;

            // Automatically resize width relative to content
            this.SizeToContent = SizeToContent.Width;

            // Automatically resize height relative to content
            this.SizeToContent = SizeToContent.Height;

            // Automatically resize height and width relative to content
            this.SizeToContent = SizeToContent.WidthAndHeight;

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

高さのプロパティ

  1. FrameworkElement.MinHeight >

  2. FrameworkElement.MaxHeight >

  3. SizeToContent.Height/SizeToContent.WidthAndHeight >

  4. FrameworkElement.Height

幅のプロパティ

  1. FrameworkElement.MinWidth >

  2. FrameworkElement.MaxWidth >

  3. SizeToContent.Width/SizeToContent.WidthAndHeight >

  4. FrameworkElement.Width

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

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

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

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

System_CAPS_ICON_note.jpg メモ

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

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

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

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

</Window>

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

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

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

Entity with relative path '../Token/autoOutline_md.md' can not be found, for source topic '{"project_id":"3fedad16-eaf1-41a6-8f96-0c1949c68f32","entity_id":"737d04ec-8861-46c3-8d44-fa11d3528d23","entity_type":"Article","locale":"ja-JP"}'.

サイズ変更モード

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

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

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

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

</Window>

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

ウィンドウ スタイル

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

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

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

ウィンドウ スタイル

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

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

</Window>

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

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

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

四角形以外のウィンドウ

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

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

</Window>

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

タスク バーのプレゼンス

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

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

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

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

</Window>

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

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

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

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

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

Window
MessageBox
NavigationWindow
Application
ダイアログ ボックスの概要
WPF アプリケーションのビルド

表示: