IUITextField  - AS3 Flex

當設定為 true 而且文字欄位不在焦點中時，Flash Player 便會將文字欄位中的選取範圍反白標示為灰色。 當設定為 false 而且文字欄位不在焦點中時，Flash Player 便不會反白標示文字欄位中的選取範圍。

對此文字欄位使用的消除鋸齒類型。 請針對此屬性使用 flash.text.AntiAliasType 常數。 只有在字體是嵌入時 (embedFonts 屬性設定為 true) 才能控制這個設定。 預設值是 flash.text.AntiAliasType.NORMAL。

若要設定此屬性，請使用下列字串值：

控制文字欄位的自動調整大小和對齊方式。 TextFieldAutoSize 常數的可接受值：TextFieldAutoSize.NONE (預設值)，TextFieldAutoSize.LEFT、TextFieldAutoSize.RIGHT 和 TextFieldAutoSize.CENTER。

如果 autoSize 設定為 TextFieldAutoSize.NONE (預設值)，就不會調整大小。

如果 autoSize 設定為 TextFieldAutoSize.LEFT，就會將文字視為靠左對齊的文字，這表示文字欄位的左方邊界會維持固定，而且文字欄位的單一字行若有任何調整大小的行為，都會發生在右方邊界。 如果文字包含斷行符號 (例如，"\n" 或 "\r")，也會調整底部的大小，以配合下一行文字。 如果 wordWrap 也設定為 true，則只有文字欄位底部才會調整大小，右方邊界則維持不變。

如果 autoSize 設定為 TextFieldAutoSize.RIGHT，就會將文字視為靠右對齊的文字，這表示文字欄位的右方邊界會維持固定，而且文字欄位的單一字行若有任何調整大小的行為，都會發生在左方邊界。 如果文字包含斷行符號 (例如，"\n" 或 "\r")，也會調整底部的大小，以配合下一行文字。 如果 wordWrap 也設定為 true，則只有文字欄位底部才會調整大小，左方邊界則維持不變。

如果 autoSize 設定為 TextFieldAutoSize.CENTER，則文字會被視為置中對齊的文字，表示文字欄位的單一字行若有任何調整大小的行為，都會平均分配到左右方的邊界。 如果文字包含斷行符號 (例如，"\n" 或 "\r")，也會調整底部的大小，以配合下一行文字。 如果 wordWrap 也設定為 true，則只有文字欄位底部才會調整大小，左右方邊界則維持不變。

會指定文字欄位是否具有背景填色。 如果為 true，文字欄位就會有背景填色； 如果 false，則文字欄位不會有背景填色。 請使用 backgroundColor 屬性設定文字欄位的背景顏色。

文字欄位背景的顏色。 預設值為 0xFFFFFF (白色)。 即使目前沒有背景，您依然可以擷取或設定這個屬性，不過只有在文字欄位的 background 屬性設定為 true 時，才能看見這個顏色。

會指定文字欄位是否具有邊框。 如果是 true，文字欄位便具有邊框； 如果是 false，文字欄位則沒有邊框。 請使用 borderColor 屬性設定邊框顏色。

文字欄位邊框的顏色。 預設值為 0x000000 (黑色)。 即使目前沒有邊框，您依然可以擷取或設定這個屬性，不過只有在文字欄位的 border 屬性設定為 true 時，才能看見這個顏色。

整數 (從 1 開始的索引)，指出目前在指定之文字欄位中，可以看見的最底端字行。 將文字欄位視為文字區塊上的視窗。 scrollV 屬性是視窗中，最頂端之可見字行的索引 (從 1 開始)。

在文字欄位中，scrollV 與 bottomScrollV 字行間的所有文字目前都是可見的。

插入點 (跳脫字元) 位置的索引。 如果沒有顯示插入點，其值就是您將焦點還原至欄位時的插入點位置 (通常會是插入點的最後位置，不曾有過焦點時則會是 0)。

合併選取範圍索引從零開始記算 (例如，第一個位置是 0，第二個位置是 1，依此類推)。

Boolean 值，指定在具有 HTML 文字的文字欄位中，是否移除額外的空白字元 (空格、斷行符號等等)。預設值為 false。condenseWhite 屬性只會影響以 htmlText 屬性 (而非 text 屬性) 設定的文字。 如果您以 text 屬性設定文字，便會忽略 condenseWhite。

