パッケージmx.managers
クラスpublic class ToolTipManager
継承ToolTipManager Inheritance EventDispatcher Inheritance Object

ToolTipManager を使用すると、ツールヒントの表示の遅延時間や無効化など、ツールヒントやエラーヒントの基本的な機能を設定できます。

関連項目

mx.controls.ToolTip
mx.validators.Validator
Using the ToolTip Manager
Using the ToolTip Manager

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  currentTarget : DisplayObject
[静的] 現在ツールヒントを表示している UIComponent です。表示されているツールヒントがない場合は null になります。
ToolTipManager
  currentToolTip : IToolTip
[静的] 現在表示されている ToolTip オブジェクトです。表示されている ToolTip オブジェクトがない場合は null になります。
ToolTipManager
  enabled : Boolean
[静的] true の場合、ユーザーがマウスポインタをコンポーネント上に移動すると、ToolTipManager が自動的にツールヒントを表示します。
ToolTipManager
  hideDelay : Number
[静的] 表示されたツールヒントを非表示にするまでに Flex が待機する時間（ミリ秒）です。
ToolTipManager
  hideEffect : IAbstractEffect
[静的] ツールヒントを非表示にするときに再生するエフェクトです。エフェクトを使用せずにツールヒントを非表示にする場合は null になります。
ToolTipManager
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  scrubDelay : Number
[静的] ユーザーがコントロール間でマウスポインタを移動したときに、Flex が次のツールヒントを表示するまでの時間（showDelay で指定された時間）を再度待機するまでの時間（ミリ秒）です。
ToolTipManager
  showDelay : Number
[静的] ツールヒントを持つコンポーネント上にマウスを移動したとき、ツールヒントボックスを表示させるまでに Flex が待機する時間（ミリ秒）です。
ToolTipManager
  showEffect : IAbstractEffect
[静的] ツールヒントを表示するときに再生するエフェクトです。エフェクトを使用せずにツールヒントを表示する場合は null になります。
ToolTipManager
  toolTipClass : Class
[静的] ツールヒントの作成に使用するクラスです。
ToolTipManager
パブリックメソッド
 メソッド定義元
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
createToolTip(text:String, x:Number, y:Number, errorTipBorderStyle:String = null, context:IUIComponent = null):IToolTip
[静的] 指定されたテキストを使用した ToolTip クラスのインスタンスを作成し、ステージ座標の指定された位置に表示します。
ToolTipManager
  
destroyToolTip(toolTip:IToolTip):void
[静的] createToolTip() メソッドで作成された特定の ToolTip を破棄します。
ToolTipManager
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
プロパティの詳細
currentTargetプロパティ
currentTarget:DisplayObject

現在ツールヒントを表示している UIComponent です。表示されているツールヒントがない場合は null になります。



実装
    public static function get currentTarget():DisplayObject
    public function set currentTarget(value:DisplayObject):void
currentToolTipプロパティ 
currentToolTip:IToolTip

現在表示されている ToolTip オブジェクトです。表示されている ToolTip オブジェクトがない場合は null になります。



実装
    public static function get currentToolTip():IToolTip
    public function set currentToolTip(value:IToolTip):void
enabledプロパティ 
enabled:Boolean

true の場合、ユーザーがマウスポインタをコンポーネント上に移動すると、ToolTipManager が自動的にツールヒントを表示します。 false の場合、ツールヒントは表示されません。

デフォルト値 : true.



実装
    public static function get enabled():Boolean
    public function set enabled(value:Boolean):void
hideDelayプロパティ 
hideDelay:Number

表示されたツールヒントを非表示にするまでに Flex が待機する時間（ミリ秒）です。 非表示になったツールヒントを再び表示するには、いったんコンポーネントの外側にマウスを移動してから、再度そのコンポーネント上にマウスを移動する必要があります。 hideDelay プロパティを Infinity に設定した場合、マウスをコンポーネントの外側に移動するなど、ユーザーが何らかのイベントをトリガするまでツールヒントは表示されたままになります。

デフォルト値 : 10000.



実装
    public static function get hideDelay():Number
    public function set hideDelay(value:Number):void
hideEffectプロパティ 
hideEffect:IAbstractEffect

ツールヒントを非表示にするときに再生するエフェクトです。エフェクトを使用せずにツールヒントを非表示にする場合は null になります。

デフォルト値 : null.



実装
    public static function get hideEffect():IAbstractEffect
    public function set hideEffect(value:IAbstractEffect):void
scrubDelayプロパティ 
scrubDelay:Number

ユーザーがコントロール間でマウスポインタを移動したときに、Flex が次のツールヒントを表示するまでの時間（showDelay で指定された時間）を再度待機するまでの時間（ミリ秒）です。

