この項目はサポートされていません。内部使用限定となっています。

この項目はサポートされていません。内部使用限定となっています。

新しい SequenceLayout。

これをオーバーライドしてサブクラスの Layout を変更します。

lc: このレイアウト ネゴシエーションに対して有効な LayoutContext。

bool。このオブジェクトのレイアウト設定が変更されていない場合は true。値が false の場合、変更の有無にかからわずレイアウト ネゴシエーションの確認が行なわれます。

このメソッドは、完全なレイアウト ネゴシエーション、つまり、Graphic.set-size を呼び出してネゴシエーションを行ったオブジェクトに対してのみ呼び出すことを推奨します。このメソッドが true を返すと、直前の完全なレイアウト ネゴシエーション中に行われた同じ高さおよび幅設定の確認が繰り返された場合に、オブジェクトが、以前返された答えと全く同じ答え (OriginElastic.equal? によって計算された答え) を返すことになります。

このメソッドからオブジェクトがすぐに true を返す最も一般的なケースは、直前のレイアウト ネゴシエーションの結果を無効にするようなことがオブジェクトで発生しなかった場合です。また、このメソッドが true を返すこれ以外のケースは、Box であるオブジェクトの場合で、Box の子すべてに対して Graphic.attempt-revalidate-layout を呼び出し、これらの呼び出しすべてで true が返されたときに true を返します(Box の設定が Box の子の設定と変更されたかどうかが不明なその他のパラメータにのみ依存する場合、この処理が有効です)。

このメソッドが true を返し、このオブジェクトの親にその境界を変更する理由がない場合、親がこのオブジェクトに対してさらにレイアウト ネゴシエーションを呼び出す可能性はありません。したがって、このオブジェクトがそのレイアウトの有効性の判定を記録している場合、このメソッドから true を返す前にオブジェクトはそれ自体を layout-valid 状態に設定する必要があります。

このメソッドは通常このオブジェクトの親 Box の Box.attempt-revalidate-layout メソッドによって呼び出されます。この目的は、非効率な計算をトリガしないで、このオブジェクトから得た前回のレイアウト設定がまだ有効であるかどうかを確認するクイック ファスト チェックを行なうことです。

既定のメソッド Graphic.attempt-revalidate-layout は、単に false を返します。false は常に安全な応答です。レイアウト設定が実際には変更されなかったできる限り多くの状況で true を返すメソッドで、このメソッドをオーバーライドするには、より正確な応答を提供できる Graphic のサブクラスを使用することをお勧めします。

この項目はサポートされていません。内部使用限定となっています。

lc: このレイアウト ネゴシエーションに対して有効な LayoutContext。

ascent, descent: 高さの制約。この Graphic の起点からの相対的な上昇および下降の距離で表されます。

オブジェクトの幅設定を表す Dimension。この Dimension は、後続のレイアウト処理中に OriginElastic に変換されます。

既定のメソッド Graphic.constrain-height は、単に Graphic.get-width-preference を呼び出します。このメソッドは、オブジェクトが幅設定を計算する際に高さの制約を考慮しなくてもいい場合はオーバーライドする必要がありません。

このメソッドをオーバライドするクラスでは必ず Dimension を返すようにして、これで必要な水平軸に沿ったスペースをそのオブジェクトの起点との関係を含めて表します。実際には、これはこのメソッドが適切な OriginElastic または Dimension を返すことを意味します。Dimension の場合は、「次元から OriginElastics への変換」で説明する変換規則に従って、適切な OriginElastic に変換されます。

重要：このメソッドのオーバーライド実装には、レイアウト ネゴシエーションが確実にグラフィック階層全体に適用されるように、スーパークラス実装の呼び出しを含める必要があります。

lc: このレイアウト ネゴシエーションに対して有効な LayoutContext。

lextent, rextent: 幅の制約。起点からの左と右の相対距離で表されます。

オブジェクトの高さ設定を表す Dimension。この Dimension は、後続のレイアウト処理中に OriginElastic に変換されます。

