SkinnableFill

SkinnableFill (クラス)

            public SkinnableFill
            {inherits Fill}

インポート元： CURL.GUI.STANDARD. package 内で定義されています CURL.GUI.STYLED-CONTROLS.

SkinSpec にデコレーションを委譲することが出来る Fill。

注意事項

このオブジェクトは、"SkinnableFill"のスタイルルールを記述することでスタイル化することが出来ます。

導入: バージョン 7.0

コンストラクタ

clone-appearance-from:

このタイプの新しいオブジェクトを作成するために Visual.clone-appearance が使用するコンストラクタ。

コンストラクタ protected

{SkinnableFill.clone-appearance-from other:SkinnableFill}

default:

このオブジェクトを作成します。

コンストラクタ public

{SkinnableFill.default ...}

プロパティ

clonable-class?:

当該クラスがクローン化可能である場合は、true を返します。その他の場合は false を返します。

アクセサ protected SkinnableFill.clonable-class?:bool

display-context:

このオブジェクトに関連付けられている DisplayContext。

非ローカルオプション public SkinnableFill.display-context:#DisplayContext

skin:

このオブジェクトにデコレーションするスキンの仕様です。

ローカルオプション public SkinnableFill.skin:#SkinSpec =null

skin-orientation:

描画の時のスキンデコレーションの方向。

ローカルオプション public SkinnableFill.skin-orientation:any =null

style-element:

Fill を初期化します。

アクセサ public SkinnableFill.style-element:String

visual-state:

このオブジェクトを描画するときに使用する SkinVisualState。

ローカルオプション public SkinnableFill.visual-state:SkinVisualState =SkinVisualState.enabled

プロパティ継承 DataBindingTarget: data-binding-context, data-bindings

プロパティ継承 EventTarget: event-handlers

プロパティ継承 OptionListInterface: option-register-proc, options-present-here, registered-option-keys

メソッド

after-reposition:

Graphic が移動またはサイズ変更されたことを、Graphic に通知します。

public

{SkinnableFill.after-reposition

layout-context:LayoutContext

}:void

before-reposition:

Graphic が移動またはサイズ変更されることを、Graphic に対して通知します。

public

{SkinnableFill.before-reposition

layout-context:LayoutContext

}:void

clone-appearance-helper:

クローンを作成し、クローン自体を返します。

protected

{SkinnableFill.clone-appearance-helper

fixup:#{proc-type {Visual, Visual}:Visual}

}:Visual

contains-point?:

このクラスのオブジェクトでは、{contains-point? x, y} メソッドは、常に false を返します。これらはイベントについて通知されないからです。

public

{SkinnableFill.contains-point? x:Distance, y:Distance}:bool

draw:

このオブジェクトの可視表現を描画します。

public

{SkinnableFill.draw r:Renderer2d}:void

set-size:

このオブジェクトにレイアウト幅と高さを代入します。

public

{SkinnableFill.set-size lc:LayoutContext, bounds:GRect}:void

メソッド継承 StretchyGraphic: get-height-preference, get-width-preference

メソッド継承 Graphic: attempt-revalidate-layout, constrain-height, constrain-width, create-pagination-state, detach, draw-range-as-selected, draw-shadow, end-pagination, find-ancestor, find-graphic-at, find-graphical-ancestor, fire-inferior-crossing-event, get-graphical-root, get-gui-path, get-origin-in-graphical-ancestor, get-origin-in-root, get-pagination-state, get-range-as-selected-text, get-top-left-in-ancestor, get-visible-bounds-into, graphical-child-visible-at, make-gui-mark, on-drag-enter, on-inspection, on-pointer-enter, option-changed, paginate, paint-with-decorations, pointer-enter-occurred, pointer-leave-occurred, replace-with, request-draw, request-draw-rect, request-layout, request-pointer-trace, search-next, search-next-here, search-prev, search-prev-here, set-layout, start-pagination, xy-offset-to

メソッド継承 GraphicOptions: any-to-Distance, get-display-context

