TextInput コンポーネントでのスタイルの使用

TextInput コンポーネントは、クラススタイル宣言で定義された独自の backgroundColor および borderStyle スタイルプロパティを持ちます。クラススタイルはグローバルスタイルより優先されます。したがって、backgroundColor および borderStyle スタイルプロパティを設定する場合は、インスタンス上で別のカスタムスタイル宣言を作成または定義する必要があります。

TextInput コンポーネントは、次のスタイルをサポートしています。

スタイル	テーマ	説明
`backgroundColor`	Halo と Sample	背景色です。デフォルトカラーは白色です。
`borderStyle`	Halo と Sample	TextInput コンポーネントは、境界線として RectBorder インスタンスを使用し、そのクラスで定義されたスタイルに対応します。詳細については、RectBorder クラスを参照してください。デフォルトの境界線スタイルは `"inset"` です。
`marginLeft`	Halo と Sample	テキストの左余白を示す数値です。デフォルト値は 0 です。
`marginRight`	Halo と Sample	テキストの右余白を示す数値です。デフォルト値は 0 です。
`color`	Halo と Sample	テキストの色です。デフォルト値は、Halo テーマでは 0x0B333C、Sample テーマでは空白です。
`disabledColor`	Halo と Sample	コンポーネントが無効な場合のテキストカラーです。デフォルトのカラーは 0x848384 (濃い灰色) です。
`embedFonts`	Halo と Sample	`fontFamily` で指定されたフォントが埋め込みフォントかどうかを示すブール値です。`fontFamily` が埋め込みフォントを参照する場合、このスタイルは `true` に設定する必要があります。この設定を行わないと、埋め込みフォントは使用されません。このスタイルが `true` に設定され、`fontFamily` が埋め込みフォントを参照していない場合、テキストは表示されません。デフォルト値は `false` です。
`fontFamily`	Halo と Sample	テキストのフォント名です。デフォルト値は `"_sans"` です。
`fontSize`	Halo と Sample	フォントのポイントサイズです。デフォルト値は `10` です。
`fontStyle`	Halo と Sample	フォントスタイルです。`"normal"` または `"italic"` を指定します。デフォルト値は `"normal"` です。
`fontWeight`	Halo と Sample	フォントの太さです。`"none"` または `"bold"` を指定します。デフォルト値は `"none"` です。`setStyle()` 呼び出しでは、すべてのコンポーネントに値 `"none"` の代わりに値 `"normal"` を指定できます。ただし、その後で `getStyle()` を呼び出すと、`"none"` が返されます。
`textAlign`	Halo と Sample	テキストの行揃えです。`"left"`、`"right"`、`"center"` のいずれかを指定します。デフォルト値は `"left"` です。
`textIndent`	Halo と Sample	テキストのインデントを示す数値です。デフォルト値は 0 です。
`textDecoration`	Halo と Sample	テキストの装飾です。`"none"` または `"underline"` を指定します。デフォルト値は `"none"` です。

スタイル

テーマ

説明

backgroundColor

Halo と Sample

背景色です。デフォルトカラーは白色です。

borderStyle

Halo と Sample

TextInput コンポーネントは、境界線として RectBorder インスタンスを使用し、そのクラスで定義されたスタイルに対応します。詳細については、RectBorder クラスを参照してください。

デフォルトの境界線スタイルは "inset" です。

marginLeft

Halo と Sample

テキストの左余白を示す数値です。デフォルト値は 0 です。

marginRight

Halo と Sample

テキストの右余白を示す数値です。デフォルト値は 0 です。

color

Halo と Sample

テキストの色です。デフォルト値は、Halo テーマでは 0x0B333C、Sample テーマでは空白です。

disabledColor

Halo と Sample

コンポーネントが無効な場合のテキストカラーです。デフォルトのカラーは 0x848384 (濃い灰色) です。

embedFonts

Halo と Sample

fontFamily で指定されたフォントが埋め込みフォントかどうかを示すブール値です。fontFamily が埋め込みフォントを参照する場合、このスタイルは true に設定する必要があります。この設定を行わないと、埋め込みフォントは使用されません。このスタイルが true に設定され、fontFamily が埋め込みフォントを参照していない場合、テキストは表示されません。デフォルト値は false です。

fontFamily

Halo と Sample

テキストのフォント名です。デフォルト値は "_sans" です。

fontSize

Halo と Sample

フォントのポイントサイズです。デフォルト値は 10 です。

fontStyle

Halo と Sample

フォントスタイルです。"normal" または "italic" を指定します。デフォルト値は "normal" です。

fontWeight

Halo と Sample

フォントの太さです。"none" または "bold" を指定します。デフォルト値は "none" です。setStyle() 呼び出しでは、すべてのコンポーネントに値 "none" の代わりに値 "normal" を指定できます。ただし、その後で getStyle() を呼び出すと、"none" が返されます。

textAlign

Halo と Sample

テキストの行揃えです。"left"、"right"、"center" のいずれかを指定します。デフォルト値は "left" です。

textIndent

Halo と Sample

テキストのインデントを示す数値です。デフォルト値は 0 です。

textDecoration

Halo と Sample

テキストの装飾です。"none" または "underline" を指定します。デフォルト値は "none" です。

TextArea コンポーネントと TextInput コンポーネントは、同じスタイルを使用し、同じ方法で使用されることがよくあります。したがって、デフォルトでは、同じクラスレベルのスタイル宣言を共有します。たとえば、次のコードセットは TextArea 宣言でスタイルを設定しますが、TextArea コンポーネントと TextInput コンポーネントの両方に影響します。

_global.styles.TextArea.setStyle("disabledColor", 0xBBBBFF);

コンポーネントを切り離して、一方にクラスレベルのスタイルを指定し、もう一方には指定しない場合は、新しいスタイル宣言を作成します。

import mx.styles.CSSStyleDeclaration;
_global.styles.TextInput = new CSSStyleDeclaration();
_global.styles.TextInput.setStyle("disabledColor", 0xFFBBBB);

この例では、_global.styles.TextInput を上書きする前に存在しているかどうかはチェックしません。存在が認識されており、上書きすることを前提としています。

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/main/00003529.html