パッケージmx.managers
インターフェイスpublic interface ISystemManager extends IEventDispatcher , IChildList , IFlexModuleFactory
実装者 SystemManager, WindowedSystemManager

ISystemManager は「アプリケーションウィンドウ」を管理します。 デスクトップ上またはブラウザで実行されるすべてのアプリケーションには、アプリケーションのビジュアルオブジェクトが表示される領域があります。 これは、オペレーティングシステムのウィンドウである場合と、ブラウザ内の領域である場合があります。 これが「アプリケーションウィンドウ」で、アプリケーション内のメインの「最上位」ウィンドウである mx.core.Application のインスタンスとは異なります。

すべてのアプリケーションには ISystemManager があります。 ISystemManager は、アプリケーションウィンドウのサイズが変更されたときにイベントを送信します（アプリケーションウィンドウのサイズは、オペレーティングシステムのウィンドウまたはブラウザでの操作によってのみ変更可能で、アプリケーション内から変更することはできません）。 これは、メイン mx.core.Application のインスタンスやすべてのポップアップ、ツールヒント、カーソルなど、アプリケーション内で表示可能なすべてのアイテムの親となります。 ISystemManager を親とするオブジェクトは、ツールヒントやカーソルであっても、「最上位」ウィンドウと見なされます。

また、複数の IFocusManagerContainer が表示されていて、ユーザーがこれらの IFocusManagerContainer 内のコンポーネントを操作している場合、ISystemManager は最上位ウィンドウ間でフォーカスを切り替えます。

ISystemManager では明示的にトラップされないキーボード操作およびマウス操作がすべて認識されるため、操作を監視する必要がある場合には適切な監視場所となります。

アプリケーションが別のアプリケーションにロードされた場合でも、ISystemManager は作成されますが、セキュリティやドメインの規則によっては「アプリケーションウィンドウ」を監視しないことがあります。 その代わり、ロードを行った content の Loader になり、単にサブアプリケーションの親として機能します。

ISystemManager では、ツールヒント、カーソル、ポップアップウィンドウごとに、子のリストを維持します。 これによって、ポップアップウィンドウがメインアプリケーションウィンドウの上に「浮動表示」され、その上にツールヒントが浮動表示され、さらにその上にカーソルが浮動表示されるようになります。 ISystemManager の numChildren プロパティまたは getChildAt() メソッドを調べる場合は、メインアプリケーションウィンドウや、ポップアップ表示されないその他のウィンドウにアクセスすることになります。ポップアップ、ツールヒント、およびカーソルを含むすべてのウィンドウのリストを取得するには、rawChildren プロパティを使用します。


パブリックプロパティ
 プロパティ定義元
  cursorChildren : IChildList
[読み取り専用] この ISystemManager を親とするカスタムカーソルのリストです。
ISystemManager
  document : Object
ドキュメントオブジェクトへの参照です。
ISystemManager
  focusPane : Sprite
コンポーネント間で共有される単一の Sprite で、フォーカスを描画するためのオーバーレイとして使用されます。
ISystemManager
  loaderInfo : LoaderInfo
[読み取り専用] アプリケーションに関する情報を表す LoaderInfo オブジェクトです。
ISystemManager
 InheritednumChildren : int
[読み取り専用] この子リストに含まれる子の数です。
IChildList
  numModalWindows : int
モーダルウィンドウの数です。
ISystemManager
  popUpChildren : IChildList
[読み取り専用] この ISystemManager を親とする topMost （ポップアップ）ウィンドウのリストです。
ISystemManager
  rawChildren : IChildList
[読み取り専用] この ISystemManager を親とするすべての子のリストです。
ISystemManager
  screen : Rectangle
[読み取り専用] アプリケーションウィンドウのサイズと位置です。
ISystemManager
  stage : Stage
[読み取り専用] この SystemManager にマッピングされたアプリケーションを表す flash.display.Stage です。
ISystemManager
  swfBridgeGroup : ISWFBridgeGroup
[読み取り専用] このアプリケーションが接続している他のアプリケーションへのすべてのブリッジを含みます。
ISystemManager
  toolTipChildren : IChildList
[読み取り専用] この ISystemManager を親とするツールヒントのリストです。
ISystemManager
  topLevelSystemManager : ISystemManager
[読み取り専用] アプリケーションウィンドウを管理する ISystemManager です。
ISystemManager
パブリックメソッド
 メソッド定義元
  
activate(f:IFocusManagerContainer):void
IFocusManagerContainer 内の FocusManager をアクティブ化します。
ISystemManager
 Inherited
