HTML 텍스트의 TextInput 컨트롤로부터 여분의 공백 캐릭터 (스페이스나 개행등)를 삭제할지 어떨지를 지정합니다.

condenseWhite property는,text property는 아니고 htmlText property로 설정된 텍스트에게만 영향을 줍니다. text property로 텍스트를 설정했을 경우,condenseWhite 는 무시됩니다.

condenseWhite property를 true 로 설정했을 경우는, 텍스트 필드내에서 개행을 지정할 경우에 <br> 나 <p> 등의 표준의 HTML 커멘드를 사용할 필요가 있습니다.

디폴트치false;.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

아이템 렌더러 또는 아이템 에디터로 컴퍼넌트를 사용할 경우에, 컴퍼넌트에 값을 건네줄 수가 있습니다. 통상, 데이터 바인딩을 사용해,data property의 필드를 이 컴퍼넌트의 property에 바인드 합니다.

드롭 인 아이템 렌더러 또는 드롭 인 아이템 에디터로서 컨트롤을 사용하면, 아이템의 현재의 값이, 이 컨트롤의 text property에 자동적으로 기입해집니다.

MXML 로 이 property를 설정할 것은 없습니다.

디폴트치null.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

See also

이 컨트롤이 패스워드의 입력으로 사용될지 어떨지를 나타냅니다. true 의 경우, 입력된 텍스트는 필드에는 표시되지 않습니다. 대신에, 컨트롤에 입력된 각 텍스트의 캐릭터는, 캐릭터 "*" 로서 표시됩니다.

디폴트치false.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

이 컨트롤내의 텍스트를 유저가 편집할 수 있을지 어떨지를 나타냅니다. true 의 경우, 유저가 텍스트를 편집할 수 있습니다.

디폴트치true.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

/ 현재 표시되고 있는 컨텐츠 area의 제일왼쪽에 있는 픽셀의 픽셀 위치입니다. (컨텐츠 area에는, 현재 표시되고 있는 부분 만이 아니고, 컨트롤의 모든 내용이 포함됩니다). 이 property는 항상 0 으로 설정되어 있어wordWrap 가 true 로 설정되어 있는 경우는 변경도 무시됩니다.

디폴트치0.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

TextInput 컨트롤에 의해 표시되는 텍스트를 지정합니다. 텍스트의 스타일을 나타내는 HTML 마크 업을 포함해 지정합니다. 이 property로 HTML 텍스트를 지정하는 경우는, Flash TextField 컨트롤로 지원(support)되고 있는 HTML 태그의 부분집합을 사용할 수 있습니다.

이 property를 설정하면, TextInput 인스턴스에 CSS 스타일이 적용된 후에 HTML 마크 업이 적용됩니다. 이 property를 취득하면, HTML 마크 업에 CSS 스타일이 포함됩니다.

예를 들어,"This is an example of <b>bold</b> markup" 라고 하는 캐릭터 라인을 설정했을 경우, TextInput 에는, 통상 적용되는 CSS 스타일이 적용된 「This is an example of bold markup」라고 하는 텍스트가 표시됩니다. 또,<b> 마크 업에 의해,"bold" 라고 하는 단어가 볼드체의 폰트로 표시됩니다.

HTML 마크 업에서는, < 나 > 등의 캐릭터를 사용합니다. 이러한 캐릭터는, XML 에서는 특별한 의미를 가지고 있습니다 (MXML 에서도 같습니다) . 따라서, 다음과 같은 코드는 컴파일 되지 않습니다.

<mx:TextInput htmlText="This is an example of <b>bold</b> markup"/>
   

이 문제를 회피하려면 , 3 개의 방법이 있습니다.

• initialize 핸들러로서 불려 가는 ActionScript Methods의 htmlText property를 설정합니다.

  <mx:TextInput id="myTextInput" initialize="myTextInput_initialize()"/>
     

  myTextInput_initialize Methods는, 스크립트의 CDATA 섹션으로 지정합니다.

  <mx:Script>
  <! [CDATA[
  private function myTextInput_initialize() :void {
  myTextInput.htmlText = "This is an example of <b>bold</b> markup";
     }
     ]]>
  </mx:Script>
     
     

  HTML 마크 업의 읽기 쉬움이 유지되므로, 이것이 가장 단순한 방법입니다. initialize 핸들러로 TextInput 를 참조할 수 있도록(듯이) 하려면 , TextInput 에 id 를 할당할 필요가 있습니다.

