注意：FormLayout クラスは、Spark Form コンテナのみで使用してください。他のコンテナのコンテンツのレイアウトには使用しないでください。

注意：Spark のリストベースのコントロール（Spark の List コントロールと、そのサブクラスである ButtonBar、ComboBox、DropDownList、TabBar）では、ConstraintLayout クラスがサポートされていません。 Spark のリストベースのコントロールでは、ConstraintLayout を使用しないでください。

エレメントごとにサポートされる制約は、left、right、top、bottom、baseline、percentWidth、percentHeight です。 エレメントの最小サイズと最大サイズは、必ず順守されます。

列および行に対して明示的にサイズを設定することも、（明示的にサイズを設定せずに）コンテンツのサイズに設定することもできます。コンテンツのサイズに設定された領域は、その領域に制約される要素がちょうど収まるように伸縮しますが、明示的にサイズが設定された領域は指定のサイズに固定されます。コンテンツのサイズに設定された複数の領域にエレメントがまたがっている場合、スペースはコンテンツのサイズに設定された領域間で均等に配分されます。

コンテナの測定サイズは、エレメント、その制約、推奨サイズ、および行と列のサイズから計算されます。各行および列のサイズは、すべてのエレメントを制約を満たしながら推奨サイズのままに制約しておくのに十分な大きさです。コンテナの測定サイズは、すべての列と行、および他の要素を制約を満たしながら推奨サイズのままにしておくのに十分な大きさです。

updateDisplayList() メソッドの呼び出しでは、エレメントのサイズは、次のルール（優先順に記載）に従って決定されます（エレメントの最小サイズと最大サイズは、必ず順守されます）。

• エレメントに percentWidth または percentHeight が設定されている場合、そのサイズは、使用可能なサイズの割合として計算されます。使用可能なサイズは、領域またはコンテナのサイズから left、right、top、bottom の各制約を引いた値です。
• エレメントに left と right の両方の制約がある場合、その幅には、領域またはコンテナの幅から left と right の制約を引いた値が設定されます。
• エレメントに top と bottom の両方の制約がある場合、その高さには、コンテナの高さから top と bottom の制約を引いた値が設定されます。
• エレメントには、その推奨幅と推奨高さ（またはそのいずれか）が設定されます。

エレメントの位置は、次のルール（優先順に記載）に従って決定されます。

• エレメントのベースラインが指定されている場合、エレメントは、その baselinePosition（通常は、テキストの先頭行のベースライン）が baseline 制約に揃えられるように垂直方向に配置されます。
• エレメントの top または left 制約が指定されている場合、エレメントは、そのレイアウト境界の左上隅がコンテナの左上隅から指定値だけオフセットされるように配置されます。
• エレメントの bottom または right 制約が指定されている場合、エレメントは、そのレイアウト境界の右下隅がコンテナの右下隅から指定値だけオフセットされるように配置されます。
• 制約によって水平または垂直方向の位置が決定されない場合、エレメントは、自身の x および y 座標に従って配置されます。

コンテナのコンテンツのサイズは、すべてのレイアウトエレメントおよび制約領域の右下隅の座標の最大値として計算されます。

エレメントごとにサポートされる制約は、percentWidth と percentHeight です。エレメントの最小サイズと最大サイズは、必ず順守されます。可能な場合、エレメントのサイズは、セルのサイズ以下に制限されます。

明示的に設定しない場合、columnWidth プロパティは、すべてのエレメントの最大推奨境界幅として計算され、columnHeight プロパティは、すべてのエレメントの最大推奨境界高さとして計算されます。

明示的に設定しない場合、columnCount プロパティと rowCount プロパティは、レイアウトターゲットの明示的な幅と高さの設定と、columnWidth および columnHeight から計算されます。何も指定しない場合は、columnCount と rowCount の値が選択され、生成されるピクセル領域が可能なかぎり正方形になります。

測定サイズは、columnCount、rowCount、columnWidth、rowHeight プロパティおよび間隔のサイズから計算されます。

プロパティが明示的に設定されていない場合、デフォルトの測定サイズは、可能なかぎり正方形に近く、すべてのエレメントを収めるのに十分な大きさになります。

