モジュール javafx.graphics

パッケージ javafx.scene.input

クラスZoomEvent

java.lang.Object

java.util.EventObject

javafx.event.Event

javafx.scene.input.InputEvent

javafx.scene.input.GestureEvent

javafx.scene.input.ZoomEvent

すべての実装されたインタフェース:

Serializable, Cloneable

public final class ZoomEvent
extends GestureEvent

ズーム・イベントは、ユーザーがトラック・パッド、タッチ画面または他の同様のデバイス上で2本の指を離して滑らせるなどのズーム・ジェスチャを実行したことを示します。

イベントは、ジェスチャの開始時にジェスチャ座標で選択された最上位ノードに配信されます。ジェスチャ時に座標が変更された場合でも、ジェスチャ全体が同じノードに配信されます。

イベントによって2つの値が提供されます。zoomFactorはこのイベントのズーム量で、totalZoomFactorはジェスチャ全体のズーム量です。 これらの値は、ノードのscaleプロパティ(ズーム・インの場合は1より大きい値)を乗算することで機能します。

すべてのジェスチャと同様に、ズームは直接的に実行(タッチ画面のように具体的な座標で直接実行 - 通常、すべてのタッチの中心点をジェスチャ座標として使用)することも、間接的に実行(トラック・パッドのように間接的に実行 - 通常、マウス・カーソルの位置をジェスチャ座標として使用)することもできます。

ジェスチャのZOOMイベントは、ZOOM_STARTEDイベントとZOOM_FINISHEDイベントの間に発生します。 該当するプラットフォームでズーム慣性がアクティブになっている場合、isInertia()でtrueが返されたZOOMイベントがZOOM_FINISHEDより後になることがあります。

導入されたバージョン:

JavaFX 2.2

関連項目:

直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static EventType<ZoomEvent>	ANY	すべてのズーム・イベント・タイプに共通のスーパータイプ。
static EventType<ZoomEvent>	ZOOM	このイベントは、2本の指を離すようにドラッグするなど、ユーザーがズーム・ジェスチャを実行したときに発生します。
static EventType<ZoomEvent>	ZOOM_FINISHED	このイベントは、ズーム・ジェスチャが終了したときに発生します。
static EventType<ZoomEvent>	ZOOM_STARTED	このイベントは、ズーム・ジェスチャが検出されたときに発生します。

クラス javafx.event.Eventから継承されたフィールド

consumed、eventType、NULL_SOURCE_TARGET、target

クラス java.util.EventObjectから継承されたフィールド

source

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
ZoomEvent(Object source, EventTarget target, EventType<ZoomEvent> eventType, double x, double y, double screenX, double screenY, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean direct, boolean inertia, double zoomFactor, double totalZoomFactor, PickResult pickResult)	新しいZoomEventイベントを構築します。
ZoomEvent(EventType<ZoomEvent> eventType, double x, double y, double screenX, double screenY, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean direct, boolean inertia, double zoomFactor, double totalZoomFactor, PickResult pickResult)	nullのソースとターゲットを使用した新しいZoomEventイベントを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
ZoomEvent	copyFor(Object newSource, EventTarget newTarget)	指定したイベント・ソースとターゲットを持つこのイベントのコピーを作成して返します。
ZoomEvent	copyFor(Object newSource, EventTarget newTarget, EventType<ZoomEvent> type)	指定のフィールドが置換された特定のイベントのコピーを作成します。
EventType<ZoomEvent>	getEventType()	このイベントのイベント・タイプを取得します。
double	getTotalZoomFactor()	このジェスチャのズーム量を取得します。
double	getZoomFactor()	このイベントのズーム量を取得します。
String	toString()	このZoomEventオブジェクトの文字列表現を返します。

クラス javafx.event.Eventから継承されたメソッド

clone、consume、fireEvent、getTarget、isConsumed

クラス java.util.EventObjectから継承されたメソッド

getSource

クラス javafx.scene.input.GestureEventから継承されたメソッド

getPickResult、getSceneX、getSceneY、getScreenX、getScreenY、getX、getY、getZ、isAltDown、isControlDown、isDirect、isInertia、isMetaDown、isShiftDown、isShortcutDown

クラス java.lang.Objectから継承されたメソッド

equals、finalize、getClass、hashCode、notify、notifyAll、wait、wait、wait

フィールドの詳細

ANY

public static final EventType<ZoomEvent> ANY

すべてのズーム・イベント・タイプに共通のスーパータイプ。

ZOOM

public static final EventType<ZoomEvent> ZOOM

このイベントは、2本の指を離すようにドラッグするなど、ユーザーがズーム・ジェスチャを実行したときに発生します。

ZOOM_STARTED

public static final EventType<ZoomEvent> ZOOM_STARTED

このイベントは、ズーム・ジェスチャが検出されたときに発生します。

ZOOM_FINISHED

public static final EventType<ZoomEvent> ZOOM_FINISHED

このイベントは、ズーム・ジェスチャが終了したときに発生します。

コンストラクタの詳細

ZoomEvent

