LTextField Class
新しい LTextField インスタンスを作成します。LTextField インスタンスの作成後、親 LSprite オブジェクトの addChild() メソッドまたは addChildAt() メソッドを呼び出し、LTextField インスタンスを表示リストに追加します。 LTextField クラスのメソッドを使用すると、オーサリング時または実行時に作成したダイナミックテキストフィールドやテキスト入力フィールドにテキストを設定、選択、および操作できます。
Constructor
LTextField
()
public
Example:
var theTextField = new LTextField();
theTextField.setType(LTextFieldType.INPUT);
theTextField.x = 10;
theTextField.y = 10;
addChild(theTextField);
Item Index
Methods
Properties
Methods
addEventListener
-
type
-
listener
イベントリスナーオブジェクトを LEventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントリスナーは、特定のタイプのイベント、段階、および優先度に関する表示リスト内のすべてのノードに登録できます。
イベントリスナーが正常に登録された後に、addEventListener() をさらに呼び出して優先度を変更することはできません。リスナーの優先度を変更するには、最初に removeListener() を呼び出す必要があります。その後、同じリスナーを新しい優先度レベルで再度登録できます。
イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。
Parameters:
-
type
Stringイベントのタイプです。
-
listener
Functionイベントを処理するリスナー関数です。
callParent
-
functionName
-
arguments
親クラスの関数を呼び出す。
Parameters:
-
functionName
String函数名
-
arguments
Array固定値arguments
Example:
function funA(){
LExtends(this,LObject,[]);
}
funA.prototype.myName = function(){
return "AAA";
}
function funB(){
LExtends(this,funA,[]);
}
funB.prototype.myName = function(){
return "BBB";
}
function funC(){
LExtends(this,funA,[]);
}
funC.prototype.myName = function(){
return this.callParent("myName",arguments);
}
LInit(1000/50,"legend",800,150,main);
function main(){
LGlobal.setDebug(true);
var objB = new funB();
trace(objB.myName());//BBB
var objC = new funC();
trace(objC.myName());//AAA
}
clone
()
LTextField
public
新しい LTextField オブジェクトとして、元のインスタンスのクローンを返します。オブジェクトはまったく同じコピーになります。
Returns:
元のオブジェクトと同一の新しい LTextField オブジェクトです。
Example:
var circle1 = new LSprite();
circle1.graphics.drawRect(1,"#000000",[0,0,100,100],true,"#000000");
var circle2 = circle1.clone();
circle2.y = 120;
addChild(circle1);
addChild(circle2);
die
()
public
使ったメモリをクリアする。
dispatchEvent
-
event
イベントをイベントフローに送出します。イベントターゲットは LEventDispatcher オブジェクトです。これに対して dispatchEvent() メソッドが呼び出されます。
Parameters:
-
event
LEvent | Stringイベントフローに送出されるイベントオブジェクトです。イベントが再度送出されると、イベントのクローンが自動的に作成されます。イベントが送出された後にそのイベントの target プロパティは変更できないため、再送出処理のためにはイベントの新しいコピーを作成する必要があります。
Returns:
値が true の場合、イベントは正常に送出されました。 function MyEventObject(){ var self = this; LExtends(self,LSprite,[]); self.graphics.drawRect(1,"#000000",[0,0,100,100],true,"#000000"); self.graphics.drawRect(1,"#FF0000",[100,0,100,100],true,"#FF0000"); self.addEventListener(LMouseEvent.MOUSE_UP,self.onclick); self.addEventListener(MyEventObject.CLICK_LEFT,function(event){ trace("dispatchEvent"); }); self.addEventListener(MyEventObject.CLICK_RIGHT,function(event){ trace("dispatchEvent event.name = " + event.name); }); } MyEventObject.CLICK_LEFT = "click_left"; MyEventObject.CLICK_RIGHT = "click_right"; MyEventObject.prototype.onclick = function(event){ var self = event.clickTarget; if(event.selfX < 100){ self.dispatchEvent(MyEventObject.CLICK_LEFT); }else{ var event = new LEvent(MyEventObject.CLICK_RIGHT); event.name = "LEvent Test"; self.dispatchEvent(event); } }
focus
()
public
フォーカスを取得。
Example:
var theTextField = new LTextField();
theTextField.x = 20;
theTextField.y = 20;
theTextField.text = "Click the Enter Key, please!";
addChild(theTextField);
var theTextField1 = new LTextField();
theTextField1.x = 20;
theTextField1.y = 100;
theTextField1.setType(LTextFieldType.INPUT);
addChild(theTextField1);
theTextField1.addEventListener(LTextEvent.TEXT_INPUT, function (e) {
if(e.keyCode == 13){
theTextField2.focus();
}
});
var theTextField2 = new LTextField();
theTextField2.x = 20;
theTextField2.y = 140;
theTextField2.setType(LTextFieldType.INPUT);
addChild(theTextField2);
theTextField2.addEventListener(LTextEvent.TEXT_INPUT, function (e) {
if(e.keyCode == 13){
theTextField1.focus();
}
});
setTimeout(function () {
theTextField1.focus();
}, 200);
getBounds
-
targetCoordinateSpace
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
Parameters:
-
targetCoordinateSpace
LDisplayObject使用する座標系を定義する表示オブジェクトです。
Returns:
targetCoordinateSpace オブジェクトの座標系を基準とする、表示オブジェクトの領域を定義する矩形です。
getDataURL
()
Base64 Image
public
base64でエンコードされた画像の文字列を取得する。
Returns:
base64でエンコードされた画像の文字列。
getHeight
()
Float
public
表示オブジェクトの高さを取得します(ピクセル単位)。
Returns:
オブジェクトの高さ。
Example:
var theTextField = new LTextField();
theTextField.text = "getHeight test";
addChild(theTextField);
trace(theTextField.getHeight());
getWidth
()
Float
public
表示オブジェクトの幅を取得します(ピクセル単位)。
Returns:
オブジェクトの幅。
Example:
var theTextField = new LTextField();
theTextField.text = "getWidth test";
addChild(theTextField);
trace(theTextField.getWidth());
hasEventListener
-
type
LEventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。これにより、LEventDispatcher オブジェクトがイベントタイプの処理をイベントフロー階層のどこで変更したかを判断できます。
Parameters:
-
type
Stringイベントのタイプです。
Returns:
指定したタイプのリスナーが登録されている場合は true、それ以外の場合は false です。
remove
()
public
オブジェクト自体は、親コンテナから除去される。
removeAllEventListener
()
public
LEventDispatcher オブジェクトから全部のリスナーを削除します。
removeEventListener
-
type
-
listener
LEventDispatcher オブジェクトからリスナーを削除します。対応するリスナーが LEventDispatcher オブジェクトに登録されていない場合は、このメソッドを呼び出しても効果はありません。
Parameters:
-
type
Stringイベントのタイプです。
-
listener
Function削除するリスナーオブジェクトです。
setMultiline
-
value
-
height
フィールドが複数行テキストフィールドであるかどうかを示します。値が true である場合は複数行テキストフィールド、値が false である場合は単一行テキストフィールドです。LTextFieldType.INPUT タイプのフィールドでは、Enter キーで改行されるかどうかが決定されます(値が false の場合 Enter キーは無視されます)。
Parameters:
-
value
Booleanフィールドが複数行テキストフィールドであるかどうかを示します。
-
height
Int一行のテキストフィールドの高さを設定する.
Example:
var inputLayer = new LSprite();
inputLayer.graphics.drawRect(1,"#000000",[0, 0, 400, 150]);
var theTextField = new LTextField();
theTextField.setType(LTextFieldType.INPUT,inputLayer);
theTextField.setMultiline(true);
addChild(theTextField);
setType
-
type
-
obj
テキストフィールドのタイプです。次の LTextFieldType 定数のいずれかです。LTextFieldType.DYNAMIC はダイナミックテキストフィールドを指定します。このフィールドをユーザーが編集することはできません。LTextFieldType.INPUT はテキスト入力フィールドを指定します。このフィールドはユーザーが編集できます。デフォルト値: dynamic。
Parameters:
-
type
Stringテキストフィールドのタイプです。
-
obj
LSpriteオブジェクトの形.
Example:
var inputLayer = new LSprite();
inputLayer.graphics.drawRect(1,"#000000",[0, 0, 400, 30]);
var theTextField = new LTextField();
theTextField.setType(LTextFieldType.INPUT,inputLayer);
addChild(theTextField);
setWordWrap
-
value
-
height
フテキストフィールドのテキストを折り返すかどうかを示す。値が true である場合は、テキストフィールドのテキストを折り返し、false である場合は折り返しません。デフォルト値は false です。
Parameters:
-
value
Booleanテキストフィールドのテキストを折り返すかどうかを示す。
-
height
Int一行のテキストフィールドの高さを設定する.
Example:
var theTextField = new LTextField();
theTextField.setWordWrap(true);
theTextField.width = 200;
theTextField.text = "text\ntext\ntexttexttexttexttexttexttexttexttexttexttexttexttexttext";
addChild(theTextField);
updateInput
()
public
LTextFieldオブジェクトは入力ボックスの場合、LTextFieldオブジェクトのtextを入力ボックスに反映する。
Example:
var theTextField = new LTextField();
theTextField.x = 20;
theTextField.y = 20;
theTextField.text = "Click Enter Key to clear the text!";
addChild(theTextField);
var theTextField1 = new LTextField();
theTextField1.text = "test";
theTextField1.x = 20;
theTextField1.y = 100;
theTextField1.setType(LTextFieldType.INPUT);
addChild(theTextField1);
theTextField1.addEventListener(LTextEvent.TEXT_INPUT, function (e) {
if(e.keyCode == 13){
e.currentTarget.text = "";
e.currentTarget.updateInput();
e.preventDefault();
}
});
setTimeout(function () {
theTextField1.focus();
}, 200);
wind
()
public
テキストを1文字ずつ画面に表示させる。
Example:
LInit(50, "legend", 800, 480, main);
function main () {
var theTextField = new LTextField();
theTextField.text = "wait click";
theTextField.x = 10;
theTextField.y = 10;
theTextField.size = 20;
addChild(theTextField);
var button = new LButtonSample1("wind test start");
button.textField = theTextField;
button.x = 10;
button.y = 100;
addChild(button);
button.addEventListener(LMouseEvent.MOUSE_DOWN, onclick);
}
function windOver(event){
var theTextField = event.target;
theTextField.removeEventListener(LTextEvent.WIND_COMPLETE, windOver);
theTextField.text = "wind over";
}
function onclick(event){
var theTextField = event.currentTarget.textField;
if (theTextField.hasEventListener(LTextEvent.WIND_COMPLETE)) {
theTextField.removeEventListener(LTextEvent.WIND_COMPLETE, windOver);
}
theTextField.text = "TEXTTEXTTEXTTEXTTEXTTEXTTEXTTEXTTEXTTEXT";
theTextField.speed = 3;
theTextField.wind();
theTextField.addEventListener(LTextEvent.WIND_COMPLETE, windOver);
}
Properties
alpha
Float
public
指定されたオブジェクトのアルファ透明度値を示します。有効な値は 0(完全な透明)~ 1(完全な不透明)です。デフォルト値は 1 です。alpha が 0 に設定されている表示オブジェクトは、表示されない場合でも、アクティブです。
Default: 0
blendMode
String
public
使用するブレンドモードを指定する LBlendMode クラスの値です。内部的には、2 つの方法でビットマップを描画できます。ブレンドモードを有効にした場合、または外部クリッピングマスクを使用する場合には、ビットマップで塗りつぶされた四角形シェイプをベクターレンダーに追加することによってビットマップが描画されます。このプロパティを無効な値に設定しようとすると、ランタイムは値を LBlendMode.NORMAL に設定します。
Default: null
color
String
public
テキストの色を示します。
Default: "#000000"
Example:
var theTextField = new LTextField();
theTextField.text = "color test";
theTextField.x = 10;
theTextField.y = 10;
theTextField.color = "#FF0000";
addChild(theTextField);
displayAsPassword
Boolean
public
テキストフィールドがパスワードテキストフィールドであるかどうかを指定します。このプロパティの値が true である場合、テキストフィールドはパスワードテキストフィールドとして扱われ、入力された文字は実際の文字の代わりにアスタリスクで隠されます。false である場合、テキストフィールドはパスワードテキストフィールドとして扱われません。
Default: false
Example:
var theTextField = new LTextField();
theTextField.setType(LTextFieldType.INPUT);
theTextField.x = 10;
theTextField.y = 10;
theTextField.displayAsPassword = true;
addChild(theTextField);
filters
Array
public
表示オブジェクトに現在関連付けられている各フィルターオブジェクトが格納されているインデックス付きの配列です。
Default: null
font
String
public
このテキストフォーマットでのテキストフォント名を示すストリングです。デフォルト値は null で、Flash Player ではテキストに Times New Roman フォントが使用されます。
Default: Arial
Example:
var theTextField = new LTextField();
theTextField.text = "font test";
theTextField.x = 10;
theTextField.y = 10;
theTextField.font = "Georgia";
addChild(theTextField);
lineColor
String
public
テキストエフェクトの線の色。
Default: "#000000"
lineWidth
Int
public
テキストエフェクトの線のサイズ。
Default: 1
mask
LDisplayObject
public
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。ステージの拡大および縮小時にマスクが確実に機能するためには、表示リストのアクティブな部分に mask 表示オブジェクトが含まれている必要があります。mask オブジェクト自体は描画されません。マスクを除去するには mask を null に設定します。
Default: null
mouseEnabled
Boolean
public
このオブジェクトでマウスまたはその他のユーザー入力メッセージを受け取るかどうかを指定します。デフォルト値は true であり、これは表示リスト上の LInteractiveObject インスタンスがデフォルトでマウスイベントまたはその他のユーザー入力イベントを受け取ることを意味します。mouseEnabled を false に設定すると、インスタンスでは、マウスイベント(またはキーボードイベントなど、その他のユーザー入力イベント)を一切受け取りません。表示リスト上のこのインスタンスの子は影響を受けません。表示リスト上のオブジェクトのすべての子に関する mouseEnabled 動作を変更するには、LDisplayObjectContainer.mouseChildren を使用します。
Example:
LGlobal.setDebug(true);
var button01 = new LButtonSample1("mouseEnabled=true");
button01.x = button01.y = 20;
addChild(button01);
button01.addEventListener(LMouseEvent.MOUSE_DOWN,function(e){
trace("button01 click");
});
var button02 = new LButtonSample1("mouseEnabled=false");
button02.x = 20;
button02.y = 150;
button02.mouseEnabled = false;
addChild(button02);
button02.addEventListener(LMouseEvent.MOUSE_DOWN,function(e){
trace("button02 click");
});
numLines
Int
public
複数行テキストフィールド内のテキスト行の数を定義します。setWordWrap(true)の場合、テキストが折り返されると行数は増えます。
objectIndex
Int
public
オブジェクトのID
rotate
Float
public
LDisplayObject インスタンスの元の位置からの回転角を度単位で示します。時計回りに回転させる場合は 0 ~ 180 の値を指定します。反時計回りに回転させる場合は 0 ~ -180 の値を指定します。この範囲を超える値は、360 を加算または減算して、範囲内に収まる値になるように調整されます。例えば、my_video.rotate = 450 というステートメントは my_video.rotate = 90 と同義です。
Default: 0
scaleX
Float
public
基準点から適用されるオブジェクトの水平スケール(パーセンテージ)を示します。 デフォルトの基準点は (0,0) です。1.0 は縮尺 100% と同等です。
Default: 1
scaleY
Float
public
オブジェクトの基準点から適用されるオブジェクトの垂直スケール(パーセンテージ)を示します。 デフォルトの基準点は (0,0) です。1.0 は縮尺 100% です。
Default: 1
size
Int
public
このテキストフォーマットのテキストのサイズ(ピクセル単位)です。
Default: 11
Example:
var theTextField = new LTextField();
theTextField.text = "size test";
theTextField.x = 10;
theTextField.y = 10;
theTextField.size = 20;
addChild(theTextField);
speed
Int
public
テキストを1文字ずつ画面に表示させるスピード。
Default: 0
Example:
LInit(50, "legend", 800, 480, main);
function main () {
var theTextField = new LTextField();
theTextField.text = "wait click";
theTextField.x = 10;
theTextField.y = 10;
theTextField.size = 20;
addChild(theTextField);
var button = new LButtonSample1("wind test start");
button.textField = theTextField;
button.x = 10;
button.y = 100;
addChild(button);
button.addEventListener(LMouseEvent.MOUSE_DOWN, onclick);
}
function windOver(event){
var theTextField = event.target;
theTextField.removeEventListener(LTextEvent.WIND_COMPLETE, windOver);
theTextField.text = "wind over";
}
function onclick(event){
var theTextField = event.currentTarget.textField;
if (theTextField.hasEventListener(LTextEvent.WIND_COMPLETE)) {
theTextField.removeEventListener(LTextEvent.WIND_COMPLETE, windOver);
}
theTextField.text = "TEXTTEXTTEXTTEXTTEXTTEXTTEXTTEXTTEXTTEXT";
theTextField.speed = 3;
theTextField.wind();
theTextField.addEventListener(LTextEvent.WIND_COMPLETE, windOver);
}
stroke
String
public
テキストエフェクト。
Default: false
Example:
var theTextField = new LTextField();
theTextField.text = "stroke test";
theTextField.size = 50;
theTextField.stroke = true;
theTextField.lineWidth = 2;
theTextField.lineColor = "#FF0000";
addChild(theTextField);
text
String
public
テキストフィールド内の現在のテキストであるストリングです。行は復帰文字('\n')で区切られます。
textAlign
String
public
段落の行揃えの設定を示します(水平)。
Default: left
textBaseline
String
public
段落の行揃えの設定を示します(垂直)。
Default: top
type
String
public
オブジェクトのタイプ
Default: LTextField
visible
Boolean
public
表示オブジェクトが可視かどうかを示します。非可視の表示オブジェクトは無効になります。例えば、ある LInteractiveObject インスタンスが visible=false に設定されている場合、これをクリックすることはできません。
Default: true
weight
String
public
テキストをボールドにするかどうかを指定します。
Default: normal
Example:
var theTextField = new LTextField();
theTextField.text = "weight test";
theTextField.x = 10;
theTextField.y = 10;
theTextField.weight = "bolder";
addChild(theTextField);
width
Int
public
折り返す時、表示オブジェクトの幅を設定することができます。
Default: 150
x
Float
public
親 LDisplayObjectContainer のローカル座標を基準にした LDisplayObject インスタンスの x 座標を示します。変形されている LDisplayObjectContainer にオブジェクトが含まれる場合、そのオブジェクトの座標系は、それを囲む LDisplayObjectContainer のローカル座標系になります。したがって、反時計回りに 90 度回転した LDisplayObjectContainer の場合、その LDisplayObjectContainer の子は、反時計回りに 90 度回転した座標系を継承します。オブジェクトの座標は、基準点の位置を参照します。
Default: 0
y
Float
public
親 LDisplayObjectContainer のローカル座標を基準にした LDisplayObject インスタンスの y 座標を示します。変形されている LDisplayObjectContainer にオブジェクトが含まれる場合、そのオブジェクトの座標系は、それを囲む LDisplayObjectContainer のローカル座標系になります。したがって、反時計回りに 90 度回転した LDisplayObjectContainer の場合、その LDisplayObjectContainer の子は、反時計回りに 90 度回転した座標系を継承します。オブジェクトの座標は、基準点の位置を参照します。
Default: 0
Events
LEvent.ENTER_FRAME
[ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。
LFocusEvent.FOCUS_IN
LTextFieldオブジェクトがフォーカスを取得した後に送出されます。
LFocusEvent.FOCUS_OUT
LTextFieldオブジェクトがフォーカスを失った後に送出されます。
LMouseEvent.DOUBLE_CLICK
利用不可。
LMouseEvent.MOUSE_DOWN
利用不可。
LMouseEvent.MOUSE_MOVE
利用不可。
LMouseEvent.MOUSE_OUT
利用不可。
LMouseEvent.MOUSE_OVER
利用不可。
LMouseEvent.MOUSE_UP
利用不可。