パッケージmx.styles
クラスpublic class StyleManager
継承StyleManager Inheritance Object

StyleManager クラスでは次の事項が管理されます。

関連項目

mx.styles.CSSStyleDeclaration
About styles
Using the StyleManager class

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  selectors : Array
[静的] [読み取り専用] StyleManager に登録されているすべての CSS セレクタを含む配列を返します。
StyleManager
パブリックメソッド
 メソッド定義元
  
clearStyleDeclaration(selector:String, update:Boolean):void
[静的] 指定した CSS セレクタの規則を保存する CSSStyleDeclaration オブジェクトをクリアします。
StyleManager
  
getColorName(colorName:Object):uint
[静的] 指定されたカラーストリングに対応する RGB カラー数値を返します。
StyleManager
  
getColorNames(colors:Array):void
[静的] カラー配列の各エレメントを、カラー名から RGB カラー数値に変換します。
StyleManager
  
getStyleDeclaration(selector:String):CSSStyleDeclaration
[静的] 指定した CSS セレクタの規則を保存する CSSStyleDeclaration オブジェクトを取得します。
StyleManager
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
isColorName(colorName:String):Boolean
[静的] 指定されたストリングがカラー値のエイリアスかどうかをテストします。
StyleManager
  
isInheritingStyle(styleName:String):Boolean
[静的] スタイルが継承されるかどうかをテストします。
StyleManager
  
isInheritingTextFormatStyle(styleName:String):Boolean
[静的] TextFormat スタイルが継承されるかどうかをテストします。
StyleManager
  
isParentDisplayListInvalidatingStyle(styleName:String):Boolean
[静的] このスタイルがコンポーネントの親コンテナに反映され、このスタイルが変更されたときに親コンテナが必ず再描画されるようになるかどうかをテストします。
StyleManager
  
isParentSizeInvalidatingStyle(styleName:String):Boolean
[静的] スタイルでコンポーネントの親コンテナが変更されるかどうかをテストします。
StyleManager
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
isSizeInvalidatingStyle(styleName:String):Boolean
[静的] スタイルでコンポーネントのサイズが変更されるかどうかをテストします。
StyleManager
  
isValidStyleValue(value:*):Boolean
[静的] 指定されたパラメータが有効なスタイルプロパティかどうかを判別します。
StyleManager
  
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
[静的] スタイル SWF をロードします。
StyleManager
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
registerColorName(colorName:String, colorValue:uint):void
[静的] カラーのエイリアスのリストにカラー名を追加します。
StyleManager
  
registerInheritingStyle(styleName:String):void
[静的] 親から値を継承できるスタイルのリストに追加します。
StyleManager
  
registerParentDisplayListInvalidatingStyle(styleName:String):void
[静的] コンポーネントの親コンテナの外観またはレイアウトに影響する可能性のあるスタイルのリストに追加します。
StyleManager
  
registerParentSizeInvalidatingStyle(styleName:String):void
[静的] コンポーネントの親コンテナの測定サイズに影響する可能性のあるスタイルのリストに追加します。
StyleManager
  
registerSizeInvalidatingStyle(styleName:String):void
[静的] コンポーネントの測定サイズに影響する可能性のあるスタイルのリストに追加します。
StyleManager
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
[静的] 指定した CSS セレクタの規則を保存する CSSStyleDeclaration オブジェクトを設定します。
StyleManager
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
  
unloadStyleDeclarations(url:String, update:Boolean = true):void
[静的] スタイル SWF をアンロードします。
StyleManager
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義元
  NOT_A_COLOR : uint = 0xFFFFFFFF
[静的] passed-in ストリングが適切なカラー名でない場合、getColorName() メソッドはこの値を返します。
StyleManager
プロパティの詳細
selectorsプロパティ
selectors:Array  [読み取り専用]

StyleManager に登録されているすべての CSS セレクタを含む配列を返します。 この配列の項目を getStyleDeclaration() メソッドに渡して、対応する CSSStyleDeclaration オブジェクトを取得できます。クラスセレクタの前にはピリオドが付加されます。



実装
    public static function get selectors():Array
メソッドの詳細
clearStyleDeclaration()メソッド
public static function clearStyleDeclaration(selector:String, update:Boolean):void

指定した CSS セレクタの規則を保存する CSSStyleDeclaration オブジェクトをクリアします。

