wxDialog の概要

クラス: wxDialog, wxDialogLayoutAdapter

ダイアログボックスはパネルに似ており、コントロールを配置するために使用するウィンドウですが、以下の例外があります:

• 周囲を囲むフレームが暗黙的に作成される。
• コントロール間のタブ遷移など、自動的に追加の機能が付与される。(Windows のみ)
• ダイアログボックスが モーダル の場合、ダイアログボックスが閉じられるまでプログラムがブロックする。

ファイルの選択を含む、ダイアログの便利関数は ダイアログ を参照してください。

また、wxDialog が継承している関数については wxTopLevelWindow と wxWindow を参照してください。コントロールのバリデーションは wxValidator の概要 で触れています。

• ダイアログの自動スクロール

---

ダイアログの自動スクロール

様々なモバイル端末が市場に出回るにつれ、プログラマに過度の負担をかけることなく、アプリケーションをそれらのプラットフォームへ適応させることが wxWidgets に求められるようになってきました。wxWidgets が支援できることのひとつにダイアログを (より小さいフォームファクタに付きものな) より低解像度の画面に適応させることが挙げられます。そのために wxDialog ではグローバルな wxDialogLayoutAdapter クラスを提供しており、このクラスではサイザーを利用した大半のダイアログに対して自動スクロール機能を適用させることができます。

したがって、ダイアログのことを気にかけている限り、少し、もしくはまったく手を加えることなく、多くのアプリケーションを小さな画面に適応させることができるはずです。デフォルトではこの適応は無効になっています。スクロールに関する適応をアプリケーション内でグローバルに切り替える場合、静的関数 wxDialog::EnableLayoutAdaptation に true を渡します。また、ダイアログごとに適応を行なうかどうかを指定する場合は wxDialog::SetLayoutAdaptationMode に wxDIALOG_ADAPTATION_MODE_DEFAULT (グローバルな設定を使用)、 wxDIALOG_ADAPTATION_MODE_ENABLED、 wxDIALOG_ADAPTATION_MODE_DISABLED のいずれかを指定します。

最後のふたつのモードは適応に関するグローバルな設定を上書きします。適応を有効にすると、ダイアログを表示するのに画面サイズが小さすぎる場合に wxWidgets (と言うより標準の適応クラスである wxStandardDialogLayoutAdapter) が標準ボタンをダイアログ下部の非スクロール領域に残してダイアログの一部をスクロールするようにします。wxDialog::Show や wxDialog::ShowModalから呼ばれた wxDialogLayoutAdapter::DoLayoutAdaptation の中では次のように処理が行われます:

• wxDialog::GetContentWindow が wxBookCtrlBase を継承したウィンドウを返却する場合、ページがスクロール可能になるだけで、それ以外の適応は行われません。
• wxWidgets は wxStdDialogButtonSizer を探してその部分を非スクロール領域として使用します。
• もしも見つからなかった場合、wxID_OK や wxID_CANCEL などの識別子を持つ、ひとつ以上の標準ボタンを含む水平方向の wxBoxSizer を探します。
• これも見つからなかった場合、wxWidgets は (任意の種類のサイザーに含まれる) 'ゆるい' 標準ボタンを探し、 wxStdDialogButtonSizer に追加します。標準ボタンが見つからなかった場合、ダイアログ全体がスクロールされます。
• 標準ボタン以外のすべての子コントロールの親は新しい wxScrolledWindow オブジェクトに変更されます。このとき、以前のトップレベルサイザーはスクロール可能なウィンドウに使用され、スクロール可能なウィンドウと標準ボタンサイザーを配置するために新しいトップレベルサイザーが作成されます。

スクロールの適応のカスタマイズ

グローバル、またはダイアログごとの適応の切り替えに加えて、wxDialog::SetLayoutAdaptationLevel を設定することでどれだけ積極的に標準ボタンを探しに行くかを選択することができます。デフォルトでは上で述べた処理がすべて行われますが、レベルを 1 に設定することで wxStdDialogButtonSizer のみを探すようにできます。

wxDialog::AddMainButtonId を使用することで非スクロール領域にする標準ボタンとして扱う識別子を追加することができます。

wxDialogLayoutAdapter か wxStandardDialogLayoutAdapter を継承した独自のクラスを作成することができます。その場合、wxDialog::SetLayoutAdapter を呼び出し、返却されてきた古いオブジェクトは削除します。適応の可否の確認や適応を行なうには CanDoLayoutAdaptation と DoLayoutAdaptation をオーバーライドします。

また、wxDialog を継承したクラスで wxDialog::CanDoLayoutAdaptation と wxDialog::DoLayoutAdaptation をオーバライドすることも可能です。

自動スクロールの適応に失敗する状況

適応はサイザーとウィンドウの階層構造を変更するため、これは確実に行えるものではなく、以下のような状況では適応に失敗します:

• ダイアログでサイザーを使用していない。
• コントロールの親をダイアログにキャストするなど、ダイアログの実装でウィンドウの階層構造について仮定を立てている。
• ダイアログでカスタムドローを行なっている。スクロール可能なウィンドウではイベント処理が行われません。アプリケーション全体でグローバルにこの問題を解決できるようであれば wxStandardDialogLayoutAdapter を継承した新しいアダプタクラスを作成し、作成したクラスのインスタンスを返却するように CreateScrolledWindow 関数をオーバーライドしてください。
• 標準ボタンと他のコントロールが混在する垂直方向のサイザーなど、通常とは異なるレイアウトを持っている。
• トップレベルサイザーの子コントロールの表示・非表示を切り替えるなど、サイザーの階層構造について仮定を立てている。ただし、Show または ShowModal が呼ばれるまではサイザーの元の階層構造が保持されています。

次のようにすることで、適応の実施後もダイアログが引き続き正常に動作するようにできます:

• 上記のような状況や仮定を避ける;
• wxStdDialogButtonSizer を使用する;
• ダイアログ内の階層構造について仮定するのはダイアログの作成直後だけにする;
• メインのサイザーの下に仲介サイザーを使用する; これは偽のトップレベルサイザーで、子サイザーとウィンドウを操作するために使用します。
• ダイアログでページを実装している場合、ブックコントロールを返却するように wxDialog::GetContentWindow をオーバーライドする: その場合、wxWidgets はページのみをスクロール可能にします。

wxPropertySheetDialog と wxWizard

wxPropertySheetDialog に対する適応は単純にページをスクロール可能にするだけです。なぜなら、 wxDialog::GetContentWindow がダイアログのブックコントロールを返却し、このコントロールが標準のレイアウトアダプタで処理されるためです。

wxWizard はグローバルなアダプタではなく、独自の CanDoLayoutAdaptation と DoLayoutAdaptation 関数を使用します。繰り返しになりますが、ウィザードページのみがスクロール可能になります。