addChild(child:DisplayObject):DisplayObject
この子リストの末尾に子 DisplayObject を追加します。
IChildList
 Inherited
addChildAt(child:DisplayObject, index:int):DisplayObject
この子リストの指定されたインデックス位置に子 DisplayObject を追加します。
IChildList
  
addChildBridge(bridge:IEventDispatcher, owner:DisplayObject):void
システムマネージャに子ブリッジを追加します。
ISystemManager
  
addChildToSandboxRoot(layer:String, child:DisplayObject):void
要求されたレイヤーのサンドボックスルートに子を追加します。
ISystemManager
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
IEventDispatcher
  
addFocusManager(f:IFocusManagerContainer):void
FocusManager が格納されている最上位ウィンドウを登録します。
ISystemManager
 Inherited
contains(child:DisplayObject):Boolean
DisplayObject がこの子リスト内にあるか、またはこの子リストに含まれる子の子孫であるかを判定します。
IChildList
 Inherited
create(... parameters):Object
モジュールが認識している定義のインスタンスを要求するファクトリメソッドです。
IFlexModuleFactory
  
deactivate(f:IFocusManagerContainer):void
IFocusManagerContainer 内の FocusManager を非アクティブ化し、IFocusManagerContainer である 1 つ下のレベルのウィンドウの FocusManager をアクティブ化します。
ISystemManager
  
deployMouseShields(deploy:Boolean):void
マウスシールドを展開または削除します。
ISystemManager
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
IEventDispatcher
  
dispatchEventFromSWFBridges(event:Event, skip:IEventDispatcher = null, trackClones:Boolean = false, toOtherSystemManagers:Boolean = false):void
同じ SecurityDomain にあるかどうかに関係なく、この SystemManager の SWF ブリッジグループ内のすべての親および子アプリケーションにメッセージを送出します。
ISystemManager
 Inherited
getChildAt(index:int):DisplayObject
この子リスト内の指定されたインデックスにある子 DisplayObject を取得します。
IChildList
 Inherited
getChildByName(name:String):DisplayObject
この子リスト内の指定された名前の子 DisplayObject を取得します。
IChildList
 Inherited
getChildIndex(child:DisplayObject):int
この子リスト内の特定の子のインデックスを取得します。
IChildList
  
getDefinitionByName(name:String):Object
指定されたストリングをクラスか、またはパッケージレベルの関数に変換します。
ISystemManager
 Inherited
getObjectsUnderPoint(point:Point):Array
指定されたポイントの下にあり、この子リスト内にある DisplayObject の配列を返します。
IChildList
  
getSandboxRoot():DisplayObject
この SecurityDomain のすべての最上位システムマネージャのルートであるシステムマネージャを取得します。
ISystemManager
  
getTopLevelRoot():DisplayObject
メインアプリケーションにあるシステムマネージャの取得を試行します。
ISystemManager
  
getVisibleApplicationRect(bounds:Rectangle = null):Rectangle
ユーザーが画面で参照できる、ロードされたアプリケーションの境界を取得します。
ISystemManager
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
IEventDispatcher
 Inherited
info():Object
モジュールが認識している静的データを保持するキーと値のペアのブロックを返します。
IFlexModuleFactory
  
isDisplayObjectInABridgedApplication(displayObject:DisplayObject):Boolean
表示オブジェクトが互換モードでロードされた子アプリケーション内または信頼されていないサンドボックス内にあるかどうかをテストします。
ISystemManager
  
isFontFaceEmbedded(tf:TextFormat):Boolean
このアプリケーションに必須フォントが埋め込まれている場合、または Font.registerFont() メソッドを使用してグローバルに登録されている場合は true を返します。
ISystemManager
  
isTopLevel():Boolean
この ISystemManager がアプリケーションウィンドウを管理する場合は true を返します。このアプリケーションが別のアプリケーションにロードされている場合は false を返します。
ISystemManager
  
isTopLevelRoot():Boolean
このシステムマネージャが、すべての最上位システムマネージャのルートかどうかをテストします。
ISystemManager
 Inherited
removeChild(child:DisplayObject):DisplayObject
この子リストから指定された子 DisplayObject を削除します。
IChildList
 Inherited
removeChildAt(index:int):DisplayObject
この子リスト内の指定されたインデックス位置にある子 DisplayObject を削除します。
IChildList
  
removeChildBridge(bridge:IEventDispatcher):void
システムマネージャに子ブリッジを追加します。
ISystemManager
  
removeChildFromSandboxRoot(layer:String, child:DisplayObject):void
要求されたレイヤーのサンドボックスルートから子を削除します。
ISystemManager
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
IEventDispatcher
  
