| パッケージ | flashx.textLayout.elements |
| クラス | public class SpanElement |
| 継承 | SpanElement  FlowLeafElement FlowElement Object |
| サブクラス | SpecialCharacterElement |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
段落内のすべてのテキストが同じ属性セットを共有する場合、ParagraphElement には単一の SpanElement オブジェクトが含まれます。段落内に複数のフォーマットが存在する場合、ParagraphElement には複数の SpanElement オブジェクトが含まれます。
デフォルトの MXML プロパティmxmlChildren
さらに例を参照
関連する API エレメント
パブリックプロパティ
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| プロパティ | 定義元 | ||
|---|---|---|---|
 | alignmentBaseline : *
TextLayoutFormat：行の基準を揃えるベースラインを指定します。 | FlowElement | |
| backgroundAlpha : *
TextLayoutFormat：背景のアルファ（透明）値です（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| backgroundColor : *
TextLayoutFormat：テキストの背景色です（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| baselineShift : *
TextLayoutFormat：ベースラインを dominantBaseline 値から移動させる量です。 | FlowElement | |
| blockProgression : *
TextLayoutFormat：垂直方向または並行方向の行配置を指定します。 | FlowElement | |
| breakOpportunity : *
TextLayoutFormat：折り返しのあるテキストを複数行に分割する際の、改行可能位置を制御します。 | FlowElement | |
| cffHinting : *
TextLayoutFormat：このテキストに使用される CFF ヒンティングのタイプです。 | FlowElement | |
| clearFloats : *
TextLayoutFormat：フロートを回り込むようにテキストを配置する方法を制御します。 | FlowElement | |
| color : *
TextLayoutFormat：テキストの色です。 | FlowElement | |
| columnCount : *
TextLayoutFormat：テキスト列の数です（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| columnGap : *
TextLayoutFormat：列間のふち取り領域をピクセル単位で指定します（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| columnWidth : *
TextLayoutFormat：列幅（ピクセル単位）です（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| computedFormat : flashx.textLayout.formats:ITextLayoutFormat [オーバーライド] [読み取り専用]
このエレメントに有効な計算済みの文字フォーマット属性です。 | FlowLeafElement | |
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| coreStyles : Object [読み取り専用] この FlowElement の coreStyles を返します。 | FlowElement | |
| digitCase : *
TextLayoutFormat：このテキストに使用される数字の大文字小文字区別のタイプです。 | FlowElement | |
| digitWidth : *
TextLayoutFormat：このテキストに使用される数字の幅のタイプです。 | FlowElement | |
| direction : *
TextLayoutFormat：テキストブロック内のテキストのデフォルトの双方向埋め込みレベルを指定します。 | FlowElement | |
| dominantBaseline : *
TextLayoutFormat：行のエレメントの垂直座標を決定するために alignmentBaseline に吸着させるエレメントのベースラインを指定します。 | FlowElement | |
| firstBaselineOffset : *
TextLayoutFormat：コンテナ内の最初の行のベースライン位置を指定します。 | FlowElement | |
| fontFamily : *
TextLayoutFormat：使用するフォント名またはフォント名のカンマ区切りリストです。 | FlowElement | |
| fontLookup : *
TextLayoutFormat：使用するフォント参照です。 | FlowElement | |
| fontSize : *
TextLayoutFormat：テキストのサイズ（ピクセル単位）です。 | FlowElement | |
| fontStyle : *
TextLayoutFormat：テキストのスタイルです。 | FlowElement | |
| fontWeight : *
TextLayoutFormat：テキストの太さです。 | FlowElement | |
| format : flashx.textLayout.formats:ITextLayoutFormat このエレメントに直接適用される TextLayoutFormat プロパティです。 | FlowElement | |
| id : String
エレメントに識別名を割り当て、id の参照により、エレメントへのスタイルの設定を可能にします。 | FlowElement | |
| justificationRule : *
TextLayoutFormat：段落のテキストの均等配置に使用するルールです。 | FlowElement | |
| justificationStyle : *
TextLayoutFormat：段落の均等配置に使用するスタイルです。 | FlowElement | |
| kerning : *
TextLayoutFormat：カーニングでは、読みやすくするために、特定の文字ペア間でピクセルを調整します。 | FlowElement | |
| leadingModel : *
TextLayoutFormat：行送りの基準と行送り方向の組み合わせである、行送りモデルを指定します。 | FlowElement | |
| ligatureLevel : *
TextLayoutFormat：フォントで定義された合字のうち、どの合字がテキストで使用されるかを制御します。 | FlowElement | |
| lineBreak : *
TextLayoutFormat：コンテナ内のテキスト折り返しを制御します（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| lineHeight : *
TextLayoutFormat：テキストの行送りを制御します。 | FlowElement | |
| lineThrough : *
TextLayoutFormat：true の場合、打ち消し線が適用されます。打ち消し線はテキストの中央に描画される線です。 | FlowElement | |
| linkActiveFormat : *
TextLayoutFormat：通常の状態のリンクに使用されるフォーマット属性を定義します。 | FlowElement | |
| linkHoverFormat : *
TextLayoutFormat：マウスがリンクの境界内に移動されたときにホバー状態のリンクに対して使用されるフォーマット属性を定義します。 | FlowElement | |
| linkNormalFormat : *
TextLayoutFormat：通常の状態のリンクに使用されるフォーマット属性を定義します。 | FlowElement | |
| listAutoPadding : *
TextLayoutFormat：リストの始端におけるパディング値が auto である場合に、始端に対して自動インデントを指定します。 | FlowElement | |
| listMarkerFormat : *
TextLayoutFormat：フォーマット属性のリストマーカーを定義します。 | FlowElement | |
| listStylePosition : *
TextLayoutFormat：有効な値は、ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT です。 デフォルト値は定義されていません。つまり、未設定です。カスケード時に定義されていない場合、このプロパティは祖先から値を継承します。 | FlowElement | |
| listStyleType : *
TextLayoutFormat：有効な値は、ListStyleType.UPPER_ALPHA、ListStyleType.LOWER_ALPHA、ListStyleType.UPPER_ROMAN、ListStyleType.LOWER_ROMAN、ListStyleType.NONE、ListStyleType.DISC、ListStyleType.CIRCLE、ListStyleType.SQUARE、ListStyleType.BOX、ListStyleType.CHECK、ListStyleType.DIAMOND、ListStyleType.HYPHEN、ListStyleType.ARABIC_INDIC、ListStyleType.BENGALI、ListStyleType.DECIMAL、ListStyleType.DECIMAL_LEADING_ZERO、ListStyleType.DEVANAGARI、ListStyleType.GUJARATI、ListStyleType.GURMUKHI、ListStyleType.KANNADA、ListStyleType.PERSIAN、ListStyleType.THAI、ListStyleType.URDU、ListStyleType.CJK_EARTHLY_BRANCH、ListStyleType.CJK_HEAVENLY_STEM、ListStyleType.HANGUL、ListStyleType.HANGUL_CONSTANT、ListStyleType.HIRAGANA、ListStyleType.HIRAGANA_IROHA、ListStyleType.KATAKANA、ListStyleType.KATAKANA_IROHA、ListStyleType.LOWER_ALPHA、ListStyleType.LOWER_GREEK、ListStyleType.LOWER_LATIN、ListStyleType.UPPER_ALPHA、ListStyleType.UPPER_GREEK、ListStyleType.UPPER_LATIN、FormatValue.INHERIT です。 デフォルト値は定義されていません。つまり、未設定です。カスケード時に定義されていない場合、このプロパティは祖先から値を継承します。 | FlowElement | |
| locale : *
TextLayoutFormat：テキストのロケールです。 | FlowElement | |
| mxmlChildren : Array
範囲タグ内のコンテンツに基づいてテキストを設定します。既存の子は常に削除します。 | SpanElement | ||
| paddingBottom : *
TextLayoutFormat：下部のインセット（ピクセル単位）です。 | FlowElement | |
| paddingLeft : *
TextLayoutFormat：左側のインセット（ピクセル単位）です。 | FlowElement | |
| paddingRight : *
TextLayoutFormat：右側のインセット（ピクセル単位）です。 | FlowElement | |
| paddingTop : *
TextLayoutFormat：上部のインセット（ピクセル単位）です。 | FlowElement | |
| paragraphEndIndent : *
TextLayoutFormat：段落の終端をどれだけインデントするかを指定する数値（ピクセル単位）です。 | FlowElement | |
| paragraphSpaceAfter : *
TextLayoutFormat：段落の後に空けるスペースを指定する数値（ピクセル単位）です。 | FlowElement | |
| paragraphSpaceBefore : *
TextLayoutFormat：段落の前に空けるスペースを指定する数値（ピクセル単位）です。 | FlowElement | |
| paragraphStartIndent : *
TextLayoutFormat：段落の始端をどれだけインデントするかを指定する数値（ピクセル単位）です。 | FlowElement | |
| parent : FlowGroupElement [読み取り専用] この FlowElement オブジェクトの親を返します。 | FlowElement | |
| parentRelativeEnd : int [読み取り専用] 親に含まれるこの FlowElement オブジェクトの相対的な末尾を返します。 | FlowElement | |
| parentRelativeStart : int [読み取り専用] 親に含まれるこの FlowElement オブジェクトの相対的な先頭を返します。 | FlowElement | |
| renderingMode : *
TextLayoutFormat：このテキストに使用されるレンダリングモードです。 | FlowElement | |
| styleName : *
TextLayoutFormat：エレメントに識別クラスを割り当て、styleName を参照することで、エレメントへのスタイルの設定を可能にします。 | FlowElement | |
| styles : Object [読み取り専用] この FlowElement のスタイルを返します。 | FlowElement | |
| tabStops : *
TextLayoutFormat：段落に関連付けるタブストップを指定します。 | FlowElement | |
| text : String
この SpanElement オブジェクトが保持するテキストの String を受け入れます。 | SpanElement | ||
| textAlign : *
TextLayoutFormat：コンテナを基準とした段落内の行揃えです。 | FlowElement | |
| textAlignLast : *
TextLayoutFormat：均等配置テキストの、コンテナを基準とした段落内の最後（単一）の行の行揃えです。 | FlowElement | |
| textAlpha : *
TextLayoutFormat：テキストのアルファ（透明）値です。 | FlowElement | |
| textDecoration : *
TextLayoutFormat：テキストの装飾です。 | FlowElement | |
| textIndent : *
TextLayoutFormat：段落の一行目をどれだけインデントするかを指定する数値（ピクセル単位）です。 | FlowElement | |
| textJustify : *
TextLayoutFormat：テキストの均等配置オプションを指定します。 | FlowElement | |
| textLength : int [読み取り専用]
この FlowElement オブジェクトとその子が所有するテキストの長さの合計を返します。 | FlowElement | |
| textRotation : *
TextLayoutFormat：テキストの回転角度を決定します。 | FlowElement | |
| tracking : Object [書き込み専用]
追跡を設定します。trackingRight プロパティと同義です。 | FlowElement | |
| trackingLeft : *
TextLayoutFormat：各文字の左側にトラッキング（または手動カーニング）をどれだけ適用するかの数値（ピクセル単位または fontSize のパーセント（120％など））です。 | FlowElement | |
| trackingRight : *
TextLayoutFormat：各文字の右側にトラッキング（または手動カーニング）をどれだけ適用するかの数値（ピクセル単位または fontSize のパーセント（120％など））です。 | FlowElement | |
| typeName : String
各 FlowElement には typeName が含まれます。 | FlowElement | |
| typographicCase : *
TextLayoutFormat：このテキストに使用される文字の大文字小文字区別のタイプです。 | FlowElement | |
| userStyles : Object FlowElement オブジェクトでのユーザースタイルの読み取りおよび書き込みを可能にします。 | FlowElement | |
| verticalAlign : *
TextLayoutFormat：垂直方向の行揃えまたは均等配置です（カスケード時に定義されていない場合、デフォルトの値が採用されます）。 | FlowElement | |
| whiteSpaceCollapse : *
TextLayoutFormat：テキストを TextFlow にインポートする際、空白を圧縮または保持します。 | FlowElement | |
| wordSpacing : *
TextLayoutFormat：均等配置に使用する単語間の最適間隔、最小間隔、および最大間隔（通常の間隔幅の倍数）を指定します。 | FlowElement | |
パブリックメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクター - SpanElement オブジェクトを作成して段落内のテキストの実行を保持します。 | SpanElement | ||
| styleProp パラメーターにより指定されたスタイルを、この FlowElement オブジェクトからクリアします。 | FlowElement | |
|
この FlowElement オブジェクトのディープコピー（すべての子を含む）を作成し、指定された 2 つの文字位置間のコンテンツをコピーし、そのコピーを FlowElement オブジェクトとして返します。 | FlowElement | |
| userStyles を他の otherElement の userStyles と比較します。 | FlowElement | |
|
テキストフロー内のエレメントの開始位置を絶対インデックスとして返します。 | FlowElement | |
|
この FlowElement オブジェクトに対して相対的な、指定された位置の文字を返します。 | FlowElement | |
| この FlowElement に対して相対的な、指定された位置の文字コードを返します。 | FlowElement | |
| この範囲の FontMetrics オブジェクトを返します。 | FlowLeafElement | |
|
上位エレメントに対して相対的な、このエレメントの先頭を返します。 | FlowElement | |
|
次の FlowLeafElement オブジェクトを返します。 | FlowLeafElement | |
| テキストフロー階層内の次の FlowElement 兄弟を返します。 | FlowElement | |
|
このエレメントに関連付けられている ParagraphElement オブジェクトを返します。 | FlowElement | |
|
前の FlowLeafElement オブジェクトを返します。 | FlowLeafElement | |
| テキストフロー階層内の前の FlowElement 兄弟を返します。 | FlowElement | |
| styleProp パラメーターによって指定されたスタイルの値を返します。これは、スタイル名を指定するもので、任意のユーザースタイル名を含むことができます。 | FlowElement | |
|
フローエレメント内の指定されたテキスト範囲を取得します。 | FlowElement | |
|
テキストフロー階層を遡って、エレメントのルート TextFlow オブジェクトを返します。 | FlowElement | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
| 実装オブジェクトが作成され、MXML タグに指定されたすべてのコンポーネントプロパティが初期化された後に、MXML オブジェクトに対して呼び出されます。 | FlowElement | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
指定された開始位置と終了位置に基づくテキスト範囲内のテキストを更新します。 | SpanElement | ||
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
| styleProp パラメーターにより指定されたスタイルの値を、newValue パラメーターで指定する値に設定します。 | FlowElement | |
|
この FlowElement オブジェクトのコピーを作成し、指定された 2 つの文字位置間のコンテンツをコピーします。 | FlowElement | |
|
relativePosition パラメーターで指定された位置（このエレメントのテキストの相対位置）で、この FlowElement オブジェクトを分割します。 | FlowElement | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
プロパティの詳細
mxmlChildren | プロパティ |
mxmlChildren:Array| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
範囲タグ内のコンテンツに基づいてテキストを設定します。既存の子は常に削除します。このプロパティは、Flex での MXML コンパイル済みの読み込み時に使用されます。 Flash Professional では、このプロパティは無視されます。 TLF マークアップエレメントが他の TLF マークアップエレメントを子として持つ場合、子にはこのプロパティが割り当てられます。
実装
public function get mxmlChildren():Array public function set mxmlChildren(value:Array):void例外
TypeError — 配列エレメントが SpecialCharacterElement または String でない場合に発生します。
|
text | プロパティ |
コンストラクターの詳細
SpanElement | () | コンストラクター |
public function SpanElement()| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクター - SpanElement オブジェクトを作成して段落内のテキストの実行を保持します。
メソッドの詳細
replaceText | () | メソッド |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
指定された開始位置と終了位置に基づくテキスト範囲内のテキストを更新します。挿入の場合は、終了位置を開始位置と同じ値に設定します。範囲内の既存のテキストにテキストを追加する場合、開始位置と終了位置は、既存のテキストの長さに等しくします。
置き換えられるテキストには、最初の文字から最後の文字まで（ただし、最後の文字は含まない）が含まれます。
パラメーター
relativeStartPosition:int — 範囲の先頭に対して相対的な、置き換えられるテキストの先頭のインデックス位置です。範囲内の最初の文字は、位置 0 となります。
| |
relativeEndPosition:int — 範囲の先頭に対して相対的な、置き換えられるテキストの最後の文字より 1 つ後の位置のインデックスです。挿入の場合は、この値を relativeStartPos と同じ値に設定します。
| |
textValue:String — 場合に応じて、置換テキストまたは追加するテキストです。
|
例外
RangeError — 指定されたrelativeStartPosition または relativeEndPosition は範囲外であるか、またはサロゲートペアは置き換えの結果として分割されています。
|
例 ( この例の使用方法 )
この例では、replaceText() を何回か呼び出して、次のことを行います。（1）テキストの先頭にストリングを挿入する。（2）テキストの最後にストリングを追加する。（3）テキストの中央にストリングを挿入する。（4）新しいストリングでテキストを完全に置き換える。
この例では、2 番目の範囲（span2）を使用して結果を表示します。
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class SpanElement_replaceTextExample extends Sprite
{
public function SpanElement_replaceTextExample()
{
// create container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var paragraph:ParagraphElement = new ParagraphElement();
var span:SpanElement = new SpanElement;
var span2:SpanElement = new SpanElement;
// add composer and container controller
var controller:ContainerController = new ContainerController(container, 200, 700 );
textFlow.flowComposer.addController(controller);
textFlow.fontSize = 24; // set font size
// create text string and add it to the span
var str:String = "0123456";
span.text = str;
// insert at the beginning
span.replaceText(0, 0, "abc");
span2.text = span.text + '\n';
// append to the end of the text
span.replaceText(10, 10, "abc");
span2.text += span.text + '\n';
// insert string in the middle of the text
span.replaceText(5, 8, "abc");
span2.text += span.text + '\n';
// replace text with string
span.replaceText(0, 13, "abc");
span2.text += span.text + '\n';
// replace text with string
span.replaceText(0, 3, "That's all she wrote!\n");
span2.text += span.text + '\n';
// display the results
paragraph.addChild(span2);
textFlow.addChild(paragraph);
textFlow.flowComposer.updateAllControllers();
}
}
}
例 この例の使用方法
SpanElementExample.as
この例では、スタイルが異なる 2 つの SpanElement オブジェクトを使用して「Hello World」を表示します。
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flash.text.engine.FontPosture;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class SpanElementExample extends Sprite
{
public function SpanElementExample()
{
// create a container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var spanHello:SpanElement = new SpanElement();
var spanWorld:SpanElement = new SpanElement();
// add text and styles to the spans
spanHello.text = "Hello, ";
spanHello.fontSize = 48;
spanWorld.text = "World!";
spanWorld.fontSize = 56;
spanWorld.fontStyle = FontPosture.ITALIC;
spanWorld.color = 0xFFCC00;
// add spans to paragraph, paragraph to text flow
p.addChild(spanHello);
p.addChild(spanWorld);
textFlow.addChild(p);
// update controller to display text
var controller:ContainerController = new ContainerController(container, 400, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers();
}
}
}
Tue Jun 12 2018, 10:34 AM Z