如果 condenseWhite 是設定為 true，請使用標準 HTML 命令 (如 <BR> 和 <P>)，將斷行符號放置在文字欄位中。

設定 htmlText 屬性之前，請先設定 condenseWhite 屬性。

指定套用至新插入之文字 (例如，使用者所輸入的文字，或是以 replaceSelectedText() 方法插入的文字) 的格式。

注意：選取要用 setSelection() 和 replaceSelectedText() 取代的字元時，唯有已達到且包含所選取的文字最後的字元時，才會套用 defaultTextFormat。底下是一個範例：

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

當您存取 defaultTextFormat 屬性時，傳回的 TextFormat 物件會定義所有屬性。 沒有屬性是 null。

注意： 如果已經將樣式表套用至文字欄位，就不能設定這個屬性。

指定文字欄位是否為密碼文字欄位。 如果此屬性的值是 true，就會將文字欄位視為密碼文字欄位，並會使用星號隱藏輸入字元，而不會顯示實際字元。 如果是 false，就不會將文字欄位視為密碼文字欄位。 啟用密碼模式時，「剪下」與「複製」命令及其對應的鍵盤快速鍵都不會具有作用。 這個安全性機制可預防惡意使用者利用捷徑來找出無人看管的電腦上之密碼。

指定物件是否接收 doubleClick 事件。 預設值為 false，也就是說，InteractiveObject 依預設無法接收 doubleClick 事件。 如果將 doubleClickEnabled 屬性設為 true，則實體會接收到其範圍內的 doubleClick 事件。 InteractiveObject 實體的 mouseEnabled 屬性必須同時設為 true，這樣物件才能接收 doubleClick 事件。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來加入 doubleClick 事件所需的事件偵聽程式。

會指定是否要使用內嵌的字體外框顯示。 如果為 false，Flash Player 會使用裝置字體顯示文字欄位。

如果您將文字欄位的 embedFonts 屬性設定為 true，就必須使用套用至文字欄位的 TextFormat 物件之 font 屬性，指定該文字的字體。 如果指定的字體沒有嵌入 SWF 檔，文字就不會顯示。

會指定這個物件是否會顯示焦點矩形。 它可以接受下列三個值中的其中一個：true、false 或 null。true 和 false 值會如預期方式運作，指定是否顯示焦點矩形。null 值表示此物件會遵循舞台的 stageFocusRect 屬性。

對此文字欄位使用的格線符合類型。 只有在文字欄位的 flash.text.AntiAliasType 屬性設定為 flash.text.AntiAliasType.ADVANCED 時，才會套用這個屬性。

格線符合的類型，用於決定 Flash Player 是否會強制強的水平和垂直線，以符合像素或子像素格線，或是不符合任何格線。

針對 flash.text.GridFitType 屬性，您可以使用下列字串值：

包含 HTML 表示方式的文字欄位內容。

Flash Player 支援下列 HTML 標籤：

Flash Player 和 AIR 支援下列 HTML 實體：

Flash Player 和 AIR 也明確支援字元碼，如 & (ASCII 的 & 符號) 及 € (Unicode 的 € 符號)。

If true, the paddingLeft and paddingRight styles will not add space around the text of the component.

The beginning of this UITextField's chain of inheriting styles. The getStyle() method accesses inheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

文字欄位中的字元數。 像是定位點字元 (\t) 這類字元也算是一個字元。

文字欄位可以包含的最大字元數，也就是使用者可輸入的字元數。 程式碼可以插入比 maxChars 允許還多的文字；maxChars 屬性僅會指出使用者可輸入多少文字。 如果此屬性的值是 0，使用者即可輸入無限數量的文字。

scrollH 的最大值。

scrollV 的最大值。

指定此物件是否接收滑鼠或其他使用者輸入及訊息。預設值為 true，也就是說，任何位於顯示清單上的 InteractiveObject 實體，依預設都會接收滑鼠事件或其他使用者輸入事件。如果 mouseEnabled 設定成 false，則此實體不會接收任何滑鼠事件 (或其他使用者輸入事件，例如鍵盤事件)。在顯示清單上，此實體的任何子系都不會受到影響。 若要變更顯示清單上某個物件的所有子系之 mouseEnabled 行為指令，請使用 flash.display.DisplayObjectContainer.mouseChildren。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來建立互動式功能。

Boolean 值，指出當使用者按一下文字欄位並滾動滑鼠滾輪時，Flash Player 是否會自動捲動多行文字欄位。根據預設，這個值為 true。 如果想要防止滑鼠滾輪捲動文字欄位，或實作您自己的文字欄位捲動，這個屬性就會很有用。

