javax.microedition.lcdui
Class TextField

java.lang.Object
  |
  +--javax.microedition.lcdui.Item
        |
        +--javax.microedition.lcdui.TextField

public class TextField

extends Item

TextField는 Form에 들어갈 수 있는 편집할 수 있는 텍스트 구성 요소입니다. 초기 값으로 사용되는 텍스트가 제공될 수 있습니다.

TextField는 객체에 언제든지 저장할 수 있는 문자의 최대 수(용량)를 나타내는 최대 크기를 가집니다. 이 제한은 TextField 인스턴스가 구성될 때 즉, 사용자가 TextField에서 텍스트를 편집하고 응용 프로그램이 내용을 수정하는 TextField의 메소드를 호출할 때 적용됩니다. 최대 크기는 최대 저장 용량이며 주어진 시간에 표시될 수 있는 문자 수와는 관계가 없습니다. 문자 수가 표시되고 행과 열에 배열되는 방법은 장치마다 다릅니다.

구현 시 최대 크기를 경계로 할 수 있으며 실제로 지정되는 최대 크기는 응용 프로그램이 요청한 크기보다 작을 수 있습니다. 지정된 실제 값은 getMaxSize()가 반환하는 값에 반영됩니다. 방어적으로 작성된 응용 프로그램은 이 값을 요청한 최대 크기와 비교하고 이 값이 서로 다를 경우를 처리할 수 있어야 합니다.

입력 제약 조건

TextField는 TextBox 클래스와 입력 제약 조건 개념을 공유합니다. 제약 조건이 서로 다르면 응용 프로그램은 사용자 입력을 여러 방법으로 제한하도록 요청할 수 있습니다. 구현 시에는 응용 프로그램이 요청한 대로 사용자 입력을 제한해야 합니다. 예를 들어, 응용 프로그램이 TextField에 NUMERIC 제약 조건을 요청하면 숫자만 입력할 수 있도록 구현해야 합니다.

텍스트 객체의 실제 내용은 TextBox 및 TextField API를 사용하여 설정 및 수정되고 응용 프로그램에 보고됩니다. 구현 시 텍스트 객체의 제약 조건 설정에 적합한 특수 포맷을 제공하는 경우에는 표시된 내용이 실제 내용과 다를 수 있습니다. 예를 들어, PHONENUMBER 필드는 숫자 구분자 및 구두점을 사용해서 숫자를 국가 코드, 지역 코드, 접미어 등으로 묶어 사용 중인 전화 번호 규칙에 적합하게 표시할 수 있습니다. 제공되는 모든 공백이나 구두점은 텍스트 객체의 실제 내용으로 간주되지 않습니다. 예를 들어, PHONENUMBER 제약 조건을 가진 텍스트 객체는 다음과 같이 표시될 수 있습니다.

     (408) 555-1212    

하지만 API를 통해 응용 프로그램에 제공되는 객체의 실제 내용은 "4085551212" 문자열입니다. size 메소드는 표시되는 문자 수가 아닌 실제 내용의 문자 수를 나타내기 때문에, 이 예에서 size 메소드는 10을 반환합니다.

DECIMAL과 같은 일부 제약 조건을 사용하면 구현 시 텍스트 객체 내용의 구문을 검증해야 합니다. 구문 검사는 텍스트 객체의 실제 내용에 대해 수행되며 이 실제 내용은 위에서 설명한 대로 표시된 내용과 다를 수 있습니다. 구문 검사는 구성자에 전달된 초기 내용에 대해 수행되며 텍스트 객체의 내용에 영향을 주는 모든 메소드 호출에도 강제 수행됩니다. 메소드 및 구성자가 필요한 구문을 충족시키지 못하는 텍스트 객체 내용을 만들면 IllegalArgumentException이 발생합니다.

setConstraints() 메소드에 전달된 값은 위에서 설명한 제한적 제약 조건과 텍스트 입력 및 표시를 수정하는 여러 플래그 비트로 구성되어 있습니다. 제한적 제약 조건 설정 값은 값의 하위 16비트 부분이며 비트 연산자 AND(&)로 제약 조건 값과 CONSTRAINT_MASK 상수를 결합하여 추출할 수 있습니다. 제한적 제약 조건 설정은 다음과 같습니다.

ANY
EMAILADDR
NUMERIC
PHONENUMBER
URL
DECIMAL


수정자 플래그는 제약 조건 값의 상위 16비트 부분 즉, CONSTRAINT_MASK 상수의 보수 부분에 있습니다. 수정자 플래그는 비트 AND (&) 연산자로 제약 조건 값을 수정자 플래그에 결합시켜 개별적으로 테스트될 수 있습니다. 수정자 플래그는 다음과 같습니다.

