RegionShape

RegionShape (クラス)

            public RegionShape
            {inherits RegionShapeMixin}

パッケージ： CURL.GUI.SHAPES

Region を描画する Shape の実装。

説明

Region はほとんどすべての形状を表現できるため、これは最も一般的な実体形状クラスです。

注意事項

このクラスは次の形状オプションを使用します。

例

{import * from CURL.GUI.SHAPES}

{let shape:RegionShape =
    {RegionShape
        {Region.from-vertices
            {Distance2d 0cm, -1cm},
            {Distance2d 1cm, -1cm},
            {Distance2d 1cm, -.8cm},
            {Distance2d .2cm, -.8cm},
            {Distance2d .2cm, -.6cm},
            {Distance2d .7cm, -.6cm},
            {Distance2d .7cm, -.4cm},
            {Distance2d .2cm, -.4cm},
            {Distance2d .2cm, -.2cm},
            {Distance2d 1cm, -.2cm},
            {Distance2d 1cm, 0cm},
            {Distance2d 0cm, 0cm}
        },
        border-width = 0m,
        color = FillPattern.silver,
        border-color = FillPattern.navy,
        translation = {Distance2d 1cm, 1.5cm}
    }
}

{HBox
    "border-width (in pixels): ",
    {TextField
        width = .5in,
        value = "0",
        {on ValueFinished at field:TextField do
            let p-s:Distance = {shape.get-display-context}.pixel-size
            set shape.border-width = {field.value.to-double} * p-s
        }
    }
}

{Canvas
    width = 3cm,
    height = 2cm,
    shape
}

コンストラクタ

default:

新しい RegionShape を作成します。

コンストラクタ public

{RegionShape.default region:Region, ...}

プロパティ

region:

この RegionShape を定義する領域です。

アクセサ public final RegionShape.region:Region

セッター public final RegionShape.region:Region

style-element:

スタイリングの目的のための、この Visual の "要素" や "型" です。

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

プロパティ継承 RegionShapeMixin: border-color, border-line-style, border-width, color, display-context

プロパティ継承 Shape: as-Shape, draw-operation, option-parent, selection-context, shape-parent, shape-selectable, stroke-thickness, transformation, visible?

プロパティ継承 ShapeContainerBase: as-ShapeRoot, shape-children

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

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

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

メソッド

get-own-bounds:

ローカル座標系におけるこの Shape の四角形のレンダリング境界を計算します。

public

{RegionShape.get-own-bounds dest:GRect = {GRect.empty}}:GRect

get-own-bounds-in-shape-root:

形状ルートである祖先の座標系における、この形状の四角形のレンダリング境界を計算します。

public

{RegionShape.get-own-bounds-in-shape-root

dest:GRect = {GRect.empty}

}:GRect

get-own-layout-bounds:

ローカル座標系におけるこの Shape の四角形のレイアウト境界を計算します。

public

{RegionShape.get-own-layout-bounds

lc:LayoutContext,
width-first?:bool = true,
dest:GRect = {GRect.empty}

}:GRect

self-contains-point?:

ポイントがこの Shape 内にあるかどうかを判定します。

public

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

transformation-changed:

Shape.transformation が変更されたことの通知。

public

{RegionShape.transformation-changed}:void

メソッド継承 RegionShapeMixin: draw, overdraw-for-selection, self-intersects-polygon?

メソッド継承 Shape: apply-rotation, apply-scale, apply-transformation, apply-translation, apply-translation-in-parent, constrain-own-layout-bounds, constrain-shape-layout-bounds, contains-point?, detach, find-graphical-ancestor, fire-crossing-event, fire-in-child, get-display-context, get-down-orientation-in-shape-parent, get-graphical-root, get-local-device-pixel-size, get-origin-in-graphical-ancestor, get-origin-in-root, get-origin-in-shape-parent, get-origin-in-shape-root, get-right-orientation-in-shape-parent, get-shape-bounds, get-shape-bounds-in-shape-root, get-shape-layout-bounds, get-top-left-in-ancestor, get-transformation-to-shape-root, keyword-init-arg, option-change-notify, quantize-line-thickness, request-draw, request-draw-self, reset-transformation, set-rotation, set-scale, set-transformation, set-translation-in-parent, to-Graphic, transform-from-display-coordinates, transform-from-graphical-root-coordinates, transform-point-from-shape-root, transform-point-to-shape-root, transform-to-display-coordinates, transform-to-graphical-root-coordinates, transform-vector-from-shape-root, transform-vector-to-shape-root, transformation-changing

メソッド継承 GraphicOptions: any-to-Distance

メソッド継承 GuiEventTarget: 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-grab-release, on-gui-event, on-input-method-event, on-inspection, 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

{RegionShape.default region:Region, ...}

新しい RegionShape を作成します。

region: この RegionShape を定義する領域です。