指出欄位是否為多行文字欄位。如果其值是 true，文字欄位就是多行；如果是 false，則表示文字欄位是單行文字欄位。在 TextFieldType.INPUT 類型的欄位中，multiline 值會決定 Enter 鍵是否會建立新行 (如果為 false 值，則會忽略 Enter 鍵)。如果您將文字貼至 multiline 值為 false 的 TextField，則會從文字中去除新行字元。

Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.

The beginning of this UITextField's chain of non-inheriting styles. The getStyle() method accesses nonInheritingStyles[styleName] method to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.

會定義多行文字欄位中的文字行數。 如果 wordWrap 屬性設定為 true，行數便會在文字換行時增加。

指出使用者能夠輸入文字欄位中的字元組。 如果 restrict 屬性的值是 null，您就可以輸入任何字元。 如果 restrict 屬性的值是空字串，您就不能輸入任何字元。 如果 restrict 屬性的值是字元組成的字串，您只能在文字欄位內輸入此字串中的字元。 會由左向右掃描這個字串。 您可以使用連字符號 (-) 字元指定範圍。 只會限制使用者互動；Script 可以將任何文字放入文字欄位中。這個屬性不會與「屬性」檢測器中的「嵌入字體」選項同步化。

如果字串以跳脫字元 (^) 開始，在初始時便會接受所有的字元，字串中的後續字元則會排除在接受的字元組之外。 如果該字串不是以跳脫字元 (^) 開始，在初始時便不會接受任何字元，並且字串中的後續字元都會包含在接受的字元組內。

下列範例只允許在文字欄位中輸入大寫字元、空格和數字：

     my_txt.restrict = "A-Z 0-9";
     

下列範例包含所有字元，但排除小寫字母：

     my_txt.restrict = "^a-z";
     

您可以使用反斜線來逐字輸入 ^ 或 -。 接受的反斜線序列為 \-、\^ 或 \\。 反斜線必須是字串中的實際字元，因此當您在 ActionScript 中指定它時，就必須使用雙反斜線。 例如，以下的程式碼只包含破折號 (-) 和跳脫字元 (^)：

     my_txt.restrict = "\\-\\^";
     

^ 可以在字串中的任何一處使用，用以切換包含的字元及排除的字元。下列程式碼只包含大寫字母，但排除大寫字母 Q：

     my_txt.restrict = "A-Z^Q";
     

您可以使用 \u 跳脫序列來建構 restrict 字串。下列程式碼只包含從 ASCII 32 (空格) 到 ASCII 126 ("~" 符號) 的字元。

     my_txt.restrict = "\u0020-\u007E";
     

目前的水平捲動位置。 如果 scrollH 屬性是 0，文字便不會水平捲動。 這個屬性值是代表水平位置 (以像素為單位) 的整數。

水平捲動的單位是像素，垂直捲動的單位則是字行。 水平捲動是以像素為單位來測量，因為一般使用的字體多數都依比例調整間距。也就是說，字元可以有不同的寬度。 由於使用者通常希望看到的是完整的字行，而非部分的字行，所以 Flash Player 會逐行執行垂直捲動。 即使一個字行使用多種字體，該字行的高度也會調整以配合使用的最大字體。

注意： scrollH 屬性是從 0 開始，不像 scrollV 垂直捲動屬性是從 1 開始。

文字欄位中文字的垂直位置。 scrollV 屬性有助於在長篇中將使用者引導至特定的段落，或是建立捲動的文字欄位。

垂直捲動的單位是字行，水平捲動的單位則是像素。 如果顯示的第一個字行是文字欄位中的第一個字行，scrollV 便會設定為 1 (而非 0)。 水平捲動是以像素為單位來測量，因為多數字體都是依比例調整間距。也就是說，字元可以有不同的寬度。 由於使用者通常希望看到的是完整的字行，而非部分的字行，所以 Flash 會逐行執行垂直捲動。 即使一行文字上有多種字體，行的高度也會調整成符合所使用的最大字體。

指出文字欄位是否可選取的 Boolean 值。 true 值表示文字是可選取的。 selectable 屬性會控制是否可選取 (而非編輯) 文字欄位。 動態的文字欄位就算不能編輯一樣可以選取。 如果無法選取動態文字欄位，使用者便無法選取其文字。

