IEditableText  - AS3 Flex

此顯示物件的目前輔助功能選項。 如果您要修改 accessibilityProperties 屬性或 accessibilityProperties 中的任何欄位，必須呼叫 Accessibility.updateProperties() 方法，才能使變更生效。

注意：對於在 Flash 編寫環境中建立的物件而言，accessibilityProperties 的值會預先填入您在「輔助功能」面板中輸入與該物件相關的任何資訊。

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

Flag that indicates whether the text is editable.

預設值為 false。

Whether the component can accept user interaction. After setting the enabled property to false, some components still respond to mouse interactions such as mouseOver. As a result, to fully disable UIComponents, you should also set the value of the mouseEnabled property to false. If you set the enabled property to false for a container, Flex dims the color of the container and of all of its children, and blocks user input to the container and to all of its children.

Indicates whether the component can receive focus when tabbed to. You can set focusEnabled to false when a UIComponent is used as a subcomponent of another component so that the outer component becomes the focusable entity. If this property is false, focus is transferred to the first parent that has focusEnable set to true.

The default value is true, except for the spark.components.Scroller component. For that component, the default value is false.

The horizontal scroll position of the text.

Controls word wrapping within the text. This property corresponds to the lineBreak style.

相關 API 元素

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

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

指出使用者能夠輸入文字欄位中的字元組。 如果 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";
     

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

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

The active, or last clicked position, of the selection. If the implementation does not support selection anchor this is the last character of the selection.

The anchor, or first clicked position, of the selection. If the implementation does not support selection anchor this is the first character of the selection.

會指定 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;
	 

The vertical scroll position of the text.

Appends the specified text to the end of the text component, as if you had clicked at the end and typed.

An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.

參數

Inserts the specified text into the text component as if you had typed it.

If a range was selected, the new text replaces the selected text. If there was an insertion point, the new text is inserted there.

An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.

參數

Scroll so the specified range is in view.

參數

Selects all of the text.

Selects a specified range of characters.

If either position is negative, it will deselect the text range.

參數

Set focus to this text field.