...: 通常の Shape の作成引数を渡せます。たとえば、イニシャライザ、変換、子 Shape などです。詳細については、Shape.default を参照してください。

プロパティ詳細

region (アクセサ)

アクセサ public final RegionShape.region:Region

セッター public final RegionShape.region:Region

この RegionShape を定義する領域です。

style-element (アクセサ)

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

スタイリングの目的のための、この Visual の "要素" や "型" です。

説明

この実装によって Visual._style-elementの値が返されますが、通常は定数を返すためにオーバーライドされます。

オーバーライド

Visual のサブクラスのスタイルが他のオブジェクトと異なる場合、このゲッターは適切な文字列を返すようにオーバーライドされる必要があります。慣例では,この文字列はクラス名または、オブジェクトを生成するマークアップの名前です。

オーバーライドでは、空の文字列でないかぎり、self._style-elementを返さなければなりません。

導入: バージョン 6.0

メソッド詳細

get-own-bounds (メソッド)

public

{RegionShape.get-own-bounds dest:GRect = {GRect.empty}}:GRect

ローカル座標系におけるこの Shape の四角形のレンダリング境界を計算します。

dest: データを返すために使用されるオプションの GRect オブジェクト。

戻り値

境界を含む GRect オブジェクト。これは、常に dest と同じオブジェクトになります。この GRect は正しい形式である必要があります。つまり、次の条件が true でなければなりません。 -dest.lextent <= dest.rextent and -dest.ascent <= dest.descent

説明

返された境界は、このオブジェクトによって描画されるすべてのピクセルをカバーしている必要があります。ただし、このオブジェクトのすべての子を含んでいません。

注意事項

レンダリング境界 (get-own-bounds) とレイアウト境界 (get-own-layout-bounds) は、通常似ていますが、同じではありません。特に、レンダリング境界は非常に包括的ですが、レイアウト境界はそれぞれが整然と隣接するため、Shape を厳密に記述しなければならなりません。

オーバーライド

Shape をサブクラス化する場合は、このメソッドをオーバーライドする必要があります。データを返すには、dest パラメータを使用する必要があります。

get-own-bounds-in-shape-root (メソッド)

public

{RegionShape.get-own-bounds-in-shape-root

dest:GRect = {GRect.empty}

}:GRect

形状ルートである祖先の座標系における、この形状の四角形のレンダリング境界を計算します。

dest: データを返すために使用されるオプションの GRect オブジェクト。

戻り値

説明

このメソッドは、Shape.get-own-bounds を呼び出して境界を正しい座標系に変換するために実装されます。

注意事項

形状ルートを持たない形状に対してこのメソッドを呼び出すことはできません。例外が発生します。

オーバーライド

軸平行の四角形を使用するよりも厳密な方法でオブジェクトの境界を変換できる場合は、このメソッドを独自の Shape 実装でオーバーライドすることをお勧めします。

get-own-layout-bounds (メソッド)

public

{RegionShape.get-own-layout-bounds

lc:LayoutContext,
width-first?:bool = true,
dest:GRect = {GRect.empty}

}:GRect

ローカル座標系におけるこの Shape の四角形のレイアウト境界を計算します。

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

width-first?: GraphicShape の場合、width-first レイアウトネゴシエーションを使用して計算されるべき境界であるかを示します。このパラメータは、通常他のサブクラスでは使用されません。

dest: データを返すために使用されるオプションの GRect オブジェクト。

戻り値

説明

返された境界には、レイアウトの使用について、オブジェクトに関する詳細な記述があります。ただし、このオブジェクトのすべての子は含まれていません。

注意事項

オーバーライド

既定の実装では、get-own-bounds を呼び出すだけです。データを返すには、dest パラメータを使用する必要があります。

self-contains-point? (メソッド)

public

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

ポイントがこの Shape 内にあるかどうかを判定します。

x: 点の X 座標。

y: 点の Y 座標。

戻り値

この Shape が (x、y) を含む場合は、true。

説明

ポイントは、このオブジェクトのローカル座標系にあります。このメソッドは、その子を考慮しません。

オーバーライド

Shape をサブクラス化する場合は、このメソッドをオーバーライドする必要があります。このメソッドは、PointerMotion などのマウスイベントをこのオブジェクトにいつ送信するかなどを決定します。

通常は、このメソッドを実装して、ポイントが形状の境界内にあるかどうかだけでなく、ポイントが形状のレンダリングされたプリミティブ内にあるどうかを確認する必要があります。このメソッドは必要なメトリックを使用して自在に実装できます。

transformation-changed (メソッド)

public

{RegionShape.transformation-changed}:void

Shape.transformation が変更されたことの通知。

オーバーライド

重要：このメソッドのオーバーライド実装にスーパークラス実装の呼び出しを含めて、オブジェクトの新しい領域を無効にする必要があります。