ウィンドウのサイズを変えるには？［Windows 10 UWPアプリ開発］：WinRT／Metro TIPS

UWPアプリをデスクトップのWindows 10で実行する場合には、そのウィンドウサイズを変更できる。本稿ではプログラムコードからこれを行う方法を解説する。

» 2015年10月28日 05時00分公開

[山本康彦，BluewaterSoft／Microsoft MVP for Windows Development]

　Windows 10のユニバーサルWindowsプラットフォーム用のアプリ（以降、UWPアプリ）をデスクトップで使っているときは、従来のデスクトップアプリと同様なウィンドウとして表示され、マウスなどの操作でリサイズできる。ということは、アプリのコードからもウィンドウのサイズを変えられるのではないだろうか？本稿ではその方法を解説する。なお、本稿のサンプルは「Windows Store app samples：MetroTips #116」からダウンロードできる。

事前準備

　デスクトップ用とモバイル（＝Windows 10を搭載したスマートフォン）用のUWPアプリを開発するには、以下の開発環境が必要である。本稿では、無償のVisual Studio Community 2015（およびVisual Studio Tools for Universal Windows Appsバージョン1.1）を使っている。

SLAT対応のPC*1
64bit版*2 Windows 10 Pro*3
Visual Studio 2015（以降、VS 2015）*4
Windows SDK for Windows 10*5、およびVisual Studio Tools for Universal Windows Apps*6

*1　SLAT対応ハードウエアは、モバイルエミュレーターの実行に必要だ。ただし未対応でも、ソースコードのビルドと実機でのデバッグは可能である。SLAT対応のチェック方法はMSDNブログの「Windows Phone SDK 8.0 ダウンロードポイントと Second Level Address Translation (SLAT) 対応PCかどうかを判定する方法」を参照。なお、SLAT対応ハードウエアであっても、VM上ではエミュレーターが動作しないことがあるのでご注意願いたい。

*2　Windows 10 Mobileエミュレーターを使用しないのであれば、32bit版でもよい。

*3　開発に使うWindows 10は「開発者モード」を有効にしておくこと（「設定アプリ」の［更新とセキュリティ］－［開発者向け］で、［開発者モード］ラジオボタンを選択）。そうしないと、VS 2015のXAMLエディターがエラーになる。また、本稿の内容が適用できるのは、Windowsのライフサイクル管理の上では「Windows 10, released in July 2015」と呼ばれるリリース、またはそれ以降。WinVerコマンドで表示されるバージョンは「10.0 (ビルド 10240)」。UWPアプリ開発におけるデバイスファミリーのバージョン指定としては「10.0.0.0」（Package.appxmanifestファイルのTargetDeviceFamily）である。なお、モバイルエミュレーターを使用しないのであれば、Home版でもよい。

*4　本稿に掲載したコードを試すだけなら、無償のExpressエディションやCommunityエディションで構わない。Visual Studio Express 2015 for Windows 10（製品版）はマイクロソフトのページから無償で入手できる（ページの左側で［Visual Studio 2015］－［Express 2015 for Windows 10］と選ぶ）。Expressエディションはターゲットプラットフォームごとに製品が分かれていて紛らわしいが、UWPアプリの開発には「for Windows 10」を使う（「for Desktop」はWPF／Windowsフォーム／Win32 APIのアプリ開発用）。また、Visual Studio Community 2015（製品版）もマイクロソフトのページから無償で入手できる。なお、英語版がインストールされた場合には、Microsoft Visual Studio 2015 Language Packの日本語版を追加インストールし、［オプション］ダイアログで言語を切り替える。

*5　使用しているVS 2015に含まれていない場合は、Windows SDK for Windows 10のページからダウンロードできる。本稿の内容が適用できるのは、作成したプロジェクトのプロパティに表示されるターゲットバージョンが「10.0; ビルド 10240」またはそれ以降。ただし、プレビュー版のSDKを使うと、Windowsストアには提出できなくなるので注意してほしい。

*6　Visual Studio Tools for Universal Windows Appsは、2015年9月16日付でバージョン1.1に上がっている。それ以前に開発環境を整えた人は、個別にアップデートする必要がある。「Update 1.1: Release Notes and Installation Instructions」（英語）を参照。

ウィンドウをリサイズするには？

　ApplicationViewクラス（Windows.UI.ViewManagement名前空間）のTryResizeViewメソッドを呼び出せばよい（次のコード）。これはユニバーサルなので、どんなデバイスで呼び出しても構わない。

