SkinnableControlFill

SkinnableControlFill (クラス)

            public SkinnableControlFill
            {inherits TaggedSkinnableObject, Fill}

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

描画のリクエストを ControlSkin に伝える Fill です。

説明

このオブジェクトには、子の Visual は存在しませんが、ControlSkin の外観やレイアウトで描画される空の状態としてSkinnableControlUI 内で使用され、（Graphic として）イベントを受け取ります。

たとえば、RadioButton におけるトグルグラフィックはこのクラスのインスタンスでグラフィカル階層内に再配置される可能性があります。

注意事項

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

導入: バージョン 6.0

コンストラクタ

default:

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

コンストラクタ public

{SkinnableControlFill.default content-tag:#String = null, ...}

プロパティ

enabled?:

Visual が有効であるかどうかを指定します。

非ローカルオプション public SkinnableControlFill.enabled?:bool

style-element:

Fill を初期化します。

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

プロパティ継承 TaggedSkinnableObject: content-tag

プロパティ継承 Fill: clonable-class?

プロパティ継承 SkinnableObject: ui-object

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

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

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

メソッド

before-reposition:

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

public

{SkinnableControlFill.before-reposition

layout-context:LayoutContext

}:void

contains-point?:

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

public

{SkinnableControlFill.contains-point?

x:Distance,
y:Distance

}:bool

draw:

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

public

{SkinnableControlFill.draw r:Renderer2d}:void

set-size:

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

public

{SkinnableControlFill.set-size

lc:LayoutContext,
bounds:GRect

}:void

メソッド継承 TaggedSkinnableObject: draw-skin, note-graphic-state-change, overdraw-skin

メソッド継承 Fill: clone-appearance-helper

メソッド継承 SkinnableObject: note-ui-changed

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

メソッド継承 Graphic: after-reposition, 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

コンストラクタ詳細

default (コンストラクタ)

public

{SkinnableControlFill.default content-tag:#String = null, ...}

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

content-tag: TaggedSkinnableObject.content-tag を参照してください。

...: Fillのデフォルトコンストラクタへの追加の引数

導入: バージョン 6.0

プロパティ詳細

enabled? (非ローカルオプション)

public SkinnableControlFill.enabled?:bool

Visual が有効であるかどうかを指定します。

説明

このオプションが false の場合、オブジェクトやGUI オブジェクトとのユーザーインタラクションは無効になります。

このオプションを true に設定する代わりに、オプションを unset する方が一般的です。これにより、一部の親コンテナの値は、有効な値を判別します。

このオプションが false の場合、オプションに応じて、テキストは disabled-color および disabled-text-sunken? で表示されます。
例
例
{paragraph I am enabled} {paragraph enabled? = false, I'm not}

このオプションが false で、Visual がコントロールの場合、コントロールのユーザーインターフェイスは無効になります。前述したように、ラベル上の任意のテキストは、無効状態で表示されます。

さらに、コントロールに ReactiveLabel があれば、ラベルは既定ラベルの代わりに ReactiveLabel.label-disabled のプロパティを表示します。

例

{radio-buttons 
    value = "first",
    {RadioButton radio-value = "first"},
    {RadioButton
        radio-value = "second",
        reactive-label = {ReactiveLabel
                             label-disabled = "(second)"
                         },
        enabled? = false
    },
    {RadioButton radio-value = "third"}
}

style-element (アクセサ)

アクセサ public SkinnableControlFill.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}}}

メソッド詳細

before-reposition (メソッド)

public

{SkinnableControlFill.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 で使用するために保存する必要があります。

contains-point? (メソッド)

public

{SkinnableControlFill.contains-point?

x:Distance,
y:Distance

}:bool

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

draw (メソッド)

public

{SkinnableControlFill.draw r:Renderer2d}:void

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

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

オーバーライド

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

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

set-size (メソッド)

public

{SkinnableControlFill.set-size

lc:LayoutContext,
bounds:GRect

}:void

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

説明

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

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

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

プログラミング注意事項

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

オーバーライド

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

例

{paragraph I am enabled} {paragraph enabled? = false, I'm not}