PASSWORD
UNEDITABLE
SENSITIVE
NON_PREDICTIVE
INITIAL_CAPS_WORD
INITIAL_CAPS_SENTENCE


입력 모드

TextField는 TextBox 클래스와 입력 모드 개념을 공유합니다. 응용 프로그램은 사용자가 TextField 또는 TextBox의 편집을 시작할 때 특정 입력 모드를 사용하도록 구현될 수 있습니다. 입력 모드는 특정 장치의 텍스트 입력용 사용자 인터페이스에 존재하는 개념입니다. 텍스트 입력용 사용자 인터페이스는 표준화되어 있지 않고 장치마다 다르기 때문에 응용 프로그램이 입력 모드를 직접 요청할 수는 없습니다. 대신 응용 프로그램은 특정 문자를 쉽게 입력할 수 있도록 요청할 수 있습니다. setInitialInputMode() 메소드에 유니코드 문자 하위 집합 이름을 전달하는 방법으로 이러한 작업을 요청할 수 있습니다. 이 메소드를 호출하면 구현 시 텍스트 입력 사용자 인터페이스 모드를 이 하위 집합에 포함되는 문자 입력을 쉽게 할 수 있도록 설정할 수 있습니다. 응용 프로그램은 수정자 플래그를 제약 조건 값으로 설정하여 입력 모드가 특정한 동작 특성을 가지도록 요청할 수도 있습니다.

요청된 입력 모드는 사용자가 TextBox 또는 TextField 객체의 편집을 시작할 때마다 사용되어야 합니다. 사용자가 이전 편집 세션에서 입력 모드를 변경한 경우 응용 프로그램이 요청한 입력 모드의 우선 순위가 사용자가 설정했던 이전 입력 모드의 우선 순위보다 높습니다. 하지만 입력 모드는 제한적이지 않으므로 사용자가 편집 중 언제든지 입력 모드를 변경할 수 있습니다. 편집이 이미 진행 중이면 setInitialInputMode 메소드에 대한 호출이 현재 입력 모드에는 영향을 주지 않고 대신 사용자가 다음 번에 이 텍스트 객체의 편집을 시작할 때 영향을 줍니다.

초기 입력 모드를 보면 구현에 대해 알 수 있습니다. 구현 시 응용 프로그램의 요청을 충족하는 입력 모드를 제공할 수 없는 경우에는 기본 입력 모드를 사용해야 합니다.

응용 프로그램이 요청하여 적용한 입력 모드는 사용자가 입력할 수 있는 문자 집합으로 제한되지 않습니다. 사용자는 입력 모드를 전환하여 현재 제약 조건 설정 내에서 허용되는 모든 문자를 입력할 수 있어야 합니다. 제약 조건 설정은 입력 모드 요청보다 우선 순위가 높으며 구현 시 현재 제약 조건 설정과 맞지 않을 경우 특정 입력 모드를 제공하지 않을 수 있습니다.

예를 들어, 현재 제약 조건이 ANY이면

    setInitialInputMode("MIDP_UPPERCASE_LATIN");    

호출은 초기 입력 모드가 라틴어 대문자 입력을 허용하도록 설정해야 합니다. 이로 인해 입력이 이러한 문자로 제한되는 것은 아니며 숫자 및 라틴어 소문자 입력을 허용하는 입력 모드로 전환하여 다른 문자를 입력할 수 있습니다. 하지만 현재 제약 조건이 NUMERIC이면 라틴어 대문자가 제약 조건이 NUMERIC인 TextField에 허용되지 않기 때문에 구현 시 초기 입력 모드가 MIDP_UPPERCASE_LATIN 문자를 허용하도록 설정하는 요청은 무시될 수 있습니다. 이 경우 숫자 입력을 허용하는 입력 모드가 NUMERIC 제약 조건 하에서의 데이터 입력에 가장 적합하기 때문에 구현 시 이 입력 모드를 대신 사용할 수 있습니다.

setInitialInputMode() 메소드에 매개 변수로 전달된 유니코드 문자 하위 집합 이름에는 문자열이 사용됩니다. 문자열 비교는 대소문자를 구분합니다.

유니코드 문자 블록의 이름은 J2SE 클래스 java.lang.Character.UnicodeBlock에 정의된 대로, 유니코드 문자 블록을 나타내는 필드의 문자열 이름에 "UCB_"라는 접두어를 추가하여 만듭니다. 유니코드 문자 블록의 이름은 모두 이런 형태로 지정합니다. 편의를 위해 가장 일반적인 유니코드 문자 블록을 아래에 나열합니다.