場合によっては、測定サイズの大きさが不十分で、すべてのエレメントが収まらないことがあります。例えば、columnCount と rowCount の両方に明示的に値が設定されていて、columnCount に rowCount を乗算した値がエレメント数より小さい場合です。

最小の測定サイズは、測定サイズと同様に計算されます。ただし、短軸に沿って行と列が十分に含まれているので、すべてのエレメントが収まることが保証されます。

エレメントの垂直位置は、最初のエレメントの前のパディングと各エレメント間の間隔を考慮して、垂直方向に上から下の順序でエレメントを配置することにより決定されます。

エレメントの水平位置は、レイアウトの horizontalAlign プロパティによって決定されます。

measure() メソッドの実行中に、コンテナのデフォルトサイズは、エレメントの推奨サイズ（間隔とパディングを含む）を収集することにより計算されます。requestedRowCount を設定すると、最初のエレメントから始めて、指定した数のエレメントのスペースのみが測定されます。

updateDisplayList() メソッドの実行中に、各エレメントの高さは、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小高さと最大高さは、必ず順守されます）。

• variableRowHeight が false の場合は、エレメントの高さを rowHeight プロパティの値に設定します。
• エレメントの percentHeight が設定されている場合は、percentHeight 設定を使用して、使用可能なコンテナの高さをすべてのエレメント間で分配し、エレメントの高さを計算します。使用可能なコンテナの高さは、間隔、パディング、および残りのエレメントが占有しているスペースをコンテナの高さから引いた値に等しくなります。レイアウトが仮想化されている場合は、エレメントの precentHeight プロパティが無視されます。
• エレメントの高さにその推奨高さを設定します。

各エレメントの幅は、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小幅と最大幅は、必ず順守されます）。

• horizontalAlign が「justify」の場合は、エレメントの幅をコンテナの幅に設定します。
• horizontalAlign が「contentJustify」の場合は、コンテナの幅とすべてのエレメントの推奨幅の間の最大値をエレメントの幅に設定します。
• エレメントの percentWidth が設定されている場合は、エレメントの幅をコンテナの幅に対する割合として計算します。
• エレメントの幅にその推奨幅を設定します。

エレメントの水平位置は、最初のエレメントの前のパディングと各エレメント間の間隔を考慮して、水平方向に左から右の順序でエレメントを配置することにより決定されます。

エレメントの垂直位置は、レイアウトの verticalAlign プロパティによって決定されます。

measure() メソッドの実行中に、コンテナのデフォルトサイズは、エレメントの推奨サイズ（間隔とパディングを含む）を収集することにより計算されます。requestedColumnCount プロパティが -1 以外の値に設定されている場合は、最初のエレメントから始めて、指定した数のエレメントのスペースのみが測定されます。

updateDisplayList() メソッドの実行中に、各エレメントの幅は、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小幅と最大幅は、必ず順守されます）。

• variableColumnWidth が false の場合は、エレメントの幅を columnWidth プロパティの値に設定します。
• エレメントの percentWidth が設定されている場合は、percentWidth の設定を使用して、使用可能なコンテナの幅をすべてのエレメント間で分配し、エレメントの幅を計算します。使用可能なコンテナの幅は、間隔、パディング、および残りのエレメントが占有しているスペースをコンテナの幅から引いた値に等しくなります。レイアウトが仮想化されている場合は、エレメントの precentWidth プロパティが無視されます。
• エレメントの幅にその推奨幅を設定します。

各エレメントの高さは、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小高さと最大高さは、必ず順守されます）。

• verticalAlign プロパティが「justify」の場合は、エレメントの高さをコンテナの高さに設定します。
• verticalAlign プロパティが「contentJustify」の場合は、コンテナの高さとすべてのエレメントの推奨高さの間の最大値をエレメントの高さに設定します。
• エレメントの percentHeight プロパティが設定されている場合は、エレメントの高さをコンテナの高さに対する割合として計算します。
• エレメントの高さにその推奨高さを設定します。