既定のメソッド Graphic.constrain-width は、単に Graphic.get-height-preference を呼び出します。このメソッドは、オブジェクトが高さ設定を計算する際に幅制約を考慮しなくてもいい場合はオーバーライドする必要がありません。

このメソッドをオーバライドするクラスでは必ず Dimension を返すようにして、これで必要な垂直軸に沿ったスペースをそのオブジェクトの起点との関係を含めて表します。実際には、これはこのメソッドが適切な OriginElastic または Dimension を返すことを意味します。Dimension の場合は、「次元から OriginElastics への変換」で説明する変換規則に従って、適切な OriginElastic に変換されます。

重要：このメソッドのオーバーライド実装には、レイアウト ネゴシエーションが確実にグラフィック階層全体に適用されるように、スーパークラス実装の呼び出しを含める必要があります。

lc: このレイアウト ネゴシエーションに対して有効な LayoutContext。

オブジェクトの高さ設定を表す Dimension。この Dimension は、後続のレイアウト処理中に OriginElastic に変換されます。

このメソッドは、Graphic のサブクラス内で定義する必要があります。

このメソッドをオーバライドするクラスでは必ず Dimension を返すようにして、これで必要な垂直軸に沿ったスペースをそのオブジェクトの起点との関係を含めて表します。実際には、これはこのメソッドが適切な OriginElastic または Dimension を返すことを意味します。Dimension の場合は、「次元から OriginElastics への変換」で説明する変換規則に従って、適切な OriginElastic に変換されます。

lc: このレイアウト ネゴシエーションに対して有効な LayoutContext。

このオブジェクトの幅設定を表す Dimension。この Dimension は、後続のレイアウト処理中に OriginElastic に変換されます。

このメソッドは、Graphic のサブクラスで定義する必要があります。

このメソッドをオーバライドするクラスでは必ず Dimension を返すようにして、これで必要な水平軸に沿ったスペースをそのオブジェクトの起点との関係を含めて表します。実際には、これはこのメソッドが適切な OriginElastic または Dimension を返すことを意味します。Dimension の場合は、「次元から OriginElastics への変換」で説明する変換規則に従って、適切な OriginElastic に変換されます。

epoch: このレイアウト無効化に関連付けられている Layout Epoch。これは、通常、get-layout-epoch を使用して得られる現在の Layout Epoch です。

一般的に、このメソッドは、Box.request-layout から Box の親にレイアウトの要求を伝えるために呼び出されるか、Layout.request-layout から呼び出されます。

Box でこのメソッドを呼び出すことは、Box のグラフィカルな子孫のいずれかが新しいレイアウト ネゴシエーションを要求していることを示します。この状況は、Box での Box.request-layout の呼び出しとは対照的です。この場合は、Box 自体が新しいレイアウト ネゴシエーションを要求していることを意味します。これらの 2 つの別個のメソッドが提供されるのは、その後のレイアウト ネゴシエーションの初めに Graphic.attempt-revalidate-layout が呼び出されるときに、異なるアクションを保証するためです。Box.propagate-request-layout の呼び出しによって、この Box にレイアウト要求が通知された場合は、Box 自体では何も変更されていないので、Box の子で Graphic.attempt-revalidate-layout メソッドが呼び出されたときにすべての子の答えが true であれば、Box の Graphic.attempt-revalidate-layout に対する答えは常に true になります。しかし、Box.request-layout が呼び出された場合は、Box は、そのすべての子のレイアウトについて有効性を再検証できたとしても、それ自体のレイアウトが有効とは認められない場合があります。これは、グラフィカルな子の追加や削除、またはそれらの子の空白や配列での変更など、Box 自体の構造で変更が加えられている可能性があるからです。

このメソッドは、情報を保持してレイアウト無効化を追跡する Box サブクラスでオーバーライドできます。このようなオーバーライド メソッドにはすべて super.propagate-request-layout の呼び出しが必要です。このメソッドは、グラフィック階層のルートになるように設計されている View などのクラスでもオーバーライドされます。この場合、レイアウト要求を記録し、新しいレイアウト ネゴシエーションに合わせて整列させるコードによってメソッドがオーバーライドされます。