メソッド継承 GuiEventTarget: handle-delegate-event, handle-event, on-action, on-cancel-mode, on-command-changed, on-commit, on-composition-change-event, on-composition-result-event, on-context-menu-event, on-current-record-change-request, on-current-record-changed, on-destroy-notify, on-destroy-requested, on-drag-over, on-drag-pointer, on-drag-started, on-drop, on-end-composition-event, on-focus-event, on-focus-in, on-focus-out, on-gesture, on-gesture-begin, on-gesture-end, on-gesture-magnify, on-gesture-pan, on-gesture-rotate, on-gesture-swipe, on-gesture-tap, on-gesture-touch, on-grab-release, on-gui-event, on-input-method-event, on-key-event, on-key-press, on-pointer-button, on-pointer-crossing, on-pointer-event, on-pointer-motion, on-pointer-press, on-pointer-release, on-pointer-scroll, on-raw-key-event, on-raw-key-press, on-raw-key-release, on-reset, on-selectable-added, on-selectable-removed, on-selection-changed, on-selection-context-activated, on-selection-context-deactivated, on-selection-event, on-start-composition-event, on-start-event, on-stop-event, on-view-activate, on-view-deactivate, on-window-close, remove-event-handlers-for-event-class

メソッド継承 DataBindingTarget: add-data-binding, get-data-binding, refresh-data-binding, remove-data-binding, unset-property, update-data-binding, validate-data-binding

メソッド継承 EventTarget: accepts-event-class?, add-event-handler, event-handler-present?, remove-event-handler, verify-event

メソッド継承 BasicEventTarget: enqueue-event

メソッド継承 InitRestArgParser: process-rest-args

メソッド継承 Object: object-describe, object-describe-for-debugging, object-serialize

コンストラクタ詳細

clone-appearance-from (コンストラクタ)

protected

{SkinnableFill.clone-appearance-from other:SkinnableFill}

このタイプの新しいオブジェクトを作成するために Visual.clone-appearance が使用するコンストラクタ。

other: クローンする SkinnableFill。

注意事項

クローン化をサポートする SkinnableFill のサブクラスには、このコンストラクタを呼び出すコンストラクタが必要です。ただし、これらのコンストラクタがそれぞれ自身のオプションをクローン化し、それぞれの子を、クローンに追加する前にクローン化する場合は、その限りではありません。

default (コンストラクタ)

public

{SkinnableFill.default ...}

このオブジェクトを作成します。

...: オプションと Fill の追加の引数。

導入: バージョン 7.0

プロパティ詳細

clonable-class? (アクセサ)

アクセサ protected SkinnableFill.clonable-class?:bool

当該クラスがクローン化可能である場合は、true を返します。その他の場合は false を返します。

オーバーライド

既定の実装は false を返します。クローン化機能を提供するクラスは、{type-of self} == {compile-time-type-of self} を返すためには、このゲッターをオーバーライドする必要があります。クローン化可能な Visual が必ずしもクローン化可能であるとは限らないので、単に true を返すだけでは正しくありません。

このメソッドをオーバーライドする場合は、Visual.clone-appearance-helper もオーバーライドする必要があります。

display-context (非ローカルオプション)

public SkinnableFill.display-context:#DisplayContext

このオブジェクトに関連付けられている DisplayContext。

プログラミング注意事項

このオプションは、Curl グラフィックシステム内での通信のために使用されます。これは、ユーザーコードで不用意に設定や設定解除を行わないでください。また、通常は、ユーザーコードで直接読み取るべきではありません。現在の DisplayContext が必要な場合は、Visual.get-display-context を呼び出すことによりフェッチしてください。

画面上のウィンドウまたは印刷されたページで表示可能なすべてのグラフィック階層は、そのルートにおいて、display-context オプションを DisplayContext オブジェクトに設定するオブジェクトを持つ必要があります。このオブジェクトは、グラフィック階層の表示に使用される表示媒体に適しています。つまり、オブジェクトは、display-context オプションの値が null から非 null DisplayContext オブジェクトに変更されるのをモニタリングすることにより、表示不可能なグラフィック階層に連結されていることを認識します。したがって、特定の動作を実行する必要のある Visual のサブクラスは、表示不可能なグラフィック階層に接続された場合、次のようなオプション宣言を含むことにより display-context オプションをモニタリングします。