指定したセレクタがクラスセレクタ（".bigMargins" や ".myStyle" など）の場合、selector プロパティの先頭をピリオド（.）にする必要があります。

指定したセレクタがタイプセレクタ（"Button" など）の場合、selector プロパティの先頭をピリオドにしないでください。

global セレクタはタイプセレクタに似ており、先頭にはピリオドがありません。

パラメータ

selector:String — クリアする CSS セレクタの名前です。
 
update:Boolean — スタイルを強制的に即時更新するには、true に設定します。 アプリケーションのスタイルを強制的に即時更新しないようにするには、false に設定します。このメソッドの詳細については、setStyleDeclaration() メソッドの説明を参照してください。

関連項目

setStyleDeclaration()
getColorName()メソッド 
public static function getColorName(colorName:Object):uint

指定されたカラーストリングに対応する RGB カラー数値を返します。 カラーストリングは、"red"、"Blue" または "haloGreen" などの大文字と小文字を区別しないカラー名、0xFF0000 などの 16 進数値、または "#FF0000" などの #-16 進数のストリングです。

このメソッドは、カラーを表す 4521830 などの uint を返します。 この uint を 16 進数値に変換するには、次の例のように、基数 (この場合は 16) を uint クラスの toString() メソッドに渡します。

      import mx.styles.StyleManager;
      private function getNewColorName():void {
          StyleManager.registerColorName("soylentGreen",0x44FF66);
          trace(StyleManager.getColorName("soylentGreen").toString(16));
      }

パラメータ

colorName:Object — カラー名です。

戻り値
uint — カラー値を表す uint か NOT_A_COLOR を返します。後者は、colorName プロパティの値がカラーのエイリアスでない場合に返されます。
getColorNames()メソッド 
public static function getColorNames(colors:Array):void

カラー配列の各エレメントを、カラー名から RGB カラー数値に変換します。 各カラーストリングは、"red"、"Blue"、"haloGreen" などの大文字と小文字を区別しないカラー名、0xFF0000 などの 16 進数値、または "#FF0000" などの #-16 進数のストリングです。

パラメータ

colors:Array — カラー名の配列です。

getStyleDeclaration()メソッド 
public static function getStyleDeclaration(selector:String):CSSStyleDeclaration

指定した CSS セレクタの規則を保存する CSSStyleDeclaration オブジェクトを取得します。

selector パラメータの先頭がピリオド（.）である場合は、戻される CSSStyleDeclaration はクラスセレクタであり、styleName プロパティがそのクラスセレクタ（ピリオドを含まないもの）を指定するインスタンスにのみ適用されます。 例えば、クラスセレクタ ".bigMargins" は、styleName が "bigMargins" であるすべての UIComponent に適用されます。

selector パラメータの先頭がピリオドではない場合は、戻される CSSStyleDeclaration はタイプセレクタであり、該当タイプのすべてのインスタンスに適用されます。 たとえば、タイプセレクタ "Button" は、Button とそのサブクラスのすべてのインスタンスに適用されます。

global セレクタはタイプセレクタに似ており、先頭にはピリオドがありません。

パラメータ

selector:String — CSS セレクタの名前です。

戻り値
CSSStyleDeclaration — 名前が selector プロパティと一致するスタイル宣言です。
isColorName()メソッド 
public static function isColorName(colorName:String):Boolean

指定されたストリングがカラー値のエイリアスかどうかをテストします。 例えば、ストリング "blue" はデフォルトで 0x0000FF のエイリアスになっています。

パラメータ

colorName:String — テストするカラー名です。 このパラメータでは大文字と小文字が区別されません。

戻り値
Boolean — true が返されるのは、colorName がカラーのエイリアスの場合です。
isInheritingStyle()メソッド 
public static function isInheritingStyle(styleName:String):Boolean

スタイルが継承されるかどうかをテストします。

パラメータ

styleName:String — 継承されるかどうかをテストするスタイルの名前です。

戻り値
Boolean — 指定のスタイルが継承スタイルである場合、true を返します。
isInheritingTextFormatStyle()メソッド 
public static function isInheritingTextFormatStyle(styleName:String):Boolean

TextFormat スタイルが継承されるかどうかをテストします。

パラメータ

styleName:String — 継承されるかどうかをテストするスタイルの名前です。

戻り値
Boolean — 指定の TextFormat スタイルが継承スタイルである場合、true を返します。
isParentDisplayListInvalidatingStyle()メソッド 
public static function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