lc: レイアウト ネゴシエーションを管理する LayoutContext。

現在のレイアウト ネゴシエーションの最初の次元に従って self のサイズ設定を計算します。したがって、この次元が幅の場合、メソッドは self の幅設定を表す OriginElastic を返し、高さを先に処理するレイアウト ネゴシエーションが進行中の場合は、self の高さ設定を表す OriginElastic を代わりに返します。

キャッシュされたサイズ設定が使用可能でない (または有効でない) のでサイズ設定を計算する必要がある場合、このメソッドは、self の内部メソッドから呼び出されます。

LengthBreadthBox はこれを抽象メソッドとして宣言します。具象サブクラスでは、このメソッドが必要な OriginElastic 値を計算するように、このメソッドをオーバーライドする必要があります。

lc: レイアウト ネゴシエーションを管理する LayoutContext。

before, after: このメソッドの結果の計算に使用されるサイズ制約。

現在のレイアウト ネゴシエーションの最初の次元でない次元に従って self のサイズを設定します。したがって、最初の次元が幅の場合、このメソッドはこのオブジェクトの高さの特性を示す上昇値および下降値として、それぞれ before および after を使用します。逆に、高さを先に処理するレイアウト ネゴシエーションでは、このオブジェクトの幅の特性を示す左右の範囲としてそれぞれ before および after を使用します。最終的にこのメソッドを呼び出すと、このオブジェクトのそれぞれの子で呼び出される Graphic.set-size になります。

このオブジェクトのそれぞれの子の set-size メソッドを呼び出すときには、このメソッドは self の内部のメソッドから呼び出されます。

LengthBreadthBox はこれを抽象メソッドとして宣言します。具象サブクラスでは、このメソッドが必要な操作を実行するように、このメソッドをオーバーライドする必要があります。

lc: レイアウト ネゴシエーションを管理する LayoutContext。

before, after: このメソッドの結果の計算に使用されるサイズ制約。

現在のレイアウト ネゴシエーションの最初の次元でない次元に従って self のサイズ設定を計算します。したがって、最初の次元が幅の場合、このメソッドは self の高さ設定を表す OriginElastic を返し、高さを先に処理するレイアウト ネゴシエーションが進行中の場合、self の幅設定を表す OriginElastic を代わりに返します。

before および after は、レイアウト ネゴシエーションの最初の次元に従った適切なサイズ制約を表します。こうした値は、Graphic.constrain-width の呼び出しにおいて lextent と rextent の役割を果たします。あるいは、高さを先に処理するネゴシエーションでは、Graphic.constrain-height の呼び出しにおいて ascent と descent の役割を果たします。

キャッシュされたサイズ設定が使用可能でない (または有効でない) のでサイズ設定を計算する必要がある場合、このメソッドは、self の内部メソッドから呼び出されます。

LengthBreadthBox はこれを抽象メソッドとして宣言します。具象サブクラスでは、このメソッドが必要な OriginElastic 値を計算するように、このメソッドをオーバーライドする必要があります。

この項目はサポートされていません。内部使用限定となっています。

このオブジェクトで set-size を呼び出すと、オブジェクトのレイアウト サイズを代入し、オブジェクトのレイアウト ネゴシエーションを完了します。グラフィック階層のすべてのオブジェクトにレイアウト サイズが代入された後で階層のレイアウト ネゴシエーションが完了します。

lc: このレイアウト ネゴシエーションに対して有効な LayoutContext。

bounds: このオブジェクトの境界ボックスの左右および上下の範囲をオブジェクトの起点から相対的に示す GRect。

このメソッドは、オブジェクトのグラフィカルな親によって呼び出されます。

既定のメソッド Graphic.set-size は何も行ないません。Graphicのサブクラスはこのメソッドをオーバーライドして、ここで提供した情報をインターセプトできます。