メモ：Spark のリストベースのコントロール（Spark の List コントロールと、そのサブクラスである ButtonBar、ComboBox、DropDownList、TabBar）では、BasicLayout クラスがサポートされていません。Spark のリストベースのコントロールでは、BasicLayout を使用しないでください。

エレメントごとにサポートされる制約は、left、right、top、bottom、horizontalCenter、verticalCenter、baseline、percentWidth、percentHeight です。エレメントの最小サイズと最大サイズは、必ず順守されます。

コンテナの測定サイズは、エレメント、その制約および推奨サイズから計算されます。コンテナの測定サイズは、すべてのエレメントを、制約を満たしながら推奨サイズで収めるのに十分な大きさです。

測定サイズの計算方法の例を示します。

• コンテナに left 制約を指定された 1 つのエレメントが含まれる場合、コンテナの測定幅は、エレメントの推奨される幅に left 制約の値を加えたものと等しくなります。
• コンテナに percentWidth を指定された 1 つのエレメントが含まれる場合、コンテナの測定幅は、エレメントの推奨される幅と等しくなります。エレメントの percentWidth が計算に直接反映されることはありませんが、updateDisplayList() メソッドの呼び出しでは考慮されます。
• コンテナに baseline 制約を指定された 1 つのエレメントが含まれる場合、コンテナの測定高さは、エレメントの推奨される高さに baseline を加え、そこからエレメントの baselinePosition プロパティの値を引いたものと等しくなります。
• コンテナに verticalCenter 制約を指定された 1 つのエレメントが含まれる場合、コンテナの測定高さは、エレメントの推奨される高さに、verticalCenter 制約の値の 2 倍を加えたものと等しくなります。

updateDisplayList() メソッドの呼び出しでは、エレメントのサイズは、次のルール（優先順に記載）に従って決定されます（エレメントの最小サイズと最大サイズは、必ず順守されます）。

• エレメントに percentWidth または percentHeight が設定されている場合、そのサイズは、使用可能なサイズの割合として計算されます。使用可能なサイズは、コンテナのサイズから left、right、top、bottom の各制約を引いた値です。
• エレメントに left と right の両方の制約がある場合、その幅には、コンテナの幅から left と right の制約を引いた値が設定されます。
• エレメントに top と bottom の両方の制約がある場合、その高さには、コンテナの高さから top と bottom の制約を引いた値が設定されます。
• エレメントには、その推奨幅と推奨高さ（またはそのいずれか）が設定されます。

BasicLayout クラスは、最小の子のサイズの中の最大値として、最小サイズを計算します。

1. コンテナ内の子ごとに、子を縮小できる最小サイズを決定します。
   • 子が親の幅または高さに制限されている場合、子は子の最小の幅または高さに縮小できます。子の最小サイズを使用します。
   • 子が親に制限されていない場合、子は子の推奨サイズのままになります。子の推奨サイズを使用します。
2. 手順 1 からサイズの最大値を見つけます。

そのため、子が親に制限されている場合、子の最小サイズがレイアウトで使用されます。それ以外の場合は、子の推奨サイズを使用して、コンテナの最小サイズが計算されます。

エレメントの位置は、次のルール（優先順に記載）に従って決定されます。

• horizontalCenter または verticalCenter 制約は、コンテナの中心とエレメントの中心の間の距離を指定します。エレメントをコンテナ内で水平方向または垂直方向の中心に配置するには、horizontalCenter または verticalCenter 制約をゼロに設定します。
• エレメントのベースラインが指定されている場合、エレメントは、その baselinePosition（通常は、テキストの先頭行のベースライン）が baseline 制約に揃えられるように垂直方向に配置されます。
• エレメントの top または left 制約が指定されている場合、エレメントは、そのレイアウト境界の左上隅がコンテナの左上隅から指定値だけオフセットされるように配置されます。
• エレメントの bottom または right 制約が指定されている場合、エレメントは、そのレイアウト境界の右下隅がコンテナの右下隅から指定値だけオフセットされるように配置されます。
• 制約によって水平または垂直方向の位置が決定されない場合、エレメントは、自身の x および y 座標に従って配置されます。

コンテナのコンテンツのサイズは、すべてのレイアウトエレメントの右下隅の座標の最大値として計算されます。