• CDATA 섹션으로 child 태그를 사용해,htmlText property를 지정합니다. XML 의 CDATA 섹션에는, < 나 > 등의 캐릭터가 특별한 의미를 가지지 않는 캐릭터 데이터가 포함됩니다.

  <mx:TextInput>
  <mx:htmlText><! [CDATA[이것은 <b>bold</b> 마크 업의 샘플입니다]]></mx:htmlText>
  <mx:TextInput/>
     

  <mx:TextInput>htmlText property를 기술할 필요가 있습니다. XML 에서는 속성의 값에 CDATA 를 사용할 수 없기 때문입니다. 마크 업은 읽어낼 수 있습니다만, CDATA 섹션에서는 이 방법은 복잡하게 됩니다.

• 속성치내의 HTML 마크 업 캐릭터 < 와 > 가 기입해지는 (곳)중에, XML 엔티티의 < 와 > 로서 hmtlText 속성을 대신에 사용합니다.

  <mx:TextInput htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
     

  HTML 마크 업의 독해가 거의 불가능하게 되므로, 이 방법은 추천하지 않습니다.

htmlText property가 설정되어 있을 때 condenseWhite property가 true 의 경우, 복수의 공백 캐릭터는, HTML 대응 브라우저와 같이 압축됩니다. 예를 들어, 3 개이 연속하는 스페이스는, 1 개의 스페이스로서 표시됩니다. condenseWhite 의 기정치는 false 이므로, 공백 캐릭터를 압축하려면 condenseWhite 를 true 로 설정할 필요가 있습니다.

htmlText property의 설정 직후에 그것을 읽어들였을 경우는, 설정한 것과 같은 string가 취득됩니다. 다만, LayoutManager 의 실행 후에는, 값은 변경되어 CSS 스타일을 포함한 마크 업이 추가됩니다.

htmlText property의 설정은, 다양한 방법으로 text property에 영향을 줍니다. htmlText property의 설정 직후에 text property를 읽어들였을 경우는 null 가 취득됩니다. 이것은, 새로운 htmlText 에 대응하는 text 가 아직 결정되어 있지 않은 것을 나타냅니다. 다만, LayoutManager 의 실행 후에는,text property의 값은 모든 HTML 마크 업이 삭제된 htmlText 캐릭터 라인으로 변경됩니다. 즉, 값은, TextInput 가 실제로 표시하는 캐릭터가 됩니다.

반대로,text 설정하면, 전으로 설정된 htmlText property가 적절하지 않게 됩니다. text property의 설정 직후에 htmlText property를 읽어들였을 경우는 null 가 취득됩니다. 이것은, 새로운 text 에 대응하는 htmlText 가 아직 결정되어 있지 않은 것을 나타냅니다. 다만, LayoutManager 의 실행 후에는,htmlText property의 값은 변경되어 새로운 텍스트에 CSS 스타일용의 HTML 마크 업이 추가된 것이 됩니다.

LayoutManager 를 즉시 실행시키려면 , TextInput 로 validateNow() Methods를 호출합니다. 예를 들어, 어떠한 htmlText 를 설정한 후, 곧바로validateNow() Methods를 호출하면, HTML 마크 업을 포함하지 않는 대응하는 text 를 즉시 취득할 수 있습니다.

ActionScript 안에 text property와 htmlText property의 양쪽 모두를 설정했을 경우는, 마지막에 설정된 property가 유효하게 됩니다. MXML 에서는 양쪽 모두 설정하지 말아 주세요. 이것은, MXML 에서는 인스턴스의 property의 취득을 특정의 순서로 설정하는 것이 프로텍션되어 있지 않기 때문입니다.

text property 또는 htmlText property를 루프안으로 설정하면 처리가 고속으로 됩니다. 이것은, 텍스트를 실제로 표시하는 TextField 가, LayoutManager 가 실행될 때까지는 갱신되지 않기 때문입니다.

이 property를 null 로 설정하려고 했을 경우는, 대신에 empty의 string로 설정됩니다. 이 property의 값이 일시적으로 null 가 되었을 경우,text 가 설정되었던 바로 직후로, 대응하는 htmlText 가 아직 인식되어 있지 않은 것을 의미합니다.

디폴트치"".

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

See also

IME (입력 Methods 에디터)의 모드를 지정합니다. IME 를 사용하는 것에 의해, 유저는 중국어, 일본어, 및 한국어의 텍스트를 입력할 수 있습니다. Flex 에서는, 컨트롤에 포커스가 놓여졌을 때에, IME 가 지정된 모드로 설정해, 컨트롤로부터 포커스가 떨어졌을 때에, 원의 모드에 되돌립니다.

flash.system.IMEConversionMode 클래스에서, 이 property의 유효한 값의 정수를 정의합니다. IME 를 전혀 지정하지 않는 경우는,null 를 지정합니다.