removeFocusManager(f:IFocusManagerContainer):void
FocusManager が格納されている最上位ウィンドウを登録解除します。
ISystemManager
 Inherited
setChildIndex(child:DisplayObject, newIndex:int):void
この子リスト内の特定の子のインデックスを変更します。
IChildList
  
useSWFBridge():Boolean
このシステムマネージャを使用している呼び出し元が、他のマネージャと直接通信する必要があるかどうか、またはブリッジと通信する必要があるかどうかを判断します。
ISystemManager
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
IEventDispatcher
プロパティの詳細
cursorChildrenプロパティ
cursorChildren:IChildList  [読み取り専用]

この ISystemManager を親とするカスタムカーソルのリストです。

ISystemManager には、アプリケーション、ポップアップ、最上位ウィンドウ、ツールヒント、カスタムカーソルなど、さまざまなタイプの子があります。 カスタムカーソルには、cursorChildren プロパティを使用してアクセスできます。

IChildList オブジェクトには、getChildAt() などのメソッドと、numChildren などのプロパティがあります。例えば、cursorChildren.numChildren はカスタムカーソルの数（ または 1 のいずれか）を示し、カスタムカーソルが存在する場合には cursorChildren.getChildAt(0)(0) を使用してアクセスできます。



実装
    public function get cursorChildren():IChildList
documentプロパティ 
document:Object

ドキュメントオブジェクトへの参照です。 ドキュメントオブジェクトは、Flex アプリケーション、MXML コンポーネント、または AS コンポーネントの階層の最上位にあるオブジェクトです。



実装
    public function get document():Object
    public function set document(value:Object):void
focusPaneプロパティ 
focusPane:Sprite

コンポーネント間で共有される単一の Sprite で、フォーカスを描画するためのオーバーレイとして使用されます。 フォーカスがあるコンポーネントの親である場合はこれを共有し、IFocusManagerComponent の場合は共有しません。



実装
    public function get focusPane():Sprite
    public function set focusPane(value:Sprite):void
loaderInfoプロパティ 
loaderInfo:LoaderInfo  [読み取り専用]

アプリケーションに関する情報を表す LoaderInfo オブジェクトです。



実装
    public function get loaderInfo():LoaderInfo
numModalWindowsプロパティ 
numModalWindows:int

モーダルウィンドウの数です。

通常、別のウィンドウでクリックすると、そのウィンドウの FocusManager がアクティブになりますが、モーダルウィンドウではこのクリック操作は許可されません。 PopUpManager は、モーダルウィンドウを作成したとき、および破棄したときに、このカウントを変更します。



実装
    public function get numModalWindows():int
    public function set numModalWindows(value:int):void
popUpChildrenプロパティ 
popUpChildren:IChildList  [読み取り専用]

この ISystemManager を親とする topMost （ポップアップ）ウィンドウのリストです。

ISystemManager には、アプリケーション、ポップアップ、ツールヒント、カスタムカーソルなど、さまざまなタイプの子があります。 最上位ウィンドウには、popUpChildren プロパティを使用してアクセスできます。

IChildList オブジェクトには、getChildAt() などのメソッドと、numChildren などのプロパティがあります。例えば、popUpChildren.numChildren は最上位ウィンドウの数を示し、これらのウィンドウには popUpChildren.getChildAt(i) ) を使用してアクセスできます。



実装
    public function get popUpChildren():IChildList
rawChildrenプロパティ 
rawChildren:IChildList  [読み取り専用]

この ISystemManager を親とするすべての子のリストです。

ISystemManager には、アプリケーション、ポップアップ、ツールヒント、カスタムカーソルなど、さまざまなタイプの子があります。

IChildList オブジェクトには、getChildAt() などのメソッドと、numChildren などのプロパティがあります。



実装
    public function get rawChildren():IChildList
screenプロパティ 
screen:Rectangle  [読み取り専用]

アプリケーションウィンドウのサイズと位置です。 Rectangle オブジェクトには x、y、width、および height プロパティが含まれます。



実装
    public function get screen():Rectangle
stageプロパティ 
stage:Stage  [読み取り専用]

この SystemManager にマッピングされたアプリケーションを表す flash.display.Stage です。



実装
    public function get stage():Stage
swfBridgeGroupプロパティ 
swfBridgeGroup:ISWFBridgeGroup  [読み取り専用]

このアプリケーションが接続している他のアプリケーションへのすべてのブリッジを含みます。



実装
    public function get swfBridgeGroup():ISWFBridgeGroup
toolTipChildrenプロパティ 
toolTipChildren:IChildList  [読み取り専用]

この ISystemManager を親とするツールヒントのリストです。