{nonlocal-option public display-context:#DisplayContext
change handler}

ここで、change handler 内のコードは display-context オプションの現在値 (変数 display-context の値として、変更ハンドラ内にある) を取得し、null および非 null の値の間で行われる変更をモニタリングし、必要とされる動作を実行します。

ただし、このプログラミング熟語を使用するプログラマーは、グラフィカル表示を再配列する際、グラフィック階層からグラフィカルオブジェクトを一時的に分離し、これらを同じ階層に再アタッチすることが、割に一般的であることを理解するべきです。この処理により、一時的に分離されたオブジェクトは、display-context オブジェクトが null になり、再び非 null になるのを観察します。display-context オプションでの変更をモニタリングするコードは、この可能性を考慮に入れ、この状況における望ましくない動作の実行を回避しなくてはなりません。

skin (ローカルオプション)

public SkinnableFill.skin:#SkinSpec =null

このオブジェクトにデコレーションするスキンの仕様です。

導入: バージョン 7.0

skin-orientation (ローカルオプション)

public SkinnableFill.skin-orientation:any =null

描画の時のスキンデコレーションの方向。

説明

このプロパティは、描画される時に skin に渡されます。通常は Orientation で TabPlacement の時もあります。詳細の情報は SkinSpec.orientation-aware? と SkinSpec.draw-skin を参照してください。

導入: バージョン 7.0

style-element (アクセサ)

アクセサ public SkinnableFill.style-element:String

Fill を初期化します。

例

Fill を使用するさまざまな方法について、次の例で示します。

例

{VBox
    "A rather long and wordy line of text.",
    {HBox "Left", {Fill}},
    {HBox {Fill}, "Center", {Fill}},
    {HBox {Fill}, "Right"},
    {HBox {Fill width=0.5in}, "Indented", {Fill}},
    {HBox
        {Fill width=0.5in, background="cyan"},
        "Indented with color",
        {Fill}}}

visual-state (ローカルオプション)

public SkinnableFill.visual-state:SkinVisualState =SkinVisualState.enabled

このオブジェクトを描画するときに使用する SkinVisualState。

導入: バージョン 7.0

メソッド詳細

after-reposition (メソッド)

public

{SkinnableFill.after-reposition

layout-context:LayoutContext

}:void

Graphic が移動またはサイズ変更されたことを、Graphic に通知します。

layout-context: このオブジェクトを含んでいるグラフィック階層のサブツリーに対応する LayoutContext オブジェクト。

プログラミング注意事項

この Graphic を移動またはサイズ変更した操作の前に、Graphic.before-reposition を呼び出した場合、このメソッドはこの操作後に呼び出されます。この操作の前にオブジェクトが見えなかったとしても、操作前に Graphic.before-reposition を呼び出さなかった場合は、この操作後に、Graphic.after-reposition でなく Graphic.request-draw が呼び出されます。

Graphic に対して g.after-reposition g が呼び出されるのは、この操作の前に g.before-reposition を呼び出した場合のみです。ただし、この操作の前に g.before-reposition を呼び出しても、この操作の後に g.after-reposition が呼び出されない場合もあります。このような事態が発生するのは、オブジェクトを移動やサイズ変更がなかったと (g の親などが) 判断した場合、あるいは他のオブジェクトが、操作前と操作後の両方で、g の位置の可視境界全体に対する LayoutContext.request-draw-rect-in-root 操作を 1 回以上呼び出した場合です。

Graphic.before-reposition と Graphic.after-reposition はともに、オブジェクトの位置が有効な場合にしか呼び出されません。

オーバーライド

既定の定義 Graphic.after-reposition は、単に Graphic.request-draw を呼び出すだけです。Graphic.request-draw は、Graphic.before-repositionの既定の実装でも使用されていることを前提とした適切な処理方法です。ただし、Graphic.before-reposition をオーバーライドする場合は、Graphic.after-reposition もオーバーライドする必要があります。