디폴트치null.

See also

TextArea 에 표시되는 텍스트의 캐릭터수입니다.

디폴트치0.

드롭 인 아이템 렌더러 또는 드롭 인 아이템 에디터로서 사용하면, 이 컴퍼넌트의 listData property가, 리스트 컨트롤로부터의 해당하는 데이터로 초기화됩니다. 그 후, 컴퍼넌트로 이 listData property를 사용해, 드롭 인 아이템 렌더러 또는 드롭 인 아이템 에디터의 data property를 초기화할 수 있습니다.

MXML 및 ActionScript 로 이 property를 설정할 것은 없습니다. 이 컴퍼넌트가 드롭 인 아이템 렌더러 또는 드롭 인 아이템 에디터로서 사용될 때, Flex 로 property가 설정됩니다.

디폴트치null.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

See also

텍스트 필드에 유저가 입력할 수 있는 최대 캐릭터수입니다. 컨트롤의 text 또는 htmlText property의 설정에 의해 지정되는 텍스트의 길이가, 이 property에 의해 제한될 것은 없습니다.

디폴트치는 0 으로, 제한이 없는 것을 의미하는 특수한 케이스입니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

horizontalScrollPosition 의 최대치입니다.

디폴트치는 0 입니다. 즉, 수평 방향의 스크롤은 요구되지 않습니다.

maxHorizontalScrollPosition property의 값은, 컴퍼넌트의 데이터와 크기로부터 계산됩니다. 어플리케이션 코드로 설정하지 말아 주세요.

유저가 컨트롤에 입력할 수 있는 캐릭터세트를 나타냅니다. restrict property의 값이 null 인 경우는, 임의의 캐릭터를 입력할 수 있습니다. restrict property의 값이 empty의 string인 경우는, 어느 캐릭터도 입력할 수 없습니다. 이 property는 유저의 조작만을 제한합니다. 스크립트로 텍스트 필드에 입력하는 텍스트는 제한하지 않습니다. restrict property의 값이 캐릭터의 string인 경우는, 그 string내의 캐릭터만을 텍스트 필드에 입력할 수 있습니다.

string는 왼쪽에서 오른쪽에 스캔 됩니다. 하이픈 (-) 캐릭터를 사용해, 범위를 지정할 수 있습니다. string가 caret (^) 캐릭터로 시작되는 경우, 그 string에 포함되는 캐릭터를 제외해, 모든 캐릭터를 입력할 수 있습니다. string가 caret (^) 캐릭터 이외로 시작되는 경우는, 그 string에 포함되는 캐릭터만을 입력할 수 있습니다.

일부의 캐릭터는 restrict property로 사용하면 특수한 의미를 가지기 (위해)때문에, 리터럴 캐릭터의 -,^, 및 \ 을 지정하려면 , 엔기호를 사용할 필요가 있습니다. restrict property를 MXML 태그로 속성으로서 사용하는 경우는, 다음의 예와 같이, 단일의 엔기호를 사용합니다. \^\-\\. restrict 를 ActionScript 식으로 설정하는 경우, 다음의 예와 같이, 엔기호를 2 개 계속해 지정합니다. \\^\\-\\\.

디폴트치null.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

See also

현재의 선택 범위의 최초의 캐릭터를 나타내는 0 베이스의 인덱스치입니다. 최초의 캐릭터가 0, 2 번째의 캐릭터가 1 입니다 (이하 같이). 컨트롤이 포커스를 취득했을 때,selectionBeginIndex property와 selectionEndIndex property가 양쪽 모두 설정되어 있는 경우는 선택 범위가 표시됩니다.

디폴트치0.

현재의 선택 범위의 마지막 캐릭터의직후의 위치를 나타내는 0 베이스의 인덱스입니다. 즉, 마지막 캐릭터의 위치를 나타내는 1 베이스 인덱스와 같습니다. 예를 들어, 선택 범위의 마지막 캐릭터가 5 번째의 캐릭터였던 경우, 이 property의 값은 5 가 됩니다. 컨트롤이 포커스를 취득했을 때,selectionBeginIndex property와 selectionEndIndex property가 양쪽 모두 설정되어 있는 경우는 선택 범위가 표시됩니다.

디폴트치0.

컨트롤에 표시되는 plaintext입니다. 그 외관은, 이 Label 컨트롤의 CSS 스타일에 의해 결정됩니다.