ISystemManager には、アプリケーション、ポップアップ、最上位ウィンドウ、ツールヒント、カスタムカーソルなど、さまざまなタイプの子があります。

IChildList オブジェクトには、getChildAt() などのメソッドと、numChildren などのプロパティがあります。例えば、toolTipChildren.numChildren はツールヒントの数（ または 1 のいずれか）を示し、ツールヒントが存在する場合には toolTipChildren.getChildAt(0)(0) を使用してアクセスできます。



実装
    public function get toolTipChildren():IChildList
topLevelSystemManagerプロパティ 
topLevelSystemManager:ISystemManager  [読み取り専用]

アプリケーションウィンドウを管理する ISystemManager です。 このアプリケーションが別のアプリケーションにロードされている場合を除き、同じ ISystemManager となります。



実装
    public function get topLevelSystemManager():ISystemManager
メソッドの詳細
activate()メソッド
public function activate(f:IFocusManagerContainer):void

IFocusManagerContainer 内の FocusManager をアクティブ化します。

パラメータ

f:IFocusManagerContainer — アクティブにされる FocusManager を持つ、最上位ウィンドウの IFocusManagerContainer です。

addChildBridge()メソッド 
public function addChildBridge(bridge:IEventDispatcher, owner:DisplayObject):void

システムマネージャに子ブリッジを追加します。各子ブリッジは、別のサンドボックス内のコンポーネントまたは Flex の別のバージョンでコンパイルされたコンポーネントを表します。

パラメータ

bridge:IEventDispatcher — 子のブリッジです。
 
owner:DisplayObject — 子の SWFLoader です。

addChildToSandboxRoot()メソッド 
public function addChildToSandboxRoot(layer:String, child:DisplayObject):void

要求されたレイヤーのサンドボックスルートに子を追加します。

パラメータ

layer:String — SystemManager 内の IChildList の名前です。
 
child:DisplayObject — 追加する DisplayObject です。

addFocusManager()メソッド 
public function addFocusManager(f:IFocusManagerContainer):void

FocusManager が格納されている最上位ウィンドウを登録します。 FocusManager から呼び出されます。通常、アプリケーションコードでは呼び出されません。

パラメータ

f:IFocusManagerContainer — アプリケーション内の最上位ウィンドウ。

deactivate()メソッド 
public function deactivate(f:IFocusManagerContainer):void

IFocusManagerContainer 内の FocusManager を非アクティブ化し、IFocusManagerContainer である 1 つ下のレベルのウィンドウの FocusManager をアクティブ化します。

パラメータ

f:IFocusManagerContainer — 非アクティブにされる FocusManager を持つ、最上位ウィンドウの IFocusManagerContainer です。

deployMouseShields()メソッド 
public function deployMouseShields(deploy:Boolean):void

マウスシールドを展開または削除します。マウスシールドは、信頼されていないアプリケーションへのマウス入力をブロックします。マウス入力をブロックする理由は、信頼されていないアプリケーションにドラッグした場合に、通常はマウス移動イベントを受信できないためです。Flash Player では、セキュリティを考慮して、信頼されている境界と信頼されていない境界をまたがってイベントは送信されません。信頼されていないアプリケーションをマウスシールドで保護することにより (その親であることが前提です)、マウス移動メッセージを取得でき、ドラッグ操作が期待どおりに動作します。

パラメータ

deploy:Boolean — マウスシールドを展開する場合は true、マウスシールドを削除する場合は false です。

dispatchEventFromSWFBridges()メソッド 
public function dispatchEventFromSWFBridges(event:Event, skip:IEventDispatcher = null, trackClones:Boolean = false, toOtherSystemManagers:Boolean = false):void

同じ SecurityDomain にあるかどうかに関係なく、この SystemManager の SWF ブリッジグループ内のすべての親および子アプリケーションにメッセージを送出します。オプションで、このメソッドのパラメータでアプリケーションを除外できます。

パラメータ

event:Event — 送出するイベントです。
 
skip:IEventDispatcher (default = null) — メッセージを送出しない IEventDispatcher を指定します。これは通常、イベントを生成した IEventDispatcher をスキップするために使用されます。
 
trackClones:Boolean (default = false) — 送出されるイベントへの参照を保持するかどうかを示します。
 
toOtherSystemManagers:Boolean (default = false) — AIR 内の他の最上位 SystemManager にイベントを送出するかどうかを示します。

getDefinitionByName()メソッド 
public function getDefinitionByName(name:String):Object

指定されたストリングをクラスか、またはパッケージレベルの関数に変換します。 別のアプリケーションにロードされるかどうかに基づいて、適切な ApplicationDomain.getDefinition() メソッドを呼び出します。

