flash.text.StyleSheet (Flex™ 2 リファレンスガイド)

パッケージ	flash.text
	public dynamic class StyleSheet
継承	StyleSheet EventDispatcher Object

StyleSheet クラスを使用すると、フォントのサイズや色、その他のスタイルなどのテキストフォーマット規則を含む StyleSheet オブジェクトを作成することができます。スタイルシートによって定義したスタイルは、HTML 形式または XML 形式のテキストを含む TextField オブジェクトに適用することができます。TextField オブジェクトに含まれるテキストは、StyleSheet オブジェクトによって定義されるタグスタイルに従って、自動的にフォーマットされます。テキストスタイルを使用して、新しいフォーマットタグの定義、ビルトイン HTML タグの再定義、特定の HTML タグに適用できるスタイルクラスの作成を行うことができます。

スタイルを TextField オブジェクトに適用するには、StyleSheet オブジェクトを TextField オブジェクトの styleSheet プロパティに適用します。

Flash Player は、オリジナルの CSS1 仕様 (www.w3.org/TR/REC-CSS1) にあるプロパティのサブセットをサポートしています。次の表に、サポートされている CSS (カスケーディングスタイルシート) プロパティとその値、および対応する ActionScript プロパティの名前を示します。ActionScript プロパティ名は、どれも対応する CSS プロパティ名から派生しており、名前にハイフンが含まれる場合はハイフンを省略し、後ろの文字を大文字にしています。

CSS プロパティ	ActionScript プロパティ	用途とサポートされる値
`color`	`color`	16 進数のカラー値のみがサポートされます。`blue` などの名前付きカラーはサポートされません。カラーは、次のようなフォーマットで記述されます。 `#FF0000`.
`display`	`display`	サポートされる値は `inline`、`block`、および `none` です。
`font-family`	`fontFamily`	使用するフォントをカンマ区切りリストで指定します。優先度の高い順に並べます。任意のフォントファミリ名を使用できます。汎用フォント名を指定した場合、適切なデバイスフォントに置換されます。次のようなフォント変換が行われます。`mono` は `_typewriter` に、`sans-serif` は `_sans` に、`serif` は `_serif` にそれぞれ変換されます。
`font-size`	`fontSize`	値の数字の部分だけを使用します。単位 (px、pt) は解析されません。ピクセルとポイントは同じ意味になります。
`font-style`	`fontStyle`	有効な値は `normal` と `italic` です。
`font-weight`	`fontWeight`	有効な値は `normal` と `bold` です。
`kerning`	`kerning`	有効な値は `true` と `false` です。カーニングは、埋め込みフォントに対してのみサポートされています。Courier New など特定のフォントでは、カーニングがサポートされていません。kerning プロパティは、Macintosh で作成された SWF ファイルではなく、Windows で作成された SWF ファイルでのみサポートされます。ただし、これらの SWF ファイルは Windows 以外のバージョンの Flash Player で表示することが可能であり、カーニングも適用されます。
`letter-spacing`	`letterSpacing`	文字間に均等に配分されるスペースの量です。この値は、各文字の後の送りに追加されるピクセル数を示します。負の値を指定すると、文字の間隔が狭くなります。値の数字の部分だけを使用します。単位 (px、pt) は解析されません。ピクセルとポイントは同じ意味になります。
`margin-left`	`marginLeft`	値の数字の部分だけを使用します。単位 (px、pt) は解析されません。ピクセルとポイントは同じ意味になります。
`margin-right`	`marginRight`	値の数字の部分だけを使用します。単位 (px、pt) は解析されません。ピクセルとポイントは同じ意味になります。
`text-align`	`textAlign`	有効な値は `left`、`center`、`right`、および `justify` です。
`text-decoration`	`textDecoration`	有効な値は `none` と `underline` です。
`text-indent`	`textIndent`	値の数字の部分だけを使用します。単位 (px、pt) は解析されません。ピクセルとポイントは同じ意味になります。

StyleSheet クラスを使用すると、低レベルでのテキストレンダリングが可能になります。ただし、Flex では一般的に Label、Text、TextArea、TextInput コントロールを使用して、テキスト処理を行います。

詳細については、『ActionScript ユーザーガイド』の「CSS スタイルによるテキストのフォーマット」を参照してください。

例の表示

関連項目

flash.net.URLLoader

	プロパティ	定義
		constructor : Object 特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		styleNames : Array [read-only] このスタイルシートに登録されているすべてのスタイルの名前 (ストリング) を含む配列です。	StyleSheet

パブリックメソッド

継承されるパブリックメソッドの非表示