텍스트 string내의 HTML 태그는 모두 무시되어 string에 입력했던 대로 표시됩니다. HTML 태그를 사용해 포맷 된 텍스트를 표시하려면 ,htmlText property를 사용합니다. htmlText property를 설정해 있는 경우는, 그 HTML 로, 설정된 텍스트를 옮겨놓을 수 있어text property는, HTML 텍스트로부터 HTML 태그를 제외한 plaintext를 돌려줍니다. 상세한 것에 대하여는, 「htmlText property」를 참조해 주세요.

특수 캐릭터인 왼쪽산괄호 (<), 우야마 괄호 (>), ampersand(&) (&)를 텍스트에 포함하는 경우는, CDATA 태그로 텍스트 string를 둘러쌀 필요가 있습니다. 특수 캐릭터 대신에,< 등의 HTML 캐릭터 엔티티를 사용할 수 있습니다.

이 property를 null 로 설정하려고 했을 경우는, 대신에 empty의 string로 설정됩니다. text property에는, 값 null 를 일시적으로 설정할 수 있습니다. 이것은,htmlText 가 최근 설정되어 대응하는 text 값가 아직 결정되어 있지 않은 것을 나타냅니다.

디폴트치"".

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

이 TextInput 의 텍스트를 표시하기 위한 내부 UITextField 입니다.

텍스트의 높이입니다.

textHeight property의 값은, 컴퍼넌트가 검증된 다음에만 올바른 값이 됩니다. text 를 설정해, 그 직후에 textHeight 를 취득했을 경우는, 잘못한 값을 받을 가능성이 있습니다. 컴퍼넌트가 검증될 때까지 기다리는지, 값을 취득하기 전에 validateNow() Methods를 호출합니다. 이 동작은, 값을 즉시 갱신하는 flash.text.TextField 컨트롤의 동작과는 다릅니다.

See also

텍스트의 폭입니다.

textWidth property의 값은, 컴퍼넌트가 검증된 다음에만 올바른 값이 됩니다. text 를 설정해, 그 직후에 textWidth 를 취득했을 경우는, 잘못한 값을 받을 가능성이 있습니다. 컴퍼넌트가 검증될 때까지 기다리는지, 값을 취득하기 전에 validateNow() Methods를 호출합니다. 이 동작은, 값을 즉시 갱신하는 flash.text.TextField 컨트롤의 동작과는 다릅니다.

See also

constructor　 　.

컨트롤내의 텍스트행의 텍스트의 위치와 측정에 관한 정보를 가지는 TextLineMetrics object를 돌려줍니다. 올바른 수치를 취득하려면 , 컴퍼넌트를 검증할 필요가 있습니다. text 또는 htmlText property를 설정해, 그 직후에 getLineMetrics() 를 호출했을 경우는, 잘못한 값을 받을 가능성이 있습니다. 컴퍼넌트가 검증될 때까지 기다리는지,validateNow() 를 호출합니다. 이 동작은, 값을 즉시 갱신하는 flash.text.TextField 클래스의 동작과는 다릅니다.

See also

Parameters로 지정된 범위의 텍스트를 선택합니다. 컨트롤이 포커스를 가지고 있지 않은 경우, 선택 범위는, 컨트롤이 포커스를 취득할 때까지는 하이라이트 표시되지 않습니다. 또, 컨트롤의 클릭에 의해 포커스가 취득되었을 경우, 지금까지의 모든 선택 범위는 없어집니다. 2 개의 Parameters가 동일한 경우, 새로운 선택 범위가 삽입 포인트입니다.

TextInput 컨트롤내의 텍스트가 유저로부터의 입력, 또는 데이터 바인딩에 의해 변화했을 때에 dispatch됩니다. ActionScript 코드를 사용해 텍스트를 변경했을 경우, 이 이벤트는 생성되지 않습니다.

change event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

data property가 변경되었을 때에 dispatch됩니다.

컴퍼넌트를 아이템 렌더러로서 사용하는 경우,data property는 표시하는 데이터를 보관 유지합니다. 이 이벤트를 받아,data property가 변경되었을 때에 컴퍼넌트를 갱신할 수가 있습니다.

FlexEvent.DATA_CHANGE 정수에 의해,dataChange 이벤트의 event object의 type property치가 정의됩니다.

event object의 각 property에는 다음의 값이 설정됩니다.

유저가 Enter 키를 눌렀을 때에 dispatch됩니다.

FlexEvent.ENTER 정수에 의해,enter 이벤트의 event object의 type property치가 정의됩니다.

event object의 각 property에는 다음의 값이 설정됩니다.

유저가 컨트롤에 대해서 텍스트의 입력, 삭제, 또는 붙혀넣기를 실행했을 때에 dispatch됩니다.

textInput event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.