public static setSelection(beginIndex:Number, endIndex:Number) : Void

現在フォーカスのあるテキストフィールドの選択範囲を設定します。新しい選択範囲は、beginIndex パラメータで指定されたインデックスから始まり、endIndex パラメータで指定されたインデックスで終わります。選択範囲のインデックスはゼロから始まります。つまり、第 1 の位置は 0、第 2 の位置は 1、以下同様です。現在フォーカスされているテキストフィールドがない場合は、このメソッドは何も実行しません。setSelection() メソッドを呼び出し、テキストコントロールをフォーカスしたとき、選択状態のハイライトは、テキストフィールドがアクティブな状態で編集されている場合にのみ表示されます。setSelection() メソッドは、Selection.setFocus() の後、または onSetFocus() イベントハンドラ内から呼び出すことができます。ただし、選択内容は、fscommand activateTextField コマンドを呼び出した後にのみ表示されます。

パラメータ

beginIndex:Number - 選択範囲の始めのインデックス。

endIndex:Number - 選択範囲の終わりのインデックス。

例

次の ActionScript コードは、実行時にテキストフィールドを作成し、ストリングを追加します。次に onSetFocus イベントにイベントハンドラを割り当てます。このイベントは、テキストフィールド内のすべてのテキストを選択して、編集セッションをアクティブにします。

メモ : Selection.setSelection() メソッドが呼び出された場合は、fscommand activateTextField コマンドが呼び出されてテキストフィールドがアクティブになるまで、テキストはスクリーンに表示されません。

this.createTextField("myText_txt", 99, 10, 10, 200, 30);
myText_txt.type = "input";
myText_txt.text = "this is my text";
myText_txt.onSetFocus = function(){
    Selection.setSelection(0,myText_txt.text.length);
    fscommand("activateTextField");
}

次の例では、endIndex パラメータを指定しない方法を示します。最初の文字を選択するには、値が 0 でなく 1 の endIndex を使用する必要があります。endIndex パラメータを 0 に設定すると、何も選択されません。

this.createTextField("myText_txt", 99, 10, 10, 200, 30);
myText_txt.text = "this is my text";
this.onEnterFrame = function () {
    Selection.setFocus("myText_txt");
    Selection.setSelection(0, 1);
    delete this.onEnterFrame;
}