Class TextBox

package javax.microedition.lcdui

java.lang.Object
  |
  +--javax.microedition.lcdui.Displayable
        |
        +--javax.microedition.lcdui.Screen
              |
              +--javax.microedition.lcdui.TextBox

설명

extends Screen:

TextBox 클래스는 사용자가 텍스트를 입력하고 편집할 수 있는 Screen입니다.

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

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

TextBox에 포함된 텍스트는 한 번에 표시하기에 너무 많을 수도 있습니다. 이런 경우에는 구현 시 사용자 스크롤을 허용하여 텍스트의 모든 부분을 보고 편집할 수 있도록 합니다. 이 스크롤 작업은 응용 프로그램에 투명하게 발생합니다.

제약 조건이 TextField.ANY로 설정된 경우 텍스트는 줄 바꿈을 포함할 수 있습니다. 이에 따라 텍스트 표시가 줄 바꿈되고 사용자는 줄 바꿈 문자를 입력할 수 있어야 합니다.

TextBox에는 TextField와 동일한 입력 제약 조건 개념이 있습니다. TextBox 클래스에서 메소드의 constraints 매개 변수는 TextField 클래스에 정의된 상수를 사용합니다. 이러한 상수에 대한 정의는 TextField 클래스에서 입력 제약 조건의 설명을 참조하십시오. TextBox에는 실제 내용, 표시된 내용 등 TextField와 같은 개념이 동일한 섹션에 설명되어 있습니다.

TextBox에는 또한 TextField와 동일한 입력 모드 개념이 있습니다. 자세한 내용은 TextField 클래스에 있는 입력 모드의 설명을 참조하십시오.

Since:

• MIDP 1.0

생성자 요약

• TextBox ( String title, String text, int maxSize, int constraints) 주어진 제목 문자열, 초기 내용, 최대 문자 수 및 제약 조건을 사용하여 새 TextBox 객체를 만듭니다.

메서드 요약

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

생성자 상세

TextBox

public TextBox(String title,
               String text,
               int maxSize,
               int constraints)

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

Parameters:

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

Throws:

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

getString

public String getString()

Returns:

• 현재 내용

See Also:

• setString(java.lang.String)

setString

public void setString(String text)

Parameters:

• text - TextBox의 새 값 또는 TextBox가 비어 있는 경우 null

Throws:

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

See Also:

• getString()

getChars

public int getChars(char[] data)

Parameters:

• data - 값을 받을 문자 배열

Returns:

• 복사된 문자 수

Throws:

• NullPointerException - data가 null인 경우

See Also:

• setChars(char[], int, int)

setChars

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

Parameters:

• length - 복사할 문자 수

Throws:

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

See Also:

• getChars(char[])

insert

public void insert(String src,
                   int position)

Parameters:

• position - 삽입이 발생하는 위치

Throws:

• NullPointerException - src가 null인 경우

insert

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

Parameters:

• position - 삽입이 발생하는 위치

Throws:

• NullPointerException - data가 null인 경우

delete

public void delete(int offset,
                   int length)

Parameters:

• length - 삭제되는 문자 수

Throws:

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

getMaxSize

public int getMaxSize()

Returns:

• 최대 문자 크기

See Also:

• setMaxSize(int)

setMaxSize

public int setMaxSize(int maxSize)

Parameters:

• maxSize - 새 최대 크기

Returns:

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

Throws:

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

See Also:

• getMaxSize()

size

public int size()

Returns:

• 문자 수

getCaretPosition

public int getCaretPosition()

Returns:

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

setConstraints

public void setConstraints(int constraints)

Parameters:

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

Throws:

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

See Also:

• getConstraints()

getConstraints

public int getConstraints()

Returns:

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

See Also:

• setConstraints(int)

setInitialInputMode

public void setInitialInputMode(String characterSubset)

Parameters:

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

Since:

• MIDP 2.0

메서드 상세

getString

public String getString()

Returns:

• 현재 내용

See Also:

• setString(java.lang.String)

setString

public void setString(String text)

Parameters:

• text - TextBox의 새 값 또는 TextBox가 비어 있는 경우 null

Throws:

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

See Also:

• getString()

getChars

public int getChars(char[] data)

Parameters:

• data - 값을 받을 문자 배열

Returns:

• 복사된 문자 수

Throws:

• NullPointerException - data가 null인 경우

See Also:

• setChars(char[], int, int)

setChars

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

Parameters:

• length - 복사할 문자 수

Throws:

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

See Also:

• getChars(char[])

insert

public void insert(String src,
                   int position)

Parameters:

• position - 삽입이 발생하는 위치

Throws:

• NullPointerException - src가 null인 경우

insert

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

Parameters:

• position - 삽입이 발생하는 위치

Throws:

• NullPointerException - data가 null인 경우

delete

public void delete(int offset,
                   int length)

Parameters:

• length - 삭제되는 문자 수

Throws:

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

getMaxSize

public int getMaxSize()

Returns:

• 최대 문자 크기

See Also:

• setMaxSize(int)

setMaxSize

public int setMaxSize(int maxSize)

Parameters:

• maxSize - 새 최대 크기

Returns:

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

Throws:

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

See Also:

• getMaxSize()

size

public int size()

Returns:

• 문자 수

getCaretPosition

public int getCaretPosition()

Returns:

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

setConstraints

public void setConstraints(int constraints)

Parameters:

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

Throws:

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

See Also:

• getConstraints()

getConstraints

public int getConstraints()

Returns:

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

See Also:

• setConstraints(int)

setInitialInputMode

public void setInitialInputMode(String characterSubset)

Parameters:

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

Since:

• MIDP 2.0