このスタイルがコンポーネントの親コンテナに反映され、このスタイルが変更されたときに親コンテナが必ず再描画されるようになるかどうかをテストします。

これらのスタイルのいずれかを setStyle() により設定すると、子の再描画または再レイアウトのために、コンポーネントの親コンテナに対して invalidateDisplayList() メソッドが自動的に呼び出されます。

パラメータ

styleName:String — テストするスタイルの名前です。

戻り値
Boolean — 指定のスタイルがコンポーネントの親コンテナの外観またはレイアウトに影響する可能性がある場合に true を返します。
isParentSizeInvalidatingStyle()メソッド 
public static function isParentSizeInvalidatingStyle(styleName:String):Boolean

スタイルでコンポーネントの親コンテナが変更されるかどうかをテストします。

これらのスタイルのいずれかを setStyle() により設定すると、コンポーネントの測定サイズを再計算するために、コンポーネントの親コンテナに対して invalidateSize() メソッドが自動的に呼び出されます。

パラメータ

styleName:String — テストするスタイルの名前です。

戻り値
Boolean — 指定のスタイルがコンポーネントの親コンテナの測定サイズに影響する可能性がある場合に true を返します。
isSizeInvalidatingStyle()メソッド 
public static function isSizeInvalidatingStyle(styleName:String):Boolean

スタイルでコンポーネントのサイズが変更されるかどうかをテストします。

これらのスタイルのいずれかを setStyle() メソッドにより設定すると、コンポーネントの測定サイズを再計算するために、コンポーネントに対して invalidateSize() メソッドが自動的に呼び出されます。

パラメータ

styleName:String — テストするスタイルの名前。

戻り値
Boolean — 指定のスタイルがコンポーネントの測定サイズに影響する可能性がある場合は、true を返します。
isValidStyleValue()メソッド 
public static function isValidStyleValue(value:*):Boolean

指定されたパラメータが有効なスタイルプロパティかどうかを判別します。 次に実際の使用例を示します。 

      trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());

一部のスタイルは、0、NaN、空のストリング（""）または null など、if (value) テストで不合格になる可能性のある値に設定されることがあるので、この機能が役立つ場合があります。

パラメータ

value:* — テストするスタイルプロパティです。

戻り値
Boolean — getStyle() メソッドの呼び出しから返された値をこのメソッドに渡すと、スタイルが設定されていれば true を返し、スタイルが設定されていなければ false を返します。
loadStyleDeclarations()メソッド 
public static function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

スタイル SWF をロードします。

パラメータ

url:String — スタイル SWF の場所です。
 
update:Boolean (default = true) — スタイルを強制的に即時更新するには、true に設定します。 アプリケーションのスタイルを強制的に即時更新しないようにするには、false に設定します。このパラメータはオプションで、デフォルトは true です。このパラメータの詳細については、setStyleDeclaration() メソッドの説明を参照してください。
 
trustContent:Boolean (default = false) — 廃止されて現在は使用されていません。 このパラメータはオプションであり、デフォルトは false です。
 
applicationDomain:ApplicationDomain (default = null) — スタイル SWF をロードする IModuleInfo の load() メソッドに渡される ApplicationDomain です。このパラメータはオプションであり、デフォルトは null です。
 
securityDomain:SecurityDomain (default = null) — スタイル SWF をロードする IModuleInfo の load() メソッドに渡される SecurityDomain です。このパラメータはオプションであり、デフォルトは null です。

戻り値
IEventDispatcher — StyleEvent.PROGRESS、StyleEvent.COMPLETE、および StyleEvent.ERROR をサポートする IEventDispatcher の実装です。

関連項目

setStyleDeclaration()
registerColorName()メソッド 
public static function registerColorName(colorName:String, colorValue:uint):void

カラーのエイリアスのリストにカラー名を追加します。

パラメータ

colorName:String — リストに追加するカラーの名前（"blue" など）です。 後からこのカラー名にアクセスする場合、この値では大文字と小文字が区別されません。
 
colorValue:uint — カラー値（例: 0x0000FF）

registerInheritingStyle()メソッド 
public static function registerInheritingStyle(styleName:String):void

親から値を継承できるスタイルのリストに追加します。

メモ：スタイル名は重複しないようにします。重複していると、既に使用されているスタイルが継承されたときに、名前が競合してパフォーマンスが低下することがあります。

パラメータ