UCB_BASIC_LATIN
UCB_GREEK
UCB_CYRILLIC
UCB_ARMENIAN
UCB_HEBREW
UCB_ARABIC
UCB_DEVANAGARI
UCB_BENGALI
UCB_THAI
UCB_HIRAGANA
UCB_KATAKANA
UCB_HANGUL_SYLLABLES


"입력 하위 집합"은 J2SE 클래스 java.awt.im.InputSubset에 정의된 대로 이 클래스에 정의된 입력 하위 집합을 나타내는 필드의 문자열 이름에 "IS_"라는 접두어를 추가하여 만들 수 있습니다. 정의된 입력 하위 집합은 모두 사용할 수 있습니다. 편의를 위해 현재 정의된 입력 하위 집합의 이름을 다음에 나열합니다.

IS_FULLWIDTH_DIGITS
IS_FULLWIDTH_LATIN
IS_HALFWIDTH_KATAKANA
IS_HANJA
IS_KANJI
IS_LATIN
IS_LATIN_DIGITS
IS_SIMPLIFIED_HANZI
IS_TRADITIONAL_HANZI


MIDP에서는 다음과 같은 문자 하위 집합도 정의합니다.

MIDP_UPPERCASE_LATIN - 라틴어 대문자에 해당하는 IS_LATIN 하위 집합

MIDP_LOWERCASE_LATIN - 라틴어 소문자에 해당하는 IS_LATIN 하위 집합

마지막으로 구현별 문자 하위 집합의 이름은 "X_"라는 접두어를 붙인 문자열로 지정할 수 있습니다. 이름 공간의 충돌을 피하기 위해 구현별 이름에는 "X_" 접두어 다음에 회사나 조직을 정의하는 이름을 포함시키는 것이 좋습니다.

예를 들어, 일본어 응용 프로그램에는 일본어가 아닌 언어에서 "차용한" 단어를 입력할 때 주로 사용할 특별한 TextField가 있을 수 있습니다. 응용 프로그램은 다음 메소드를 호출하여 히라가나를 사용하는 입력 모드를 요청할 수 있습니다.

    textfield.setInitialInputMode("UCB_HIRAGANA");       

구현 노트

구현 시 위에 나열된 모든 문자열을 컴파일할 필요는 없습니다. 대신 지원하는 유니코드 문자 하위 집합의 이름을 지정하는 문자열만 컴파일하면 됩니다. 응용 프로그램이 전달한 하위 집합 이름이 알려진 하위 집합 이름과 일치하지 않으면 요청은 오류 없이 그냥 무시되고 기본 입력 모드가 사용되어야 합니다. 이렇게 하면 구현 시 이 기능을 간단하게 지원할 수 있습니다. 하지만 응용 프로그램에서는 요청이 수락되었는지 여부 및 요청한 유니코드 문자 하위 집합이 실제로 유효한 하위 집합인지 여부를 알 수 없습니다.

Since:

MIDP 1.0

Field Summary

static int	ANY 모든 텍스트를 입력할 수 있습니다.
static int	CONSTRAINT_MASK 제약 조건 모드를 결정하는 마스크 값.
static int	DECIMAL "-123", "0.123" 또는 ".5"와 같이 선택적 소수가 있는 숫자 값을 입력할 수 있습니다.
static int	EMAILADDR 전자 메일 주소를 입력할 수 있습니다.
static int	INITIAL_CAPS_SENTENCE 이 플래그를 보면 텍스트 편집 중 각 문장의 첫 번째 문자가 대문자여야 한다는 것을 알 수 있습니다.
static int	INITIAL_CAPS_WORD 이 플래그를 보면 텍스트 편집 중 각 단어의 첫 번째 문자가 대문자여야 한다는 것을 알 수 있습니다.
static int	NON_PREDICTIVE 입력된 텍스트가 일반적으로 예측 입력 계획에 사용되는, 사전에 없는 단어로 구성되어 있음을 표시합니다.
static int	NUMERIC 정수 값만 입력할 수 있습니다.
static int	PASSWORD 입력된 텍스트가 가능한 한 알아보기 힘들게 해야 하는 기밀 데이터임을 표시합니다.
static int	PHONENUMBER 전화 번호를 입력할 수 있습니다.
static int	SENSITIVE 입력된 텍스트가 구현 시 예측 가능하거나 자동 완성 또는 기타 빠른 입력 체계를 위해 내용을 사전이나 테이블에 저장하지 않아야 하는 중요한 데이터라는 것을 표시합니다.
static int	UNEDITABLE 현재 편집이 허용되지 않음을 표시합니다.
static int	URL URL을 입력할 수 있습니다.

Fields inherited from class javax.microedition.lcdui.Item