この設定は、ユーザーがコントロール間でマウスを素早く移動した場合に役立ちます。例えば、Flex が最初のツールヒントを表示した後、待機せずにすぐに別のツールヒントを表示するようにできます。 scrubDelay の設定が短いほど、ユーザーが、次のツールヒントが表示されるまでに showDelay に指定された時間を待機する必要性が高くなります。 このプロパティは、ツールバーに複数のボタンがあり、ユーザーがそれぞれの簡潔な説明を見てすばやくそれらの機能を把握する場合に有効です。

デフォルト値 : 100.



実装
    public static function get scrubDelay():Number
    public function set scrubDelay(value:Number):void
showDelayプロパティ 
showDelay:Number

ツールヒントを持つコンポーネント上にマウスを移動したとき、ツールヒントボックスを表示させるまでに Flex が待機する時間（ミリ秒）です。 ツールヒントを即時に表示するには、showDelay を 0 に設定します。

デフォルト値 : 500.



実装
    public static function get showDelay():Number
    public function set showDelay(value:Number):void
showEffectプロパティ 
showEffect:IAbstractEffect

ツールヒントを表示するときに再生するエフェクトです。エフェクトを使用せずにツールヒントを表示する場合は null になります。

デフォルト値 : null.



実装
    public static function get showEffect():IAbstractEffect
    public function set showEffect(value:IAbstractEffect):void
toolTipClassプロパティ 
toolTipClass:Class

ツールヒントの作成に使用するクラスです。

デフォルト値 : mx.controls.ToolTip.



実装
    public static function get toolTipClass():Class
    public function set toolTipClass(value:Class):void
メソッドの詳細
createToolTip()メソッド
public static function createToolTip(text:String, x:Number, y:Number, errorTipBorderStyle:String = null, context:IUIComponent = null):IToolTip

指定されたテキストを使用した ToolTip クラスのインスタンスを作成し、ステージ座標の指定された位置に表示します。

ツールヒントは、カーソルを除いたすべてのエレメントの上部に独自の層で表示されます。

ツールヒントの標準的な使用方法は、toolTip プロパティが設定されたオブジェクト上にユーザーがマウスを移動したときに、ツールヒントの表示と非表示を ToolTipManager によって自動的に切り替えるようにすることです。 ToolTipManager の enabled プロパティを false に設定すると、この自動ツールヒント管理を無効にできます。

一方、このメソッド (destroyToolTip()) を使用すると、ツールヒントをプログラムで制御できます。ツールヒントをいつ、どこに表示するかを選択することが可能で、さらに必要に応じて複数のツールヒントを同時に表示することもできます （ToolTipManager でこのような操作を行うことはありません。これを行うと、通常はユーザーを混乱させることになるためです）。

このメソッドはツールヒントの新しいインスタンスを作成してから、addChild() メソッドを呼び出して、このインスタンスを SystemManager の toolTips 層に配置します。エラーヒントを表示する場合は、このメソッドによって適切なスタイルが設定されます。 次に、このメソッドは、ツールヒントのテキストを設定し、そのテキストに基づいてツールヒントのサイズを設定して、指定された場所に配置します。

このメソッドが返すツールヒントへの参照を保存して、destroyToolTip() メソッドに渡せるようにする必要があります。

パラメータ

text:String — ツールヒントのインスタンスに表示するテキストです。
 
x:Number — ツールヒントのステージ座標での水平座標。 複数のステージがある場合は、context 引数から、関連するステージを判別します。
 
y:Number — ツールヒントのステージ座標での垂直座標。 複数のステージがある場合は、context 引数から、関連するステージを判別します。
 
errorTipBorderStyle:String (default = null) — エラーヒントの境界線スタイル。 このメソッドのパラメータは、null、「errorTipRight」、「errorTipAbove」、または「errorTipBelow」のいずれかになります。 null の場合、createToolTip() メソッドは標準ツールヒントを作成します。"errorTipRight"、"errorTipAbove"、または "errorTipBelow" の場合、createToolTip() メソッドはエラーヒントを作成し、このパラメータによってエラーヒントの矢印がどこを指すかが決定されます (エラーのターゲット)。例えば、「errorTipRight」を渡すと、エラーヒントは（x および y パラメータを使用して）エラーターゲットの右側に配置されます。矢印は、エラーヒントの左端にあります。
 
context:IUIComponent (default = null) — このプロパティは現在使用されていません。

戻り値
IToolTip — 新しく作成されたツールヒントです。
destroyToolTip()メソッド 
public static function destroyToolTip(toolTip:IToolTip):void

createToolTip() メソッドで作成された特定の ToolTip を破棄します。

このメソッドは removeChild() メソッドを呼び出して、指定されたツールヒントを SystemManager の ToolTips 層から削除します。このツールヒントへの参照を維持しない限り、ツールヒントはガベージコレクションされます。

このメソッドは、ToolTipManager の currentToolTip では使用しないでください。

パラメータ

toolTip:IToolTip — 破棄する ToolTip のインスタンスです。




© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/managers/ToolTipManager.html