javax.microedition.lcdui
Class Font

java.lang.Object
  |
  +--javax.microedition.lcdui.Font

public final class Font

extends Object

Font 클래스는 글꼴 및 글꼴 메트릭을 나타냅니다. Font는 응용 프로그램에서 만들 수 없습니다. 대신 응용 프로그램은 글꼴 속성을 기반으로 글꼴을 쿼리하며 시스템은 가능하면 요청한 속성과 일치하는 글꼴을 제공하려고 시도합니다.

Font의 속성은 스타일, 크기 및 서체입니다. 속성 값은 심볼릭 상수를 기준으로 지정해야 합니다. 스타일 속성 값은 비트 방식 OR 연산자를 사용하여 결합될 수 있지만 다른 속성의 값은 결합되지 않을 수 있습니다. 예를 들어, 다음 값

STYLE_BOLD | STYLE_ITALIC 은

굵은 기울임체 글꼴을 지정하는 데 사용할 수 있지만 다음 값

SIZE_LARGE | SIZE_SMALL 은

유효하지 않습니다.

이러한 상수 값은 각 속성에 대해 0이 유효하도록 정렬되며 시스템에 적합한 기본 글꼴을 지정하는 데 사용할 수 있습니다. 정확한 프로그래밍을 위해 다음 심볼릭 상수가 제공되며 값은 0으로 정의됩니다.

• STYLE_PLAIN
• SIZE_MEDIUM
• FACE_SYSTEM

다른 속성 값의 경우 실수로 이 속성을 잘못 사용하면(예: 스타일이 필요한 곳에 FACE_PROPORTIONAL 사용) 오류를 발생시키기 위해 분리된 비트 패턴을 가지도록 정렬됩니다. 하지만 다양한 속성 값은 서로 결합되지는 않습니다.

Since:

MIDP 1.0

Field Summary

static int	FACE_MONOSPACE "고정 폭" 글꼴.
static int	FACE_PROPORTIONAL "비례" 글꼴.
static int	FACE_SYSTEM "시스템" 글꼴.
static int	FONT_INPUT_TEXT 사용자가 텍스트 입력을 그리기 위해 구현 시 사용하는 글꼴 지정자.
static int	FONT_STATIC_TEXT 항목 및 화면 내용을 그리기 위해 사용된 기본 글꼴 지정자.
static int	SIZE_LARGE "큰" 시스템 종속 글꼴 크기.
static int	SIZE_MEDIUM "중간" 시스템 종속 글꼴 크기.
static int	SIZE_SMALL "작은" 시스템 종속 글꼴 크기.
static int	STYLE_BOLD 굵은체 스타일 상수.
static int	STYLE_ITALIC 기울임꼴 스타일 상수.
static int	STYLE_PLAIN 일반 스타일 상수.
static int	STYLE_UNDERLINED 밑줄 스타일 상수.

Method Summary

int	charsWidth(char[] ch, int offset, int length) 지정한 오프셋에서 시작하여 지정한 문자 수(길이)로 ch의 문자 진행 폭을 반환합니다.
int	charWidth(char ch) 이 글꼴로 지정된 문자의 진행 폭을 가져옵니다.
int	getBaselinePosition() 텍스트의 맨 위에서 텍스트 기준선까지의 거리(픽셀 단위)를 가져옵니다.
static Font	getDefaultFont() 시스템의 기본 글꼴을 가져옵니다.
int	getFace() 글꼴의 서체를 가져옵니다.
static Font	getFont(int fontSpecifier) 전달된 fontSpecifier에 높은 수준의 사용자 인터페이스에서 사용하는 Font를 가져옵니다.
static Font	getFont(int face, int style, int size) 지정한 서체, 스타일 및 크기를 갖는 글꼴을 나타내는 객체를 가져옵니다.
int	getHeight() 이 글꼴인 텍스트 행의 표준 높이를 가져옵니다.
int	getSize() 글꼴의 크기를 가져옵니다.
int	getStyle() 글꼴의 스타일을 가져옵니다.
boolean	isBold() 굵은체 글꼴인 경우 true를 반환합니다.
boolean	isItalic() 기울임꼴 글꼴인 경우 true를 반환합니다.
boolean	isPlain() 일반 글꼴인 경우 true를 반환합니다.
boolean	isUnderlined() 밑줄 그어진 글꼴인 경우 true를 반환합니다.
int	stringWidth(String str) 이 Font로 지정한 String을 표시하기 위해 전체 진행 폭을 가져옵니다.
int	substringWidth(String str, int offset, int len) 이 Font로 지정한 하위 문자열을 표시하기 위해 전체 진행 폭을 가져옵니다.

Methods inherited from class java.lang.Object

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

Field Detail

STYLE_PLAIN

public static final int STYLE_PLAIN