パラメータ

name:String — クラスの名前。例えば、「mx.video.VideoManager」などがあります。

戻り値
Object — name で表されるクラス、または null。
getSandboxRoot()メソッド 
public function getSandboxRoot():DisplayObject

この SecurityDomain のすべての最上位システムマネージャのルートであるシステムマネージャを取得します。

戻り値
DisplayObject — サンドボックス内の最上位の systemManager です。
getTopLevelRoot()メソッド 
public function getTopLevelRoot():DisplayObject

メインアプリケーションにあるシステムマネージャの取得を試行します。

戻り値
DisplayObject — セキュリティ制限によって許可されている場合はメインアプリケーションの systemManager、異なる SecurityDomain にある場合は null です。
getVisibleApplicationRect()メソッド 
public function getVisibleApplicationRect(bounds:Rectangle = null):Rectangle

ユーザーが画面で参照できる、ロードされたアプリケーションの境界を取得します。

パラメータ

bounds:Rectangle (default = null) — オプションです。可視矩形の開始境界です。境界はグローバル座標にあります。bounds が null の場合、開始境界はシステムマネージャの screen プロパティによって定義されます。

戻り値
Rectangle — このオブジェクトの可視部分を含む Rectangle です。矩形はグローバル座標にあります。
isDisplayObjectInABridgedApplication()メソッド 
public function isDisplayObjectInABridgedApplication(displayObject:DisplayObject):Boolean

表示オブジェクトが互換モードでロードされた子アプリケーション内または信頼されていないサンドボックス内にあるかどうかをテストします。

パラメータ

displayObject:DisplayObject — テストする DisplayObject です。

戻り値
Boolean — true は displayObject が互換モードでロードされた子アプリケーション内または信頼されていないサンドボックス内にあることを示し、false はそれ以外の場合を示します。
isFontFaceEmbedded()メソッド 
public function isFontFaceEmbedded(tf:TextFormat):Boolean

このアプリケーションに必須フォントが埋め込まれている場合、true を返します。（または Font.registerFont() メソッドを使用してグローバルに登録されている場合）。

パラメータ

tf:TextFormat — 文字フォーマット情報を表す TextFormat クラスです。

戻り値
Boolean — このアプリケーションに必須フォントが埋め込まれている場合、または Font.registerFont() メソッドを使用してグローバルに登録されている場合は true となります。
isTopLevel()メソッド 
public function isTopLevel():Boolean

この ISystemManager がアプリケーションウィンドウを管理する場合は true を返します。このアプリケーションが別のアプリケーションにロードされている場合は false を返します。

戻り値
Boolean — この ISystemManager がアプリケーションウィンドウを管理する場合は true となります。
isTopLevelRoot()メソッド 
public function isTopLevelRoot():Boolean

このシステムマネージャが、すべての最上位システムマネージャのルートかどうかをテストします。

戻り値
Boolean — SystemManager が表示リストのすべての SystemManager のルートである場合は true、それ以外の場合は false です。
removeChildBridge()メソッド 
public function removeChildBridge(bridge:IEventDispatcher):void

システムマネージャに子ブリッジを追加します。各子ブリッジは、別のサンドボックス内のコンポーネントまたは Flex の別のバージョンでコンパイルされたコンポーネントを表します。

パラメータ

bridge:IEventDispatcher — 子のブリッジです。

removeChildFromSandboxRoot()メソッド 
public function removeChildFromSandboxRoot(layer:String, child:DisplayObject):void

要求されたレイヤーのサンドボックスルートから子を削除します。

パラメータ

layer:String — SystemManager 内の IChildList の名前です。
 
child:DisplayObject — 追加する DisplayObject です。

removeFocusManager()メソッド 
public function removeFocusManager(f:IFocusManagerContainer):void

FocusManager が格納されている最上位ウィンドウを登録解除します。 FocusManager から呼び出されます。通常、アプリケーションコードでは呼び出されません。

パラメータ

f:IFocusManagerContainer — アプリケーション内の最上位ウィンドウ。

useSWFBridge()メソッド 
public function useSWFBridge():Boolean

このシステムマネージャを使用している呼び出し元が、他のマネージャと直接通信する必要があるかどうか、またはブリッジと通信する必要があるかどうかを判断します。

戻り値
Boolean — このシステムマネージャを使用している呼び出し元がサンドボックスブリッジを使用して通信する必要がある場合は true です。システムマネージャが参照を介して他のマネージャを直接呼び出すことができる場合は false です。



© 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/ISystemManager.html