パッケージ | flashx.textLayout.events |
クラス | public class FlowElementMouseEvent |
継承 | FlowElementMouseEvent Event Object |
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このタイプのイベントをリッスンするために、リンクエレメントにイベントリスナーを追加できます。 Event.preventDefault
を呼び出してイベントをキャンセルする場合、イベントに関連付けられているデフォルト動作は行われません。
リンクエレメントにイベントリスナーを追加しない場合、またはイベントリスナー関数によって動作がキャンセルされない場合、イベントは再び送出されます。ただし、今度はリンクエレメント自体によってではなく、リンクエレメントに関連付けられている TextFlow インスタンスによって送出されます。 これにより、TextFlow に追加されたイベントリスナーによってこのイベントを監視する 2 つめの機会が提供されます。
FlowElementMouseEvents は、テキストを編集できない場合、またはマウス操作と同時に Control キーが押された場合にのみ送出されます。
次の 6 つのイベントタイプは、テキストを編集できない場合、または Control キーが押された場合にのみ送出されます。
-
FlowElementMouseEvent.CLICK
-
FlowElementMouseEvent.MOUSE_DOWN
-
FlowElementMouseEvent.MOUSE_UP
-
FlowElementMouseEvent.MOUSE_MOVE
-
FlowElementMouseEvent.ROLL_OVER
-
FlowElementMouseEvent.ROLL_OUT
関連する API エレメント
プロパティ | 定義元 | ||
---|---|---|---|
bubbles : Boolean [読み取り専用]
イベントがバブリングイベントかどうかを示します。 | Event | ||
cancelable : Boolean [読み取り専用]
イベントに関連付けられた動作を回避できるかどうかを示します。 | Event | ||
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
currentTarget : Object [読み取り専用]
イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 | Event | ||
eventPhase : uint [読み取り専用]
イベントフローの現在の段階です。 | Event | ||
flowElement : FlowElement
イベントを送出した FlowElement です。 | FlowElementMouseEvent | ||
originalEvent : MouseEvent
マウス操作で生成された元のマウスイベントです。 | FlowElementMouseEvent | ||
target : Object [読み取り専用]
イベントターゲットです。 | Event | ||
type : String [読み取り専用]
イベントのタイプです。 | Event |
メソッド | 定義元 | ||
---|---|---|---|
FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
マウス操作情報を含むイベントオブジェクトを作成します。 | FlowElementMouseEvent | ||
Event サブクラスのインスタンスを複製します。 | Event | ||
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。 | Event | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。 | Event | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。 | Event | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
Event オブジェクトのすべてのプロパティを含むストリングを返します。 | Event | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
定数 | 定義元 | ||
---|---|---|---|
CLICK : String = "click" [静的]
click イベントオブジェクトの type プロパティ値を定義します。 | FlowElementMouseEvent | ||
MOUSE_DOWN : String = "mouseDown" [静的]
mouseDown イベントオブジェクトの type プロパティ値を定義します。 | FlowElementMouseEvent | ||
MOUSE_MOVE : String = "mouseMove" [静的]
mouseMove イベントオブジェクトの type プロパティ値を定義します。 | FlowElementMouseEvent | ||
MOUSE_UP : String = "mouseUp" [静的]
mouseUp イベントオブジェクトの type プロパティ値を定義します。 | FlowElementMouseEvent | ||
ROLL_OUT : String = "rollOut" [静的]
rollOut イベントオブジェクトの type プロパティ値を定義します。 | FlowElementMouseEvent | ||
ROLL_OVER : String = "rollOver" [静的]
rollOver イベントオブジェクトの type プロパティ値を定義します。 | FlowElementMouseEvent |
flowElement | プロパティ |
flowElement:FlowElement
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
イベントを送出した FlowElement です。
実装
public function get flowElement():FlowElement
public function set flowElement(value:FlowElement):void
関連する API エレメント
originalEvent | プロパティ |
originalEvent:MouseEvent
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
マウス操作で生成された元のマウスイベントです。このプロパティには、次の値を含めることができます。
MouseEvent.CLICK
MouseEvent.MOUSE_DOWN
MouseEvent.MOUSE_UP
MouseEvent.MOUSE_MOVE
MouseEvent.MOUSE_OVER
MouseEvent.MOUSE_OUT
ほとんどの場合、元のイベントはリンクエレメントによって送出されるイベントと一致します。 click
、mouseDown
、mouseOut
、および mouseOver
イベントと一致するイベントです。ただし、次の 2 つのケースでは、リンクエレメントによって元のイベントが関連イベントに変換されます。 リンクエレメントによって mouseOver
イベントが検出されると、rollOver
イベントが送出されます。 同様に、リンクエレメントによって mouseOut
イベントが検出されると、rollOut
イベントが送出されます。 通常、イベントターゲットおよびマウスの座標は、リンクエレメントを含む TextLine インスタンスに関連します。
実装
public function get originalEvent():MouseEvent
public function set originalEvent(value:MouseEvent):void
関連する API エレメント
FlowElementMouseEvent | () | コンストラクター |
public function FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
マウス操作情報を含むイベントオブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメーターとして渡されます。イベントを手動で送出する場合は、コンストラクターを使用します。FlowElement によって生成される FlowElementMouseEvent オブジェクトをリッスンするのに、コンストラクターを使用する必要はありません。
パラメーターtype:String — イベントのタイプです。イベントリスナーは、継承された type プロパティを通じてこの情報にアクセスできます。FlowElementMouseEvent.CLICK 、FlowElementMouseEvent.MOUSE_DOWN 、FlowElementMouseEvent.MOUSE_MOVE 、FlowElementMouseEvent.MOUSE_UP 、FlowElementMouseEvent.ROLL_OVER 、および FlowElementMouseEvent.ROLL_OUT という 6 つのタイプがあります。
| |
bubbles:Boolean (default = false ) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。FlowElementMouseEvent オブジェクトではバブリングを実行できません。
| |
cancelable:Boolean (default = true ) — Event オブジェクトがキャンセル可能かどうかを判断します。イベントリスナーは、継承された cancelable プロパティを通じてこの情報にアクセスできます。FlowElementMouseEvent オブジェクトはキャンセルできません。イベントリスナーで preventDefault() メソッドを呼び出して、このイベントに関連付けられているデフォルト動作をキャンセルできます。
| |
flowElement:FlowElement (default = null ) — このイベントに関連付けられている FlowElement のインスタンス(現在は LinkElement)です。 イベントリスナーは、flowElement プロパティを通じてこの情報にアクセスできます。
| |
originalEvent:MouseEvent (default = null ) — flowElement で発生した元のマウスイベントです。イベントリスナーは、originalEvent プロパティを通じてこの情報にアクセスできます。
|
CLICK | 定数 |
public static const CLICK:String = "click"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
type
プロパティ(click
イベントオブジェクト)の値を定義します。
関連する API エレメント
MOUSE_DOWN | 定数 |
public static const MOUSE_DOWN:String = "mouseDown"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
type
プロパティ(mouseDown
イベントオブジェクト)の値を定義します。
関連する API エレメント
MOUSE_MOVE | 定数 |
public static const MOUSE_MOVE:String = "mouseMove"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
type
プロパティ(mouseMove
イベントオブジェクト)の値を定義します。
関連する API エレメント
MOUSE_UP | 定数 |
public static const MOUSE_UP:String = "mouseUp"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
type
プロパティ(mouseUp
イベントオブジェクト)の値を定義します。
関連する API エレメント
ROLL_OUT | 定数 |
public static const ROLL_OUT:String = "rollOut"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
type
プロパティ(rollOut
イベントオブジェクト)の値を定義します。
関連する API エレメント
ROLL_OVER | 定数 |
public static const ROLL_OVER:String = "rollOver"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
type
プロパティ(rollOver
イベントオブジェクト)の値を定義します。
関連する API エレメント
次の例は、LinkElement instances インスタンスで発生する可能性のあるマウスイベントを監視する方法を示しています。主要な 2 つの手順は、各イベントタイプに対する addEventListener() の呼び出しと、イベントハンドラー関数の作成です。
LinkElement インスタンスに対して addEventListener()
が呼び出されます。"click"
または "mouseDown"
などの単純なストリングを使用できますが、静的定数を使用したほうが安全です。FlowElementMouseEvent クラスには静的定数がないため、次の例では MouseEvent クラスの定数を使用しています。
コードはすべてのイベントで同じであるため、次の例では 1 つのイベントハンドラー関数のみを含めています。通常、各イベントタイプには別個のコードが応答します。このような場合、addEventListener()
の呼び出しごとに別個のイベントハンドラー関数を作成することが推奨されます。
package flashx.textLayout.events.examples { import flash.display.Sprite; import flash.events.MouseEvent; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.LinkElement; import flashx.textLayout.events.FlowElementMouseEvent; import flashx.textLayout.formats.TextLayoutFormat; public class FlowElementMouseEvent_example extends Sprite { private var tf:TextFlow; public function FlowElementMouseEvent_example() { // define TextFlow tf = new TextFlow(); // define link element var linkPar:ParagraphElement = new ParagraphElement(); var linkEl:LinkElement = new LinkElement(); linkEl.href = "http://www.adobe.com/go/flashplayer"; linkEl.target = "_blank"; // when link is clicked, open a new browser window var span1:SpanElement = new SpanElement(); // for text associated with link span1.text = "Get Flash Player"; linkEl.addChild(span1); // define paragraph element for name of events dispatched var textPar:ParagraphElement = new ParagraphElement(); var span2:SpanElement = new SpanElement(); span2.text ="Three most recent events:"; // add span (text) and link elements to the TextFlow linkPar.addChild(linkEl); // add LinkElement to first paragraph textPar.addChild(span2); // add header text to second paragraph tf.addChild(linkPar); // add paragraph with link to text flow tf.addChild(textPar); // add paragraph for events to text flow // add event listeners for all six FlowElementMouseEvent types linkEl.addEventListener(FlowElementMouseEvent.CLICK, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_DOWN, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_MOVE, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_UP, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.ROLL_OVER, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.ROLL_OUT, linkHandler); // create text container for link and event listing text var linkContainer:Sprite = new Sprite(); linkContainer.x = 10; linkContainer.y = 10; var linkController:ContainerController = new ContainerController(linkContainer,200,80); var linkControllerFormat:TextLayoutFormat = new TextLayoutFormat(); linkControllerFormat.paddingTop = 3; linkController.format = linkControllerFormat; tf.flowComposer.addController(linkController); // Add linkContainer to Display List addChild(linkContainer); tf.flowComposer.updateAllControllers(); } // event handler function private function linkHandler(ev:FlowElementMouseEvent):void { var par:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement(); span.text = ev.type; par.addChild(span); tf.replaceChildren(2,2,par); if (tf.numChildren > 5) { tf.removeChildAt(5); } tf.flowComposer.updateAllControllers(); } } }
Tue Jun 12 2018, 10:34 AM Z