double newWidth = ……省略……;
double newHeight = ……省略……;
bool result
= Windows.UI.ViewManagement.ApplicationView.GetForCurrentView()
.TryResizeView(new Size { Width = newWidth, Height = newHeight });

Dim newWidth As Double = ……省略……
Dim newHeight As Double = ……省略……
Dim result As Boolean _
= Windows.UI.ViewManagement.ApplicationView.GetForCurrentView() _
.TryResizeView(New Size() With {.Width = newWidth, .Height = newHeight})

ウィンドウをリサイズするコードの例（上：C#／下：VB）
このコードは、ウィンドウが表示される前に実行してはいけない（例外が出る）。AppクラスのOnLaunchedメソッド内、あるいはそれ以降なら大丈夫なようだ。

　ただし、常にリサイズできるわけではない。リサイズされなかったときはTryResizeViewメソッドの返値がfalseになるので、判別できる。リサイズされない条件は、おおむね次のようだ。

PC以外のデバイス（＝デバイスファミリーがDesktopではないもの）
PCであってもタブレットモードのとき
小さすぎるサイズ／大きすぎるサイズ（≒画面より大きいサイズ）を要求したとき

　従来のデスクトップアプリでは、画面よりもウィンドウサイズをわざと大きくして、エンドユーザーには見えない場所にUIコントロールを置くこともできたが、UWPアプリではそれはできないのである。そのような制限があると理解した上で、利用していただきたい。

実行例

　別途公開のサンプルコードでは、ボタンをクリックしたときに上記のコードを呼び出すようにしてある。ボタンは三つあり、それぞれ異なったウィンドウサイズを要求する。また、現在のウィンドウサイズとTryResizeViewメソッドの返値をテキストボックスに表示するようにしてある。

　デスクトップ（非タブレットモード）とMobileエミュレーターでの実行結果は以下のようになった。なお、タブレットモードでは、Mobileエミュレーターと同様な結果になる。

　まず、デスクトップ上では適切であるサイズを要求した場合。デスクトップでは要求した通りのサイズに変更された（次の画像）。

中央のボタンをクリック
（＝800×600実効ピクセルのサイズを要求）

▼

適切なサイズを要求した場合（デスクトップとMobileエミュレーター）
800×600実効ピクセルのサイズを要求した場合。
そのサイズは、デスクトップのサイズ（この例では1366×768実効ピクセル）に収まり、小さすぎもしないので、デスクトップではTryResizeViewメソッドの呼び出しは成功し、ウィンドウのサイズが変わる。
Mobileでは、ウィンドウのリサイズはできないため、TryResizeViewメソッドの呼び出しは失敗してfalseが返ってくるだけである（PCのタブレットモードでも同様）。

　前述したリサイズされる条件を満たしていないときは、次の画像のようにTryResizeViewメソッドがfalseを返してくるだけである。

不適切なサイズを要求した場合（デスクトップとMobileエミュレーター）300×300実効ピクセルのサイズを要求

不適切なサイズを要求した場合（デスクトップとMobileエミュレーター）8000×8000実効ピクセルのサイズを要求

不適切なサイズを要求した場合（デスクトップとMobileエミュレーター）
上： 300×300実効ピクセルのサイズを要求*7。
下： 8000×8000実効ピクセルのサイズを要求。
このような不適切なサイズを要求すると、デスクトップでもTryResizeViewメソッドの呼び出しは失敗して、falseが返ってくる。ウィンドウの大きさは変化しない。

*7　デスクトップ上でのUWPアプリは、ウィンドウサイズの最小値は500×320実効ピクセルとなっている。MSDNのドキュメントには、例えば「Windows ランタイム 8.x の XAML と UI の UWP への移植」に「UWP アプリでは（中略）既定の最小サイズは 500 x 320 epx」と記載されている（「epx」＝「実効ピクセル」）。そのため、それより小さい300×300実効ピクセルへのリサイズはできないのである。

　なお、デスクトップの画面サイズとはタスクバーを除いた領域のことなので注意してほしい（タスクバーを自動的に隠すように設定していないとき）。例えば筆者のテスト環境（1366×768実効ピクセル）では、タスクバーのアイコンが4段重ねになるまでタスクバーの高さを大きくしたら、800×600実効ピクセルへのリサイズが失敗するようになった（次の画像）。