Graphic.before-reposition をオーバーライドし、グラフィカルな子の Graphic.before-reposition メソッドを呼び出した場合、このオブジェクトの Graphic.after-reposition メソッドもオーバーライドし、グラフィカルな子の Graphic.after-reposition メソッドを呼び出す必要があります。
Graphic.before-reposition をオーバーライドして Layout.get-visible-rect-in-root-into を呼び出し、このオブジェクトの現在位置およびサイズについての結果情報を保存した場合、このメソッドは、再度 Layout.get-visible-rect-in-root-into を呼び出してその結果を保存結果と比較します。そして、再ペイントに必要な Graphic の古い位置または新しい位置のいずれかに一致する四角形を決定し、さらに、必要に応じて layout-context に対して LayoutContext.request-draw-rect-in-root を呼び出します。

この手法は、描画には負担のかかるオブジェクトを、レイアウトネゴシエーションを行った後に以前と同じ場所に同じサイズで何度も再表示するような場合に特に適しています。このような場合、適切に定義された Graphic.before-reposition と Graphic.after-reposition をオーバーライドする 2 つのメソッドにより、再ペイントが必要ないことが確認されます。

before-reposition (メソッド)

public

{SkinnableFill.before-reposition

layout-context:LayoutContext

}:void

Graphic が移動またはサイズ変更されることを、Graphic に対して通知します。

layout-context: このオブジェクトを含んでいるグラフィック階層のサブツリーに対応する LayoutContext オブジェクト。

プログラミング注意事項

このメソッドは、レイアウトネゴシエーションまたはその他の操作で可視オブジェクトを移動またはサイズ変更するときに必ず呼び出します。このメソッドは、オブジェクトが見えない場合でも呼び出すことができます。また、このメソッドを呼び出したとしても、その後オブジェクトを移動またはサイズ変更しなくてもかまいません。

オーバーライド

既定の定義 Graphic.before-reposition は、単にGraphic.request-draw を呼び出します。これは常に正しい処理です。ただし、高度なオブジェクトでは、このメソッドを次のいずれかのコードでオーバーライドできます。

このオブジェクトが Box の場合に、グラフィカルな子の Graphic.before-reposition メソッドを呼び出すコード。または、
このオブジェクトの現在位置およびサイズに関する情報を保存し、実際に再描画に必要なピクセルを決定するために Graphic.after-reposition を呼び出すまで待機するコード。

この場合、オーバーライドメソッドは、この Graphic のレイアウトオブジェクトに対して Layout.get-visible-rect-in-root-into を呼び出して、この Graphic の可視である部分を決定し、結果情報を Graphic.after-reposition で使用するために保存する必要があります。

clone-appearance-helper (メソッド)

protected

{SkinnableFill.clone-appearance-helper

fixup:#{proc-type {Visual, Visual}:Visual}

}:Visual

クローンを作成し、クローン自体を返します。

オーバーライド

既定の実装はエラーをスローします。クローン化機能を提供するクラスは、

{{compile-time-type-of self}.clone-appearance-from self, fixup}

を返すためには、このゲッターをオーバーライドする必要があります。

contains-point? (メソッド)

public

{SkinnableFill.contains-point? x:Distance, y:Distance}:bool

このクラスのオブジェクトでは、{contains-point? x, y} メソッドは、常に false を返します。これらはイベントについて通知されないからです。

draw (メソッド)

public

{SkinnableFill.draw r:Renderer2d}:void

このオブジェクトの可視表現を描画します。

renderer2d: このオブジェクトを使用してそれ自身を描画する Renderer2d。

オーバーライド

既定のメソッド Graphic.draw は何もしません。Graphic のサブクラスは、必要とされる描画の操作を実行するコードでこのメソッドをオーバーライドしなければなりません。

このメソッドをオーバーライドする場合は、再描画が必要となる時はいつでも、描画する Graphic の範囲が有効でない事を確認しなければなりません。たとえば、データの値を更新するために描画をする時は、データの値が変わる時にアプレットは必ず Graphic.request-draw か Graphic.request-draw-rectを呼び出さなければなりません。

set-size (メソッド)

public

{SkinnableFill.set-size lc:LayoutContext, bounds:GRect}:void

このオブジェクトにレイアウト幅と高さを代入します。

説明

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

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

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

プログラミング注意事項

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

オーバーライド

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