BUTTON, HYPERLINK, LAYOUT_2, LAYOUT_BOTTOM, LAYOUT_CENTER, LAYOUT_DEFAULT, LAYOUT_EXPAND, LAYOUT_LEFT, LAYOUT_NEWLINE_AFTER, LAYOUT_NEWLINE_BEFORE, LAYOUT_RIGHT, LAYOUT_SHRINK, LAYOUT_TOP, LAYOUT_VCENTER, LAYOUT_VEXPAND, LAYOUT_VSHRINK, PLAIN

Constructor Summary

TextField(String label, String text, int maxSize, int constraints)
주어진 레이블, 초기 내용, 최대 문자 수 및 제약 조건을 사용하여 새 TextField 객체를 만듭니다.

Method Summary

void	delete(int offset, int length) TextField에서 문자를 삭제합니다.
int	getCaretPosition() 현재 입력 위치를 가져옵니다.
int	getChars(char[] data) TextField의 내용을 색인 0에서 시작하는 문자 배열로 복사합니다.
int	getConstraints() TextField의 현재 입력 제약 조건을 가져옵니다.
int	getMaxSize() TextField에 저장될 수 있는 최대 크기(문자 수)를 반환합니다.
String	getString() 문자열 값으로 TextField의 내용을 가져옵니다.
void	insert(char[] data, int offset, int length, int position) 문자 배열의 하위 범위를 TextField의 내용에 삽입합니다.
void	insert(String src, int position) 문자열을 TextField의 내용에 삽입합니다.
void	setChars(char[] data, int offset, int length) 문자 배열로부터 TextField의 내용을 설정하여 이전 내용을 교체합니다.
void	setConstraints(int constraints) TextField의 입력 제약 조건을 설정합니다.
void	setInitialInputMode(String characterSubset) 사용자가 이 TextField의 편집을 시작할 때 사용되어야 할 입력 모드에 대한 힌트를 설정합니다.
int	setMaxSize(int maxSize) TextField 내에 포함될 수 있는 최대 크기(문자 수)를 설정합니다.
void	setString(String text) 문자열 값으로 TextField의 내용을 설정하여 이전 내용을 대체합니다.
int	size() 현재 TextField 내에 저장된 문자 수를 가져옵니다.

Methods inherited from class javax.microedition.lcdui.Item

addCommand, getLabel, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setDefaultCommand, setItemCommandListener, setLabel, setLayout, setPreferredSize

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ANY

public static final int ANY

모든 텍스트를 입력할 수 있습니다. 줄바꿈을 입력할 수 있습니다.

상수 0이 ANY에 할당됩니다.

See Also:

Constant Field Values

EMAILADDR

public static final int EMAILADDR

전자 메일 주소를 입력할 수 있습니다.

상수 1이 EMAILADDR에 할당됩니다.

See Also:

Constant Field Values

NUMERIC

public static final int NUMERIC

정수 값만 입력할 수 있습니다. 구현 시 내용을 비워 두거나 빼기 부호(선택적)와 하나 이상의 십진수 문자열로 구성되도록 제한해야 합니다. 값이 비어 있지 않으면 Integer.parseInt(String)을 사용하여 분석할 수 있습니다.

빼기 부호는 텍스트 객체 내의 공간을 사용합니다. 이 때문에 최대 크기가 1인 텍스트 객체에는 음수를 입력할 수 없습니다.

상수 2가 NUMERIC에 할당됩니다.

See Also:

Constant Field Values

PHONENUMBER

public static final int PHONENUMBER

전화 번호를 입력할 수 있습니다. 전화 기반 구현은 원래의 전화 걸기 응용 프로그램과 연결될 수 있기 때문에 전화 번호는 특수한 경우입니다. 구현 시 키 하나만 누르면 전화를 걸 수 있게 초기화된 전화 걸기 응용 프로그램을 자동으로 시작할 수 있습니다. 사용자 확인 없이 자동으로 통화가 되면 안 됩니다. 구현 시 장치의 전화 또는 주소 데이터베이스에 있는 전화 번호 조회 기능도 제공할 수 있습니다.

허용되는 정확한 문자 집합은 장치와 장치 네트워크마다 다르며 "+" 접두어 문자와 같은 숫자가 아닌 문자를 포함할 수 있습니다.

일부 플랫폼은 MIDlet.platformRequest 메소드를 사용하여 음성 통화를 시작하는 기능을 제공할 수 있습니다.

상수 3이 PHONENUMBER에 할당됩니다.

See Also:

Constant Field Values

URL

public static final int URL

URL을 입력할 수 있습니다.

상수 4가 URL에 할당됩니다.

See Also:

Constant Field Values

DECIMAL

