動的レイアウト

[アーティクル]
06/16/2023

Visual Studio 2015 の MFC では、ユーザーがサイズ変更できるダイアログを作成でき、サイズ変更に合わせてレイアウトを調整する方法を制御することができます。たとえば、ボタンをダイアログの下の端に付けて、常にダイアログボックスの下部に配置されるようにすることができます。ユーザーがダイアログを展開するときに、リストボックス、エディットボックス、テキストフィールドなどの特定のコントロールを展開するように設定することもできます。

MFC ダイアログボックスのレイアウトの動的な設定を指定する

ユーザーがダイアログボックスをサイズ変更するときに、ダイアログのコントロールのサイズを変更したり、X と Y の方向に移動したりできます。ユーザーがダイアログボックスのサイズを変更するときのコントロールのサイズや位置の変更は、動的レイアウトと呼ばれます。たとえば、次に示すのはサイズを変更する前のダイアログです。

Dialog before being resized.

サイズを変更した後で、リストボックス領域がより多くの項目を表示するよう増え、ボタンは右下隅に沿って移動します。

Dialog after being resized.

IDE のリソースエディターの各コントロールの詳細を指定して、動的レイアウトを制御することも、特定のコントロールの CMFCDynamicLayout オブジェクトにアクセスしてプロパティを設定し、プログラムで制御することもできます。

リソースエディターで動的レイアウトプロパティを設定する

リソースエディターを使用すると、コードを記述しなくても、ダイアログボックス動的のレイアウトの動作を設定できます。

動的レイアウトのプロパティをリソースエディターで設定するには

MFC プロジェクトを開いた状態にして、ダイアログエディターで作業するダイアログボックスを開きます。
コントロールを選択し、[プロパティ] ウィンドウ (クラスビュー内) で、その動的レイアウトプロパティを設定します。 [プロパティ] ウィンドウの [動的レイアウト] セクションには、[移動の種類]、[サイズ変更の種類] のプロパティが含まれ、これらのプロパティで選択した値によっては、コントロールの移動またはサイズの変更の大きさを定義する固有のプロパティが含まれます。 [移動の種類] は、ダイアログのサイズ変更に合わせてコントロールを移動する方法を決定し、[サイズ変更の種類] は、ダイアログのサイズの変更に合わせてコントロールがサイズ変更される方法を決定します。 [移動の種類] と [サイズ変更の種類] は、動的に変更したい方向に応じて、[水平]、[垂直]、[両方]、または [なし] になります。 [水平] は X 方向、[垂直] はY 方向です。
[OK] または [キャンセル] ボタンで一般的なように、ボタンなどのコントロールを固定サイズにして、右下に配置したい場合は、[サイズ変更の種類] を [なし] に設定して、[移動の種類] を [両方] に設定します。 [移動の種類] の下の [X の移動] と [Y の移動] の値には 100% を設定して、コントロールが右下隅から一定の距離を維持するようにします。
ダイアログボックスの拡張と共に拡張させたいコントロールがあるとします。通常、複数行の編集ボックスを拡張して、テキスト領域のサイズを増やすために、ダイアログを拡張するか、より多くのデータを表示するために、リストコントロールを拡張します。この場合、[サイズ変更の種類] を [両方] に設定して、[移動の種類] を [なし] にします。次に、[X のサイズ変更] と [Y のサイズ変更] の値を 100 に設定します。
コントロールにとって意味がある可能性のあるその他の値をテストします。たとえば、1 行のテキストボックスがあるダイアログで、[サイズ変更の種類] を [水平] のみに設定するとします。

プログラムによる動的レイアウトプロパティの設定

前の手順は、デザイン時にダイアログの動的レイアウトプロパティを指定するには便利ですが、動的レイアウトプロパティを実行時に制御したい場合は、動的レイアウトプロパティをプログラムで設定できます。

動的レイアウトプロパティをプログラムによって設定するには

ダイアログの動的レイアウトを指定する、ダイアログクラスの実装コードの場所を検索または作成します。たとえば、ダイアログに AdjustLayout などのメソッドを追加して、レイアウトを変更する必要がある場所から呼び出すことができます。最初にこれをコンストラクターから呼び出すか、ダイアログに変更を加えた後で呼び出すことができます。
ダイアログで CWnd クラスのメソッドである GetDynamicLayout を呼び出します。 GetDynamicLayout は CMFCDynamicLayout オブジェクトへのポインターを返します。
```
CMFCDynamicLayout* dynamicLayout = pDialog->GetDynamicLayout();
```
動的な動作を追加する最初のコントロールでは、動的レイアウトクラスで静的メソッドを使用して、コントロールを調整する方法をエンコードする MoveSettings 構造体を作成します。そうするには、まず、適切な静的メソッド (CMFCDynamicLayout::MoveHorizontal、CMFCDynamicLayout::MoveVertical、CMFCDynamicLayout::MoveNone、または CMFCDynamicLayout::MoveHorizontalAndVertical) を選択します。移動の水平/垂直方向のアスペクト比率を渡します。これらすべての静的メソッドは、コントロールの移動の動作を指定する時に使用できる、新しく作成された MoveSettings オブジェクトを返します。

