Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
mx.styles 

IStyleManager  - AS3 Flex

パッケージmx.styles
インターフェイスpublic interface IStyleManager

言語バージョン: ActionScript 3.0
製品バージョン: Flex 2.0.1
ランタイムバージョン: Flash Player 9, AIR 1.1

IStyleManager クラスでは次の事項が管理されます。
  • クラスがどの CSS スタイルプロパティを継承するか
  • どのスタイルプロパティがカラーであり、特殊な処理を必要とするか
  • カラー値のエイリアスであるストリングのリスト
このインターフェイスは、Flex 2.0.1 で使用されていました。Flex 3 では、代わりに IStyleManager2 が使用されています。

関連する API エレメント



パブリックメソッド
 メソッド定義元
  
指定した CSS セレクターの規則を保存する CSSStyleDeclaration オブジェクトをクリアします。
IStyleManager
  
指定されたカラーストリングに対応する RGB カラー数値を返します。
IStyleManager
  
カラー配列の各エレメントを、カラー名から RGB カラー数値に変換します。
IStyleManager
  
指定した CSS セレクターの規則を保存する CSSStyleDeclaration オブジェクトを取得します。
IStyleManager
  
指定されたストリングがカラー値のエイリアスかどうかをテストします。
IStyleManager
  
スタイルが継承されるかどうかをテストします。
IStyleManager
  
TextFormat スタイルが継承されるかどうかをテストします。
IStyleManager
  
このスタイルがコンポーネントの親コンテナに反映され、このスタイルが変更されたときに親コンテナが必ず再描画されるようになるかどうかをテストします。
IStyleManager
  
スタイルでコンポーネントの親コンテナが変更されるかどうかをテストします。
IStyleManager
  
スタイルでコンポーネントのサイズが変更されるかどうかをテストします。
IStyleManager
  
指定されたパラメーターが有効なスタイルプロパティかどうかを判別します。
IStyleManager
  
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
スタイル SWF をロードします。
IStyleManager
  
registerColorName(colorName:String, colorValue:uint):void
カラーのエイリアスのリストにカラー名を追加します。
IStyleManager
  
親から値を継承できるスタイルのリストに追加します。
IStyleManager
  
コンポーネントの親コンテナの外観またはレイアウトに影響する可能性のあるスタイルのリストに追加します。
IStyleManager
  
コンポーネントの親コンテナの測定サイズに影響する可能性のあるスタイルのリストに追加します。
IStyleManager
  
コンポーネントの測定サイズに影響する可能性のあるスタイルのリストに追加します。
IStyleManager
  
setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
指定した CSS セレクターの規則を保存する CSSStyleDeclaration オブジェクトを設定します。
IStyleManager
  
スタイル SWF をアンロードします。
IStyleManager
メソッドの詳細

clearStyleDeclaration

()メソッド
public function clearStyleDeclaration(selector:String, update:Boolean):void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

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

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

パラメーター

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

関連する API エレメント

getColorName

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

指定されたカラーストリングに対応する 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 function getColorNames(colors:Array):void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

getStyleDeclaration

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

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

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

パラメーター

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

戻り値
CSSStyleDeclaration — 名前が selector プロパティと一致するスタイル宣言です。

isColorName

()メソッド 
public function isColorName(colorName:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

戻り値
Booleantrue が返されるのは、colorName がカラーのエイリアスの場合です。

isInheritingStyle

()メソッド 
public function isInheritingStyle(styleName:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

戻り値
Boolean — 指定のスタイルが継承スタイルである場合、true を返します。

isInheritingTextFormatStyle

()メソッド 
public function isInheritingTextFormatStyle(styleName:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

戻り値
Boolean — 指定の TextFormat スタイルが継承スタイルである場合、true を返します。

isParentDisplayListInvalidatingStyle

()メソッド 
public function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

パラメーター

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

戻り値
Boolean — 指定のスタイルがコンポーネントの親コンテナの外観またはレイアウトに影響する可能性がある場合に true を返します。

isParentSizeInvalidatingStyle

()メソッド 
public function isParentSizeInvalidatingStyle(styleName:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

パラメーター

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

戻り値
Boolean — 指定のスタイルがコンポーネントの親コンテナの測定サイズに影響する可能性がある場合に true を返します。

isSizeInvalidatingStyle

()メソッド 
public function isSizeInvalidatingStyle(styleName:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

パラメーター

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

戻り値
Boolean — 指定のスタイルがコンポーネントの測定サイズに影響する可能性がある場合は、true を返します。

isValidStyleValue

()メソッド 
public function isValidStyleValue(value:*):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

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

パラメーター

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

戻り値
BooleangetStyle() メソッドの呼び出しから返された値をこのメソッドに渡すと、スタイルが設定されていれば true、スタイルが設定されていなければ false を返します。

loadStyleDeclarations

()メソッド 
public function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

言語バージョン: ActionScript 3.0
製品バージョン: Flex 4
ランタイムバージョン: Flash Player 9, AIR 1.1

スタイル 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 の実装です。

関連する API エレメント

registerColorName

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

registerInheritingStyle

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

パラメーター

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

registerParentDisplayListInvalidatingStyle

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

registerParentSizeInvalidatingStyle

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

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

パラメーター

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

registerSizeInvalidatingStyle

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

setStyleDeclaration

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

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

指定した 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 function unloadStyleDeclarations(url:String, update:Boolean = true):void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

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

パラメーター

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

関連する API エレメント





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。