public static final int DECIMAL

"-123", "0.123" 또는 ".5"와 같이 선택적 소수가 있는 숫자 값을 입력할 수 있습니다.

구현 시 장치에 사용되는 규칙에 따라 소수점 구분자로 마침표 "." 또는 쉼표 ","를 표시할 수 있습니다. 마찬가지로 구현 시 십진수 문자열의 일부인 자릿수 구분자에 공백이나 쉼표와 같이 장치별로 다른 문자를 표시할 수 있습니다. 하지만 텍스트 객체의 실제 내용에는 마침표 ".", 빼기 부호 "-" 및 십진수 문자만 허용됩니다.

DECIMAL 텍스트 객체의 실제 내용은 비어 있을 수 있습니다. 실제 내용이 비어 있지 않으면 Java 언어 사양 3.10.2 절에 정의되어 있는 FloatingPointLiteral 구문의 하위 집합을 충족해야 합니다. 이 하위 집합 구문의 실제 내용은 선택적 빼기 부호 "-", 하나 이상의 정수, 선택적 소수점 구분자, 0 이상의 소수 이하 숫자의 순으로 구성되어야 합니다. 소수점 구분자와 하나 이상의 소수 이하 숫자가 있을 경우 정수 부분 십진수는 생략할 수 있습니다.

위에 정의된 구문은 또한 응용 프로그램이 구성자나 메소드를 호출하여 텍스트 객체의 내용을 설정 또는 수정할 때마다 무조건 적용됩니다.

이 문자열 값을 계산에 적합한 숫자 값으로 분석하는 것은 응용 프로그램이 할 일입니다. 내용이 비어 있지 않으면 런타임 환경에 있을 경우 Double.valueOf 및 관련 메소드가 결과를 분석할 수 있습니다.

부호 및 소수점 구분자는 텍스트 객체 내의 공간을 사용합니다. 응용 프로그램이 텍스트 객체에 최대 크기를 할당할 때에는 이러한 특성을 고려해야 합니다.

상수 5가 DECIMAL에 할당됩니다.

Since:

MIDP 2.0

See Also:

Constant Field Values

PASSWORD

public static final int PASSWORD

입력된 텍스트가 가능한 한 알아보기 힘들게 해야 하는 기밀 데이터임을 표시합니다. 사용자가 데이터를 입력하는 동안에는 내용이 보일 수 있습니다. 하지만 사용자는 내용을 알아볼 수 없어야 합니다. 특히 사용자가 내용을 편집할 때 기존 내용이 보이지 않아야 합니다. 내용을 알아보기 힘들게 만드는 방법은 구현에 따라 달라집니다. 예를 들어, 데이터의 각 문자를 "*" 문자로 마스킹할 수 있습니다. 암호나 개인 식별 번호(PIN)와 같은 기밀 정보 입력에는 PASSWORD 수정자가 유용합니다.

PASSWORD 필드에 입력된 데이터는 구현 시 예측 가능하거나 자동 완성 또는 기타 빠른 입력 체계를 위해 내용을 사전이나 테이블에 저장하지 않아야 한다는 점에서 SENSITIVE와 유사하게 처리됩니다. PASSWORD 비트가 제약 조건 값으로 설정되어 있으면 실제 값과 관계 없이 SENSITIVE 및 NON_PREDICTIVE 비트도 설정되어 있다고 간주됩니다. 또한 INITIAL_CAPS_WORD 및 INITIAL_CAPS_SENTENCE 플래그 비트는 설정되어 있더라도 무시되어야 합니다.

PASSWORD 수정자는 비트 OR 연산자(|)를 사용하여 다른 입력 제약 조건과 결합될 수 있습니다. PASSWORD 수정자는 EMAILADDR, PHONENUMBER 및 URL과 같은 일부 제약 조건 값에는 유용하지 않습니다. 하지만 이러한 결합도 가능하기 때문에 이런 제약 조건이 지정되어도 예외가 발생하지는 않습니다.

상수 0x10000이 PASSWORD에 할당됩니다.

See Also:

Constant Field Values

UNEDITABLE

public static final int UNEDITABLE

현재 편집이 허용되지 않음을 표시합니다. 이 플래그가 설정되면 구현 시 이 객체의 텍스트 내용을 변경하지 못하게 해야 합니다. 구현 시 객체 텍스트가 편집될 수 없다는 시각적 표시도 제공해야 합니다. 이 플래그는 이 텍스트 객체가 잠재적으로 편집 가능하며 응용 프로그램에서 이 플래그를 지워 사용자가 내용을 편집하는 경우도 있다는 것을 보여 줍니다.