100 にするとダイアログのサイズ変更とまったく同じサイズの移動を行い、これによりコントロールのエッジが新しい境界からの固定距離を維持します。
```
MoveSettings moveSettings = CMFCDynamicLayout::MoveHorizontal(100);
```
サイズの動作について、SizeSettings 型を使用して同じ操作を行います。たとえば、ダイアログボックスのサイズを変更するときにコントロールがサイズを変更しないよう指定するには、次のコードを使用します。
```
SizeSettings sizeSettings = CMFCDynamicLayout::SizeNone();
```
CMFCDynamicLayout::AddItem メソッドを使用して、コントロールを動的レイアウトマネージャーに追加します。目的のコントロールを指定するさまざまな方法に対して、2 つのオーバーロードがあります。 1 つはコントロールのウィンドウハンドル (HWND) を取得し、もう 1 つは、コントロールの ID を取得します。
```
dynamicLayout->AddItem(hWndControl,
moveSettings,
sizeSettings);
```
移動またはサイズを変更する必要がある各コントロールに対して繰り返します。
必要に応じて、コントロールが既に動的レイアウトの変更の対象となるコントロールのリストにあるかどうかを判断するために CMFCDynamicLayout::HasItem メソッドを使用することも、変更の対象となっているコントロールがあるかどうかを判断するために CMFCDynamicLayout::IsEmpty メソッドを使用することもできます。
ダイアログのレイアウトを有効にするには CWnd::EnableDynamicLayout メソッドを呼び出します。
```
pDialog->EnableDynamicLayout(TRUE);
```
次回ユーザーがダイアログをサイズ変更するときに、CMFCDynamicLayout::Adjust メソッドが呼び出され、実際に設定を適用します。
動的レイアウトを無効にする場合は、bEnabled パラメーターに FALSE を指定した CWnd::EnableDynamicLayout を呼び出します。
```
pDialog->EnableDynamicLayout(FALSE);
```

リソースファイルから動的レイアウトをプログラムで設定するには

CMFCDynamicLayout::MoveHorizontalAndVertical メソッドを使用して、次の例のように、動的レイアウトの情報を指定する、関連するリソーススクリプトファイル (.rc ファイル) で、リソース名を指定します。
```
dynamicLayout->LoadResource("IDD_DIALOG1");
```
名前付きのリソースは、次の例のように、リソースファイル内の AFX_DIALOG_LAYOUT エントリの形式のレイアウト情報が含まれているダイアログを参照する必要があります。
```
/////////////////////////////////////////////////////////////////////////////
//
// AFX_DIALOG_LAYOUT
//

IDD_MFCAPPLICATION1_DIALOG AFX_DIALOG_LAYOUT
BEGIN
0x0000,
0x6400,
0x0028,
0x643c,
0x0028
END

IDD_DIALOG1 AFX_DIALOG_LAYOUT
BEGIN
0x0000,
0x6464,
0x0000,
0x6464,
0x0000,
0x0000,
0x6464,
0x0000,
0x0000

END
```

次の方法で共有

動的レイアウト

MFC ダイアログボックスのレイアウトの動的な設定を指定する

リソースエディターで動的レイアウトプロパティを設定する

動的レイアウトのプロパティをリソースエディターで設定するには

プログラムによる動的レイアウトプロパティの設定

動的レイアウトプロパティをプログラムによって設定するには

リソースファイルから動的レイアウトをプログラムで設定するには

関連項目

フィードバック

その他のリソース

次の方法で共有

動的レイアウト

MFC ダイアログ ボックスのレイアウトの動的な設定を指定する

リソース エディターで動的レイアウト プロパティを設定する

動的レイアウトのプロパティをリソース エディターで設定するには

プログラムによる動的レイアウト プロパティの設定

動的レイアウト プロパティをプログラムによって設定するには

リソース ファイルから動的レイアウトをプログラムで設定するには

関連項目

フィードバック

その他のリソース

MFC ダイアログボックスのレイアウトの動的な設定を指定する

リソースエディターで動的レイアウトプロパティを設定する

動的レイアウトのプロパティをリソースエディターで設定するには

プログラムによる動的レイアウトプロパティの設定

動的レイアウトプロパティをプログラムによって設定するには

リソースファイルから動的レイアウトをプログラムで設定するには