styleName:String — 値を継承できるスタイルのリストに追加されるスタイルの名前です。

registerParentDisplayListInvalidatingStyle()メソッド 
public static function registerParentDisplayListInvalidatingStyle(styleName:String):void

コンポーネントの親コンテナの外観またはレイアウトに影響する可能性のあるスタイルのリストに追加します。 これらのスタイルのいずれかを setStyle() により設定すると、子の再描画または再レイアウトのために、コンポーネントの親コンテナに対して invalidateDisplayList() メソッドが自動的に呼び出されます。

パラメータ

styleName:String — 登録するスタイルの名前です。

registerParentSizeInvalidatingStyle()メソッド 
public static function registerParentSizeInvalidatingStyle(styleName:String):void

コンポーネントの親コンテナの測定サイズに影響する可能性のあるスタイルのリストに追加します。

これらのスタイルのいずれかを setStyle() により設定すると、コンポーネントの測定サイズを再計算するために、コンポーネントの親コンテナに対して invalidateSize() メソッドが自動的に呼び出されます。

パラメータ

styleName:String — 登録するスタイルの名前。

registerSizeInvalidatingStyle()メソッド 
public static function registerSizeInvalidatingStyle(styleName:String):void

コンポーネントの測定サイズに影響する可能性のあるスタイルのリストに追加します。 これらのスタイルのいずれかを setStyle() により設定すると、コンポーネントの測定サイズを再計算するために、コンポーネントに対して invalidateSize() メソッドが自動的に呼び出されます。

パラメータ

styleName:String — リストに追加するスタイルの名前です。

setStyleDeclaration()メソッド 
public static function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void

指定した CSS セレクタの規則を保存する CSSStyleDeclaration オブジェクトを設定します。

selector パラメータの先頭がピリオド（.）である場合は、指定されるセレクタはクラスセレクタで、styleName プロパティがそのクラスセレクタ（ピリオドを含まないもの）を指定しているインスタンスにのみ適用されます。 例えば、クラスセレクタ ".bigMargins" は、styleName が "bigMargins" であるすべての UIComponent に適用されます。

selector パラメータの先頭がピリオドではない場合は、指定されるセレクタは "タイプセレクタ" で、該当タイプのすべてのインスタンスに適用されます。 たとえば、タイプセレクタ "Button" は、Button とそのサブクラスのすべてのインスタンスに適用されます。

global セレクタはタイプセレクタに似ており、先頭にはピリオドがありません。

パラメータ

selector:String — CSS セレクタの名前です。
 
styleDeclaration:CSSStyleDeclaration — 新しいスタイル宣言です。
 
update:Boolean — スタイルを強制的に即時更新するには、true に設定します。内部的には、UIComponent の styleChanged() メソッドが呼び出されます。アプリケーションのスタイルを強制的に即時更新しないようにするには、false に設定します。

スタイルは、次回、次のいずれかのメソッドが update プロパティを true に設定して呼び出されるときに更新されます。

  • clearStyleDeclaration()
  • loadStyleDeclarations()
  • setStyleDeclaration()
  • unloadStyleDeclarations()

通常、これらのいずれかのメソッドを複数回呼び出す場合は、最後の呼び出し時にのみこのプロパティを true に設定します。こうすると、styleChanged() メソッドが複数回呼び出されることはありません。

getStyle() メソッドを呼び出したときは、styleChanged() メソッドの呼び出しによって UIComponent に最後に適用されたスタイル値が返されます。コンポーネントの外観が getStyle() メソッドによって返される値を反映していない場合があります。これが発生するのは、これらのスタイル宣言メソッドのいずれかが、update プロパティが true に設定された状態で呼び出されていないためです。

unloadStyleDeclarations()メソッド 
public static function unloadStyleDeclarations(url:String, update:Boolean = true):void

スタイル SWF をアンロードします。

パラメータ

url:String — スタイル SWF の場所です。
 
update:Boolean (default = true) — スタイルを強制的に即時更新するには、true に設定します。 アプリケーションのスタイルを強制的に即時更新しないようにするには、false に設定します。このメソッドの詳細については、setStyleDeclaration() メソッドの説明を参照してください。

関連項目

setStyleDeclaration()
定数の詳細
NOT_A_COLOR定数
public static const NOT_A_COLOR:uint = 0xFFFFFFFF

passed-in ストリングが適切なカラー名でない場合、getColorName() メソッドはこの値を返します。




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