public ZoomEvent(Object source,
                 EventTarget target,
                 EventType<ZoomEvent> eventType,
                 double x,
                 double y,
                 double screenX,
                 double screenY,
                 boolean shiftDown,
                 boolean controlDown,
                 boolean altDown,
                 boolean metaDown,
                 boolean direct,
                 boolean inertia,
                 double zoomFactor,
                 double totalZoomFactor,
                 PickResult pickResult)

新しいZoomEventイベントを構築します。

パラメータ:

source - イベントのソース。 nullに設定できます。

target - イベントのターゲット。 nullに設定できます。

eventType - イベントのタイプ。

x - シーンに関連するx。

y - シーンに関連するy。

screenX - 画面に対して相対的なx座標。

screenY - 画面に対して相対的なy座標。

shiftDown - Shift修飾子が押された場合はtrueです。

controlDown - Ctrl修飾子が押された場合はtrueです。

altDown - Alt修飾子が押された場合はtrueです。

metaDown - Meta修飾子が押された場合はtrueです。

direct - イベントが直接入力デバイスによって発生した場合はtrueです。 GestureEvent.isDirect()を参照してください。

inertia - すでに終了したジェスチャの慣性を表す場合。

zoomFactor - ズーム量

totalZoomFactor - 累計ズーム量

pickResult - 選択結果。 nullに設定でき、その場合は、シーン座標とターゲットに基づいて、追加の値のない2D選択結果が構築されます。

導入されたバージョン:

JavaFX 8.0

ZoomEvent

public ZoomEvent(EventType<ZoomEvent> eventType,
                 double x,
                 double y,
                 double screenX,
                 double screenY,
                 boolean shiftDown,
                 boolean controlDown,
                 boolean altDown,
                 boolean metaDown,
                 boolean direct,
                 boolean inertia,
                 double zoomFactor,
                 double totalZoomFactor,
                 PickResult pickResult)

nullのソースとターゲットを使用した新しいZoomEventイベントを構築します。

パラメータ:

eventType - イベントのタイプ。

x - シーンに関連するx。

y - シーンに関連するy。

screenX - 画面に対して相対的なx座標。

screenY - 画面に対して相対的なy座標。

shiftDown - Shift修飾子が押された場合はtrueです。

controlDown - Ctrl修飾子が押された場合はtrueです。

altDown - Alt修飾子が押された場合はtrueです。

metaDown - Meta修飾子が押された場合はtrueです。

direct - イベントが直接入力デバイスによって発生した場合はtrueです。 GestureEvent.isDirect()を参照してください。

inertia - すでに終了したジェスチャの慣性を表す場合。

zoomFactor - ズーム量

totalZoomFactor - 累計ズーム量

pickResult - 選択結果。 nullに設定でき、その場合は、シーン座標に基づいて、追加の値のない2D選択結果が構築されます。

導入されたバージョン:

JavaFX 8.0

メソッドの詳細

getZoomFactor

public double getZoomFactor()

このイベントのズーム量を取得します。 係数値は、ノードのscaleプロパティ(ズーム・インの場合は1より大きい値、ズーム・アウトの場合は0と1の間の値)と乗算します。

戻り値:

このイベントのズーム量

getTotalZoomFactor

public double getTotalZoomFactor()

このジェスチャのズーム量を取得します。 係数値は、ノードのscaleプロパティ(ズーム・インの場合は1より大きい値、ズーム・アウトの場合は0と1の間の値)と乗算します。

戻り値:

このジェスチャの累積ズーム量

toString

public String toString()

このZoomEventオブジェクトの文字列表現を返します。

オーバーライド:

toString 、クラス: GestureEvent

戻り値:

このZoomEventオブジェクトの文字列表現

copyFor

public ZoomEvent copyFor(Object newSource,
                         EventTarget newTarget)

クラスからコピーされた説明:GestureEvent

指定したイベント・ソースとターゲットを持つこのイベントのコピーを作成して返します。 ソースまたはターゲットがnullに設定されている場合は、NULL_SOURCE_TARGET値によって置換されます。

オーバーライド:

copyFor 、クラス: GestureEvent

パラメータ:

newSource - コピーされたイベントの新しいソース

newTarget - コピーされたイベントの新しいターゲット

戻り値:

新しいソースとターゲットを含むイベント・コピー

copyFor

public ZoomEvent copyFor(Object newSource,
                         EventTarget newTarget,
                         EventType<ZoomEvent> type)

指定のフィールドが置換された特定のイベントのコピーを作成します。

パラメータ:

newSource - コピーされたイベントの新しいソース

newTarget - コピーされたイベントの新しいターゲット

type - 新しいeventType

戻り値:

フィールドが置換されたイベント・コピー

導入されたバージョン:

JavaFX 8.0

getEventType

public EventType<ZoomEvent> getEventType()

クラスからコピーされた説明: Event

このイベントのイベント・タイプを取得します。 同じEventクラスの複数のオブジェクトは、異なるイベント・タイプを持つことができます。 これらのイベント・タイプでは、発生するイベントの種類をさらに指定します。

オーバーライド:

getEventType 、クラス: GestureEvent

戻り値:

イベント・タイプ