UNEDITABLE 수정자는 비트 OR 연산자(|)를 사용하여 다른 입력 제약 조건과 결합될 수 있습니다.

상수 0x20000이 UNEDITABLE에 할당됩니다.

Since:

MIDP 2.0

See Also:

Constant Field Values

SENSITIVE

public static final int SENSITIVE

입력된 텍스트가 구현 시 예측 가능하거나 자동 완성 또는 기타 빠른 입력 체계를 위해 내용을 사전이나 테이블에 저장하지 않아야 하는 중요한 데이터라는 것을 표시합니다. 신용 카드 번호 등이 이러한 데이터의 예가 될 수 있습니다.

SENSITIVE 수정자는 비트 OR 연산자(|)를 사용하여 다른 입력 제약 조건과 결합될 수 있습니다.

상수 0x40000이 SENSITIVE에 할당됩니다.

Since:

MIDP 2.0

See Also:

Constant Field Values

NON_PREDICTIVE

public static final int NON_PREDICTIVE

입력된 텍스트가 일반적으로 예측 입력 계획에 사용되는, 사전에 없는 단어로 구성되어 있음을 표시합니다. 이 비트를 지우면 구현 시 예측 입력 기능을 사용할 수 있습니다(필수는 아님). 이 비트를 설정하면 구현 시 예측 입력 기능을 사용하지 않고 한 문자씩 텍스트를 입력해야 합니다.

NON_PREDICTIVE 수정자는 비트 OR 연산자(|)를 사용하여 다른 입력 제약 조건과 결합될 수 있습니다.

상수 0x80000이 NON_PREDICTIVE에 할당됩니다.

Since:

MIDP 2.0

See Also:

Constant Field Values

INITIAL_CAPS_WORD

public static final int INITIAL_CAPS_WORD

이 플래그를 보면 텍스트 편집 중 각 단어의 첫 번째 문자가 대문자여야 한다는 것을 알 수 있습니다. 이 힌트는 자동 대문자화에 적합한 장치에서만 의미가 있고 편집되는 텍스트의 문자 집합이 대문자와 소문자를 모두 가지고 있을 때에만 사용해야 합니다. 단어 경계 정의는 구현별로 달라집니다.

응용 프로그램이 INITIAL_CAPS_WORD 및 INITIAL_CAPS_SENTENCE 플래그를 모두 지정한 경우에는 INITIAL_CAPS_WORD 동작이 사용되어야 합니다.

INITIAL_CAPS_WORD 수정자는 비트 OR 연산자(|)를 사용하여 다른 입력 제약 조건과 결합될 수 있습니다.

상수 0x100000이 INITIAL_CAPS_WORD에 할당됩니다.

Since:

MIDP 2.0

See Also:

Constant Field Values

INITIAL_CAPS_SENTENCE

public static final int INITIAL_CAPS_SENTENCE

이 플래그를 보면 텍스트 편집 중 각 문장의 첫 번째 문자가 대문자여야 한다는 것을 알 수 있습니다. 이 힌트는 자동 대문자화에 적합한 장치에서만 의미가 있고 편집되는 텍스트의 문자 집합이 대문자와 소문자를 모두 가지고 있을 때에만 사용해야 합니다. 문장 경계 정의는 구현별로 달라집니다.

응용 프로그램이 INITIAL_CAPS_WORD 및 INITIAL_CAPS_SENTENCE 플래그를 모두 지정한 경우에는 INITIAL_CAPS_WORD 동작이 사용되어야 합니다.

INITIAL_CAPS_SENTENCE 수정자는 비트 OR 연산자(|)를 사용하여 다른 입력 제약 조건과 결합될 수 있습니다.

상수 0x200000이 INITIAL_CAPS_SENTENCE에 할당됩니다.

Since:

MIDP 2.0

See Also:

Constant Field Values

CONSTRAINT_MASK

public static final int CONSTRAINT_MASK

제약 조건 모드를 결정하는 마스크 값. 응용 프로그램이 PASSWORD 플래그와 같은 수정자 플래그를 제거하려면 현재 제약 조건 모드를 검색하기 위해 getConstraints()가 반환한 값과 CONSTRAINT_MASK 간에 비트 AND 연산을 사용해야 합니다.

상수 0xFFFF가 CONSTRAINT_MASK에 할당됩니다.

See Also:

Constant Field Values

Constructor Detail

TextField

public TextField(String label,
                 String text,
                 int maxSize,
                 int constraints)