継承されるパブリックメソッドの表示

	メソッド		定義
		StyleSheet() 新しい StyleSheet オブジェクトを作成します。	StyleSheet
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		clear():void スタイルシートオブジェクトのスタイルをすべて削除します。	StyleSheet
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		getStyle(styleName:String):Object `styleName` という名前のスタイルに関連付けられているスタイルオブジェクトのコピーを返します。	StyleSheet
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		parseCSS(CSSText:String):void `CSSText` の CSS を解析し、その内容を含むスタイルシートをロードします。	StyleSheet
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙可能かどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		setStyle(styleName:String, styleObject:Object):void 指定された名前を使用して、新しいスタイルをスタイルシートオブジェクトに追加します。	StyleSheet
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		transform(formatObject:Object):TextFormat CSS 解析機能を拡張します。	StyleSheet
		valueOf():Object 指定されたオブジェクトのプリミティブ値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

プロパティの詳細

styleNames

プロパティ

styleNames:Array [read-only]

このスタイルシートに登録されているすべてのスタイルの名前 (ストリング) を含む配列です。

実装
public function get styleNames():Array

コンストラクタの詳細

StyleSheet

()

コンストラクタ

public 関数 StyleSheet()

新しい StyleSheet オブジェクトを作成します。

関連項目

flash.text.StyleSheet.getStyle()

メソッドの詳細

clear

()

メソッド

public function clear():void

スタイルシートオブジェクトのスタイルをすべて削除します。

getStyle

()

メソッド

public function getStyle(styleName:String):Object

styleName という名前のスタイルに関連付けられているスタイルオブジェクトのコピーを返します。styleName に関連付けられているスタイルオブジェクトがない場合は、null が返されます。

パラメータ

styleName:String — 取得するスタイルの名前を示すストリングです。

戻り値

Object — オブジェクトです。

関連項目

flash.text.StyleSheet.setStyle()

parseCSS

()

メソッド

public function parseCSS(CSSText:String):void

CSSText の CSS を解析し、その内容を含むスタイルシートをロードします。CSSText 内のスタイルが styleSheet に既に含まれている場合は、styleSheet のプロパティは維持され、CSSText だけに含まれるスタイルが styleSheet に追加または変更されます。

ネイティブ CSS 解析機能を拡張するには、StyleSheet クラスのサブクラスを作成して、このメソッドをオーバーライドします。

パラメータ

CSSText:String — 解析する CSS テキストです (ストリング)。

setStyle

()

メソッド

public function setStyle(styleName:String, styleObject:Object):void

指定された名前を使用して、新しいスタイルをスタイルシートオブジェクトに追加します。指定したスタイルがスタイルシートに存在しない場合は、追加されます。指定したスタイルがスタイルシートに既に存在する場合は、置き換えられます。styleObject パラメータに null を指定した場合は、指定したスタイルが削除されます。

このメソッドに渡したスタイルオブジェクトのコピーが作成されます。

サポートされるスタイルの一覧については、StyleSheet クラスの説明に記載されている表を参照してください。

パラメータ

	`styleName:String` — スタイルシートに追加するスタイルの名前を示すストリングです。

	`styleObject:Object` — スタイルを記述するオブジェクト、または `null` です。

transform

()

メソッド

public function transform(formatObject:Object):TextFormat

CSS 解析機能を拡張します。上級開発者であれば、StyleSheet クラスを拡張して、このメソッドをオーバーライドできます。

パラメータ

formatObject:Object — スタイルを記述するオブジェクト、または null です。このスタイルには、オブジェクトのプロパティとしてスタイル規則が含まれます。

戻り値

TextFormat — CSS 規則をテキストフォーマットプロパティにマッピングした結果を含む TextFormat オブジェクトです。

関連項目

flash.text.TextFormat

例

次の例では、新しいスタイルシートを作成して、見出しのスタイルにフォントの取り扱い方法としてボールドと赤色を割り当てます。

 
package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class StyleSheetExample extends Sprite {

        public function StyleSheetExample() {
            var style:StyleSheet = new StyleSheet();

            var heading:Object = new Object();
            heading.fontWeight = "bold";
            heading.color = "#FF0000";

            var body:Object = new Object();
            body.fontStyle = "italic";

            style.setStyle(".heading", heading);
            style.setStyle("body", body);

            var label:TextField = new TextField();
            label.styleSheet = style;
            label.htmlText = "<body><span class='heading'>Hello </span>World...</body>";
            addChild(label);
        }
    }
}

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/flash/text/StyleSheet.html

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class StyleSheet	プロパティ \| メソッド \| 例