如果 selectable 設定為 false，文字欄位中的文字就不會回應滑鼠或鍵盤上的選取命令，而且也無法以「複製」命令複製文字。 如果 selectable 設定為 true，即可以滑鼠或鍵盤選取文字欄位中的文字，並且能以「複製」命令複製文字。 就算文字欄位是動態文字欄位而不是輸入文字欄位，您仍然可以依這種方式選取文字。

目前選取範圍中，第一個字元的字元索引值 (從零開始)。 例如，第一個字元是 0，第二個字元是 1，依此類推。 如果沒有選取文字，此屬性便會是 caretIndex 的值。

目前選取範圍中，最後一個字元的字元索引值 (從零開始)。 例如，第一個字元是 0，第二個字元是 1，依此類推。 如果沒有選取文字，此屬性便會是 caretIndex 的值。

在這個文字欄位中，文字邊緣的清晰度。只有在文字欄位的 flash.text.AntiAliasType 屬性設定為 flash.text.AntiAliasType.ADVANCED 時，才會套用這個屬性。 sharpness 的範圍是從 -400 到 400 之間的數字。 如果嘗試將 sharpness 設定為範圍外的值，Flash 會將屬性設定為離範圍內最近的值 (不是 -400 就是 400)。

將樣式表附加至文字欄位。 如需建立樣式表的資訊，請參閱 StyleSheet 類別和「ActionScript 3.0 開發人員指南」。

您隨時都能變更與文字欄位有關聯的樣式表。 如果您變更使用中的樣式表，便會以新的樣式表重繪文字欄位。 您可以將樣式表設定為 null 或 undefined 以移除樣式表。 使用的樣式表若被移除，文字欄位會在沒有樣式表的情況下重新繪製。

注意：如果移除樣式表，TextField.text 及 TextField.htmlText 的內容都會變更，以便將該樣式表先前套用的格式納入。 若要保留不含格式的原始 TextField.htmlText 內容，請先將該值儲存在變數中，再移除樣式表。

會指定這個物件是否在停駐點順序中。 如果此物件在定位停駐點順序中，則其數值為 true，否則為 false。 根據預設，除了下列情況以外，這個值都為 false：

• 對於 SimpleButton 物件，這個值為 true。
• 對於具有 type = "input" 的 TextField 物件，這個值為 true。
• 對於 Sprite 物件或具有 buttonMode = true 的 MovieClip 物件，這個值為 true。

會指定 SWF 檔中的物件停駐點順序。 tabIndex 屬性預設為 -1，也就是說該物件沒有設定任何定位停駐點索引。

如果目前該 SWF 檔所顯示的任何物件含有 tabIndex 屬性，自動定位停駐點順序便會停用，而定位停駐點的順序會從物件在 SWF 檔中的 tabIndex 屬性開始計算。 自訂定位停駐點順序只會包含具有 tabIndex 屬性的物件。

tabIndex 屬性可以是非負值的整數。 物件是根據它們的 tabIndex 屬性，依遞增順序排列。 tabIndex 值為 1 的物件會排在 tabIndex 值為 2 的物件前面。 請勿對多個物件使用相同的 tabIndex 值。

由 tabIndex 屬性所定義的自訂定位停駐點順序是「平面」。 也就是說，SWF 檔中物件的階層架構關係是被忽略的。 該 SWF 檔中具有 tabIndex 屬性的所有物件都是依照定位停駐點順序放置的；這個定位停駐點順序是由 tabIndex 值的順序來決定。

注意：若要為 TLFTextField 實體設定停駐點順序，請將 TLFTextField 的顯示物件子系轉換為 InteractiveObject，然後設定 tabIndex 屬性。例如：

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

做為文字欄位中目前文字的字串。 字行是由歸位字元 ('\r'，ASCII 13) 加以區隔。 這個屬性包含文字欄位中不含 HTML 標籤的未格式化文字。

若要取得 HTML 格式的文字，請使用 htmlText 屬性。

注意：如果樣式表套用到文字欄位，text 屬性的內容將會解譯為 HTML。

文字欄位中文字的顏色，以十六進位格式表示。 16 進位顏色系統使用六位數來代表顏色值。 每位數字都具有 16 種可能的值或字元。字元的範圍從 0 到 9，並從 A 到 F。例如，黑色是 0x000000；白色是 0xFFFFFF。

文字的高度，以像素為單位。

文字的寬度，以像素為單位。