주어진 레이블, 초기 내용, 최대 문자 수 및 제약 조건을 사용하여 새 TextField 객체를 만듭니다. 텍스트 매개 변수가 null이면 빈 TextField가 작성됩니다. maxSize 매개 변수는 0보다 커야 합니다. 초기 내용 문자열의 길이가 maxSize를 초과하면 IllegalArgumentException이 발생합니다. 하지만 구현 시 응용 프로그램이 요청한 것보다 작은 최대 크기를 할당할 수 있습니다. 이런 경우 내용의 길이가 새로 할당된 최대 크기를 초과하면 여기에 맞추기 위해 내용의 끝부분이 잘리고 예외가 발생하지 않습니다.

Parameters:

label - 항목 레이블

text - 초기 내용 또는 TextField가 비어 있는 경우에는 null

maxSize - 최대 용량(문자 수)

constraints - 입력 제약 조건을 참조하십시오.

Throws:

IllegalArgumentException - maxSize가 0 이하일 때

IllegalArgumentException - 제약 조건 매개 변수의 값이 유효하지 않을 경우

IllegalArgumentException - text가 지정된 제약 조건에 적합하지 않을 경우

IllegalArgumentException - 문자열의 길이가 요청된 최대 용량을 초과할 경우

Method Detail

getString

public String getString()

문자열 값으로 TextField의 내용을 가져옵니다.

Returns:

현재 내용

See Also:

setString(java.lang.String)

setString

public void setString(String text)

문자열 값으로 TextField의 내용을 설정하여 이전 내용을 대체합니다.

Parameters:

text - TextField의 새 값 또는 TextField가 비어 있는 경우에는 null

Throws:

IllegalArgumentException - text가 현재의 입력 제약 조건에 적합하지 않을 경우

IllegalArgumentException - 텍스트가 현재 최대 용량을 초과하는 경우

See Also:

getString()

getChars

public int getChars(char[] data)

TextField의 내용을 색인 0에서 시작하는 문자 배열로 복사합니다. 복사된 문자 뒤에 있는 배열 요소는 변경되지 않습니다.

Parameters:

data - 값을 받을 문자 배열

Returns:

복사된 문자 수

Throws:

ArrayIndexOutOfBoundsException - 배열이 내용에 비해 너무 짧을 경우

NullPointerException - data가 null인 경우

See Also:

setChars(char[], int, int)

setChars

public void setChars(char[] data,
                     int offset,
                     int length)

문자 배열로부터 TextField의 내용을 설정하여 이전 내용을 교체합니다. 배열 색인 offset에서 시작하여 length 문자만큼의 data 배열 영역에서 문자가 복사됩니다. 데이터 배열이 null이면 TextField는 공백으로 설정되고 다른 매개 변수는 무시됩니다.

offset 및 length 매개 변수는 문자 배열 data 내의 유효한 문자 범위를 지정해야 합니다. offset 매개 변수는 [0..(data.length)] 범위(포함)에 있어야 합니다. length 매개 변수는 음수가 아닌 정수여야 하며, 여기서 (offset + length) <= data.length입니다.

Parameters:

data - 문자 데이터 소스

offset - 복사할 문자 영역의 시작 부분

length - 복사할 문자 수

Throws:

ArrayIndexOutOfBoundsException - offset과 length는 데이터 배열 내의 유효한 범위를 지정하지 않습니다.

IllegalArgumentException - data가 현재의 입력 제약 조건에 적합하지 않을 경우

IllegalArgumentException - 텍스트가 현재 최대 용량을 초과하는 경우

See Also:

getChars(char[])

insert

public void insert(String src,
                   int position)

문자열을 TextField의 내용에 삽입합니다. 문자열은 position 매개 변수가 나타내는 문자의 바로 앞에 삽입되며, 여기서 0은 TextField 내용의 첫 문자를 지정합니다. position이 0 이하인 경우에는 내용의 시작 부분에 삽입되어 앞에 덧붙이는 결과가 됩니다. position이 내용의 현재 크기 이상인 경우에는 내용의 맨 뒤에 삽입되어 뒤에 추가하는 결과가 됩니다. 예를 들어, text.insert(s, text.size())는 문자열 s를 항상 현재 내용의 뒤에 추가합니다.

내용의 현재 크기는 삽입된 문자 수만큼 증가됩니다. 결과 문자열은 현재 최대 용량 이내로 맞춰져야 합니다.

응용 프로그램은 getCaretPosition() 메소드를 사용하여 현재 삽입 지점("캐럿")의 위치를 결정할 수 있는 문자 입력을 시뮬레이션해야 합니다. 예를 들어, text.insert(s, text.getCaretPosition())은 현재 캐럿 위치에 s 문자열을 삽입합니다.

Parameters:

src - 삽입될 String

position - 삽입이 발생하는 위치

Throws:

IllegalArgumentException - 결과 내용이 현재의 입력 제약 조건에 유효하지 않은 경우