일반 스타일 상수. 혼합 스타일을 위해 다른 스타일 상수와 결합할 수 있습니다.

값 0이 STYLE_PLAIN에 할당됩니다.

See Also:

Constant Field Values

STYLE_BOLD

public static final int STYLE_BOLD

굵은체 스타일 상수. 혼합 스타일을 위해 다른 스타일 상수와 결합할 수 있습니다.

값 1이 STYLE_BOLD에 할당됩니다.

See Also:

Constant Field Values

STYLE_ITALIC

public static final int STYLE_ITALIC

기울임꼴 스타일 상수. 혼합 스타일을 위해 다른 스타일 상수와 결합할 수 있습니다.

값 2가 STYLE_ITALIC에 할당됩니다.

See Also:

Constant Field Values

STYLE_UNDERLINED

public static final int STYLE_UNDERLINED

밑줄 스타일 상수. 혼합 스타일을 위해 다른 스타일 상수와 결합할 수 있습니다.

값 4가 STYLE_UNDERLINED에 할당됩니다.

See Also:

Constant Field Values

SIZE_SMALL

public static final int SIZE_SMALL

"작은" 시스템 종속 글꼴 크기.

값 8이 STYLE_SMALL에 할당됩니다.

See Also:

Constant Field Values

SIZE_MEDIUM

public static final int SIZE_MEDIUM

"중간" 시스템 종속 글꼴 크기.

값 0이 STYLE_MEDIUM에 할당됩니다.

See Also:

Constant Field Values

SIZE_LARGE

public static final int SIZE_LARGE

"큰" 시스템 종속 글꼴 크기.

값 16이 SIZE_LARGE에 할당됩니다.

See Also:

Constant Field Values

FACE_SYSTEM

public static final int FACE_SYSTEM

"시스템" 글꼴.

값 0이 FACE_SYSTEM에 할당됩니다.

See Also:

Constant Field Values

FACE_MONOSPACE

public static final int FACE_MONOSPACE

"고정 폭" 글꼴.

값 32가 FACE_MONOSPACE에 할당됩니다.

See Also:

Constant Field Values

FACE_PROPORTIONAL

public static final int FACE_PROPORTIONAL

"비례" 글꼴.

값 64가 FACE_PROPORTIONAL에 할당됩니다.

See Also:

Constant Field Values

FONT_STATIC_TEXT

public static final int FONT_STATIC_TEXT

항목 및 화면 내용을 그리기 위해 사용된 기본 글꼴 지정자. FONT_STATIC_TEXT의 값은 0입니다.

Since:

MIDP 2.0

See Also:

getFont(int fontSpecifier), Constant Field Values

FONT_INPUT_TEXT

public static final int FONT_INPUT_TEXT

사용자가 텍스트 입력을 그리기 위해 구현 시 사용하는 글꼴 지정자. FONT_INPUT_TEXT의 값은 1입니다.

Since:

MIDP 2.0

See Also:

getFont(int fontSpecifier), Constant Field Values

Method Detail

getFont

public static Font getFont(int fontSpecifier)

전달된 fontSpecifier에 높은 수준의 사용자 인터페이스에서 사용하는 Font를 가져옵니다. 이는 장치의 사용자 인터페이스와 일치하기 위해 CustomItem과 Canvas의 서브 클래스에서 사용해야 합니다.

Parameters:

fontSpecifier - FONT_INPUT_TEXT나 FONT_STATIC_TEXT 중 하나

Returns:

글꼴 지정자에 전달된 글꼴

Throws:

IllegalArgumentException - fontSpecifier가 유효한 fontSpecifier가 아닌 경우

Since:

MIDP 2.0

getDefaultFont

public static Font getDefaultFont()

시스템의 기본 글꼴을 가져옵니다.

Returns:

기본 글꼴

getFont

public static Font getFont(int face,
                           int style,
                           int size)

지정한 서체, 스타일 및 크기를 갖는 글꼴을 나타내는 객체를 가져옵니다. 일치하는 글꼴이 없는 경우 시스템은 가장 근접하게 일치하는 내용을 제공하려고 시도합니다. 요청에 근접하게 일치하는 내용이 아니더라도 이 메소드는 항상 유효한 글꼴 객체를 반환합니다.

Parameters:

face - FACE_SYSTEM이나 FACE_MONOSPACE, FACE_PROPORTIONAL 중 하나

style - STYLE_PLAIN이거나 STYLE_BOLD, STYLE_ITALIC 및 STYLE_UNDERLINED의 조합

size - SIZE_SMALL이나 SIZE_MEDIUM, SIZE_LARGE 중 하나

Returns:

검색된 가장 근접한 글꼴 인스턴스

Throws:

IllegalArgumentException - face, style 또는 size가 유효한 값이 아닌 경우