在這個文字欄位中，字符邊緣的粗細。 只有在 flash.text.AntiAliasType 設定為 flash.text.AntiAliasType.ADVANCED 才會套用這個屬性。

thickness 的範圍是從 -200 到 200 之間的數字。 如果嘗試將thickness 設定為範圍外的值，Flash 會將屬性設定為離範圍內最近的值 (不是 -200 就是 200)。

文字欄位的類型。 可以是下列其中一個 TextFieldType 常數：TextFieldType.DYNAMIC，會指定使用者無法編輯的動態文字欄位；或是 TextFieldType.INPUT，會指定使用者可以編輯的輸入文字欄位。

會指定文字格式是否隨著文字一起複製和貼上。 如果設定為 true，則當您在文字欄位之間複製和貼上文字時，Flash Player 也會複製和貼上格式 (如對齊方式、粗體及斜體)。複製和貼上程序中的原始與目標文字欄位，都必須將 useRichTextClipboard 設定為 true。 預設值是 false。

指出文字欄位是否具有文字換行功能的 Boolean 值。 如果 wordWrap 的值是 true，文字欄位便有文字換行；如果這個值是 false，文字欄位就沒有文字換行。 預設值是 false。

會將 newText 參數所指定的字串附加到文字欄位之文字的尾端。 這個方法比使用加法指定 (+= ) text 屬性 (如 someTextField.text += moreText) 的方式更有效率，特別適用於含有大量內容的文字欄位。

參數

會傳回做為字元之範圍框的矩形。

參數

會在 x 和 y 參數所指定的點，傳回字元的索引值 (從零開始)。

參數

指定字元索引，會傳回相同段落中第一個字元的索引。

參數

對於使用 <img> 標籤新增至 HTML 格式之文字欄位的影像或 SWF 檔，傳回指定之 id 的 DisplayObject 參考。 <img> 標籤的格式如下：

   <img src = 'filename.jpg' id = 'instanceName' >

參數

會在 x 和 y 參數所指定的點，傳回字行的索引值 (從零開始)。

參數

會傳回字行的索引值 (從零開始)，該字行包含 charIndex 參數所指定的字元。

參數

會傳回特定文字行中的字元數。

參數

會傳回關於指定之文字行的公制字資訊。

參數

會傳回 lineIndex 參數所指定之字行中，第一個字元的字元索引。

參數

會傳回 lineIndex 參數所指定之字行的文字。

參數

指定字元索引，會傳回包含指定之字元的段落長度。 這個長度是相對於段落中的第一個字元 (與 getFirstCharInParagraph() 傳回的相同) 而言，而非傳入的字元索引。

參數

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

參數

會傳回 TextFormat 物件，包含 beginIndex 和 endIndex 參數所指定之文字範圍的格式資訊。 唯有對指定之所有文字都通用的屬性，才會在產生的 TextFormat 物件中加以設定。 任何「混合」的屬性，都表示在文字的不同位置會具有不同的值，因此都具有 null 的值。

如果您沒有指定這些參數的值，這個方法便會套用至文字欄位中的所有文字。

下表說明三個可能的用法：

參數

Returns a UITextFormat object that contains formatting information for this component. This method is similar to the getTextFormat() method of the flash.text.TextField class, but it returns a UITextFormat object instead of a TextFormat object.

The UITextFormat class extends the TextFormat class to add the text measurement methods measureText() and measureHTMLText().

以 value 參數的內容取代目前的選取範圍。 文字會插入到目前選取範圍的位置，它會使用目前的預設字元格式和預設段落格式。 並且不會被視為 HTML。

您可以使用 replaceSelectedText() 方法插入並刪除文字，而不中斷文字中其它部分的字元及段落格式。

注意：如果將樣式表套用至文字欄位，這個方法就無法使用。

參數

將 beginIndex 和 endIndex 參數所指定的字元範圍，以 newText 參數的內容取代。 依原設計，這會取代從 beginIndex 到 endIndex-1 的文字。

注意：如果將樣式表套用至文字欄位，這個方法就無法使用。

參數

Sets the font color of the text.

參數

Sets the focus to this component. The component can in turn pass focus to a subcomponent.

Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.

會根據第一個和最後一個字元指定的索引值 (以 beginIndex 和 endIndex 參數指定)，設定選取文字。 如果這兩個參數值相同，這個方法便會設定插入點，就像是設定 caretIndex 屬性一樣。

參數