IllegalArgumentException - 삽입 시 현재 최대 용량을 초과하는 경우

NullPointerException - src가 null인 경우

insert

public void insert(char[] data,
                   int offset,
                   int length,
                   int position)

문자 배열의 하위 범위를 TextField의 내용에 삽입합니다. offset 및 length 매개 변수는 삽입에 사용될 데이터 배열의 하위 범위를 나타냅니다. 그 이외의 동작은 insert(String, int)와 동일합니다.

offset 및 length 매개 변수는 문자 배열 data 내의 유효한 문자 범위를 지정해야 합니다. offset 매개 변수는 [0..(data.length)] 범위(포함)에 있어야 합니다. length 매개 변수는 음수가 아닌 정수여야 하며, 여기서 (offset + length) <= data.length입니다.

Parameters:

data - 문자 데이터 소스

offset - 복사할 문자 영역의 시작 부분

length - 복사할 문자 수

position - 삽입이 발생하는 위치

Throws:

ArrayIndexOutOfBoundsException - offset과 length는 data 배열 내의 유효한 범위를 지정하지 않습니다.

IllegalArgumentException - 결과 내용이 현재의 입력 제약 조건에 유효하지 않은 경우

IllegalArgumentException - 삽입 시 현재 최대 용량을 초과하는 경우

NullPointerException - data가 null인 경우

delete

public void delete(int offset,
                   int length)

TextField에서 문자를 삭제합니다.

offset 및 length 매개 변수는 TextField 내용 내의 유효한 문자 범위를 지정해야 합니다. offset 매개 변수는 [0..(size())] 범위(포함)에 있어야 합니다. length 매개 변수는 음수가 아닌 정수여야 하며, 여기서 (offset + length) <= data.length입니다.

Parameters:

offset - 삭제되는 범위의 시작 부분

length - 삭제되는 문자 수

Throws:

IllegalArgumentException - 결과 내용이 현재의 입력 제약 조건에 유효하지 않은 경우

StringIndexOutOfBoundsException - offset과 length가 TextField 내용 내의 유효한 범위를 지정하지 않는 경우

getMaxSize

public int getMaxSize()

TextField에 저장될 수 있는 최대 크기(문자 수)를 반환합니다.

Returns:

최대 문자 크기

See Also:

setMaxSize(int)

setMaxSize

public int setMaxSize(int maxSize)

TextField 내에 포함될 수 있는 최대 크기(문자 수)를 설정합니다. TextField의 현재 내용이 maxSize보다 크면 내용이 여기에 맞게 잘립니다.

Parameters:

maxSize - 새 최대 크기

Returns:

할당된 최대 용량(요청된 것보다 작을 수 있음)

Throws:

IllegalArgumentException - maxSize가 0 이하인 경우

IllegalArgumentException - 잘려진 후 내용이 현재의 입력 제약 조건에 유효하지 않은 경우

See Also:

getMaxSize()

size

public int size()

현재 TextField 내에 저장된 문자 수를 가져옵니다.

Returns:

TextField의 문자 수

getCaretPosition

public int getCaretPosition()

현재 입력 위치를 가져옵니다. 일부 UI는 차단되어 사용자에게 필요한 캐럿 위치를 요청할 수도 있고, 단순히 현재 캐럿 위치를 반환할 수도 있습니다.

Returns:

현재 캐럿 위치. 시작 부분이면 0

setConstraints

public void setConstraints(int constraints)

TextField의 입력 제약 조건을 설정합니다. TextField의 현재 내용이 새 constraints와 일치하지 않으면 내용이 공백으로 설정됩니다.

Parameters:

constraints - 입력 제약 조건을 참조하십시오.

Throws:

IllegalArgumentException - 제약 조건이 입력 제약 조건에 지정된 제약 조건 중 하나가 아닌 경우

See Also:

getConstraints()

getConstraints

public int getConstraints()

TextField의 현재 입력 제약 조건을 가져옵니다.

Returns:

현재 제약 조건 값(입력 제약 조건 참조)

See Also:

setConstraints(int)

setInitialInputMode

public void setInitialInputMode(String characterSubset)

사용자가 이 TextField의 편집을 시작할 때 사용되어야 할 입력 모드에 대한 힌트를 설정합니다. characterSubset 매개 변수는 구현 시 초기 입력 모드를 선택할 때 사용되는 유니코드 문자 하위 집합의 이름입니다. null이 전달되면 구현 시 기본 입력 모드를 선택해야 합니다.

입력 모드의 전체적인 설명은 입력 모드를 참조하십시오.

Parameters:

characterSubset - 유니코드 문자 하위 집합의 이름인 문자열 또는 null

Since:

MIDP 2.0