getStyle

public int getStyle()

글꼴의 스타일을 가져옵니다. 값은 OR로 연결된 STYLE_BOLD, STYLE_ITALIC 및 STYLE_UNDERLINED의 조합이거나 0(STYLE_PLAIN)입니다.

Returns:

현재 글꼴 스타일

See Also:

isPlain(), isBold(), isItalic()

getSize

public int getSize()

글꼴의 크기를 가져옵니다.

Returns:

SIZE_SMALL이나 SIZE_MEDIUM, SIZE_LARGE 중 하나

getFace

public int getFace()

글꼴의 서체를 가져옵니다.

Returns:

FACE_SYSTEM이나 FACE_PROPORTIONAL, FACE_MONOSPACE 중 하나

isPlain

public boolean isPlain()

일반 글꼴인 경우 true를 반환합니다.

Returns:

일반 글꼴인 경우 true

See Also:

getStyle()

isBold

public boolean isBold()

굵은체 글꼴인 경우 true를 반환합니다.

Returns:

굵은체 글꼴인 경우 true

See Also:

getStyle()

isItalic

public boolean isItalic()

기울임꼴 글꼴인 경우 true를 반환합니다.

Returns:

기울임꼴 글꼴인 경우 true

See Also:

getStyle()

isUnderlined

public boolean isUnderlined()

밑줄 그어진 글꼴인 경우 true를 반환합니다.

Returns:

밑줄 그어진 글꼴인 경우 true

See Also:

getStyle()

getHeight

public int getHeight()

이 글꼴인 텍스트 행의 표준 높이를 가져옵니다. 이 값은 앵커 포인트간 거리를 그린 텍스트 행의 간격이 글꼴 디자이너와 장치에서 의도하는 대로 유지되도록 충분한 간격을 포함합니다. 이러한 추가(선행) 공백은 해당 텍스트 아래에 발생합니다.

Returns:

이 글꼴인 텍스트 행의 표준 높이(음수가 아닌 값)

getBaselinePosition

public int getBaselinePosition()

텍스트의 맨 위에서 텍스트 기준선까지의 거리(픽셀 단위)를 가져옵니다.

Returns:

텍스트의 맨 위에서 텍스트의 기준선까지의 거리(픽셀 단위)

charWidth

public int charWidth(char ch)

이 글꼴로 지정된 문자의 진행 폭을 가져옵니다. 진행 폭은 후속 텍스트를 적절하게 배치할 때 필요한 ch 다음의 문자 간 간격을 비롯하여 이 Font를 사용하여 ch가 그려지는 경우 차지할 수평 거리입니다.

Parameters:

ch - 측정되는 문자

Returns:

전체 진행 폭(음수가 아닌 값)

charsWidth

public int charsWidth(char[] ch,
                      int offset,
                      int length)

지정한 오프셋에서 시작하여 지정한 문자 수(길이)로 ch의 문자 진행 폭을 반환합니다. 진행 폭은 후속 텍스트를 적절하게 배치할 때 필요한 문자 다음의 문자 간 간격을 비롯하여 이 Font를 사용하여 문자가 그려지는 경우 차지할 수평 거리입니다.

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

Parameters:

ch - 문자 배열

offset - 측정할 첫 번째 문자의 색인

length - 측정할 문자 수

Returns:

문자 범위의 너비

Throws:

ArrayIndexOutOfBoundsException - offset 및 length가 유효하지 않은 범위를 지정하는 경우

NullPointerException - ch가 null인 경우

stringWidth

public int stringWidth(String str)

이 Font로 지정한 String을 표시하기 위해 전체 진행 폭을 가져옵니다. 진행 폭은 후속 텍스트를 적절하게 배치할 때 필요한 str 다음의 문자 간 간격을 비롯하여 이 Font를 사용하여 str이 그려지는 경우 차지할 수평 거리입니다.

Parameters:

str - 측정되는 String

Returns:

전체 진행 폭

Throws:

NullPointerException - str이 null인 경우

substringWidth

public int substringWidth(String str,
                          int offset,
                          int len)

이 Font로 지정한 하위 문자열을 표시하기 위해 전체 진행 폭을 가져옵니다. 진행 폭은 후속 텍스트를 적절하게 배치할 때 필요한 하위 문자열 다음의 문자 간 간격을 비롯하여 이 Font를 사용하여 하위 문자열이 그려지는 경우 차지할 수평 거리입니다.

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

Parameters:

str - 측정되는 String

offset - 하위 문자열의 첫 번째 문자 색인(0에서 시작)

len - 하위 문자열 길이

Returns:

전체 진행 폭

Throws:

StringIndexOutOfBoundsException - offset과 length가 유효하지 않은 범위를 지정하는 경우

NullPointerException - str이 null인 경우