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 プロパティに適用します。

メモ : スタイルシートを使用するテキストフィールドは編集できません。つまり、type プロパティが TextFieldType.INPUT に設定されているテキストフィールドでは、そのテキストフィールドのデフォルトテキストに StyleSheet が適用されますが、ユーザーはその内容を編集できなくなります。入力テキストフィールドには TextFormat クラスを使ってスタイルを割り当てることもできます。

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 で表示することが可能であり、カーニングも適用されます。
`leading`	`leading`	行間に均等に配分されるスペースの量です。各行の下に追加されるピクセル数を表す値です。負の値を指定すると、行の間隔が狭くなります。値の数字の部分だけを使用します。単位 (px、pt) は解析されません。ピクセルとポイントは同じ意味になります。
`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 コントロールを使用して、テキスト処理を行います。

関連項目

flash.text.TextField

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

パブリック Methods

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

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

	メソッド		定義
		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

	イベント	一覧	定義
		activate	Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
		deactivate	Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	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

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