Class ImageItem

package javax.microedition.lcdui

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

설명

extends Item:

이미지를 포함할 수 있는 항목입니다.

각 ImageItem 항목에는 Image 객체에 대한 참조가 들어 있습니다. 이 Image는 변경 가능하거나 변경 불가능합니다. Image가 변경 가능한 경우 ImageItem이 이 Image로 구성되고 setImage가 Image와 함께 호출되는 시점의 이미지 내용으로 스냅샷을 생성한 것과 같은 기능을 합니다. 이 스냅샷은 ImageItem의 내용이 표시될 때마다 사용됩니다. 그 후에 응용 프로그램이 Image에 그림을 그리더라도 setImage에 대한 다음 호출 전까지는 스냅샷이 수정되지 않습니다. 이 스냅샷은 ImageItem의 컨테이너가 활성 상태가 되거나 디스플레이에서 보이게 되면 업데이트되지 않습니다. 이는 응용 프로그램이 Displayables와 항목이 디스플레이에 나타나고 사라질 정확한 시기를 제어하지 못하기 때문입니다.

ImageItem의 이미지 내용에는 null 값이 지정될 수 있습니다. 이런 경우 및 레이블 또한 null인 경우에는 ImageItem이 화면에서 공간을 차지하지 않습니다.

ImageItem에는 처음에 MIDP 1.0에 정의된 레이아웃 지시어가 들어 있습니다. 이러한 레이아웃 지시어는 Item 클래스로 이동되었고 이제는 모든 항목에 적용됩니다. 선언은 소스 호환성을 위해 ImageItem에 남아 있습니다.

altText 매개 변수는 이미지가 디스플레이 용량을 초과한 경우 이미지의 위치에 표시될 문자열을 지정합니다. altText 매개 변수는 null일 수 있습니다.

Since:

• MIDP 1.0

필드 요약

• static int LAYOUT_CENTER — Item.LAYOUT_CENTER 를 참조하십시오.
• static int LAYOUT_DEFAULT — Item.LAYOUT_DEFAULT 를 참조하십시오.
• static int LAYOUT_LEFT — Item.LAYOUT_LEFT 를 참조하십시오.
• static int LAYOUT_NEWLINE_AFTER — Item.LAYOUT_NEWLINE_AFTER 를 참조하십시오.
• static int LAYOUT_NEWLINE_BEFORE — Item.LAYOUT_NEWLINE_BEFORE 를 참조하십시오.
• static int LAYOUT_RIGHT — Item.LAYOUT_RIGHT 를 참조하십시오.

생성자 요약

• ImageItem ( String label, Image img, int layout, String altText) 주어진 레이블, 이미지, 레이아웃 지시어 및 대체 텍스트 문자열로 새 ImageItem 을 작성합니다.
• ImageItem ( String label, Image image, int layout, String altText, int appearanceMode) 주어진 레이블, 이미지, 레이아웃 지시어, 대체 텍스트 문자열 및 모양 모드로 새 ImageItem 객체를 작성합니다.

메서드 요약

• String getAltText () — 이미지가 장치의 표시 용량을 초과한 경우 사용할 텍스트 문자열을 가져옵니다.
• int getAppearanceMode () — ImageItem 의 모양 모드를 반환합니다.
• Image getImage () — ImageItem 에 포함된 이미지를 가져오거나 포함된 이미지가 없으면 null 을 가져옵니다.
• int getLayout () — 이미지 배치에 사용할 레이아웃 지시어를 가져옵니다.
• void setAltText ( String text) — ImageItem 의 대체 텍스트를 설정하거나 대체 텍스트가 제공되지 않은 경우 null 을 설정합니다.
• void setImage ( Image img) — ImageItem 에 포함된 Image 객체를 설정합니다.
• void setLayout (int layout) — 레이아웃 지시어를 설정합니다.

필드 상세

LAYOUT_DEFAULT

public static final int LAYOUT_DEFAULT

See Also:

• Constant Field Values

LAYOUT_LEFT

public static final int LAYOUT_LEFT

See Also:

• Constant Field Values

LAYOUT_RIGHT

public static final int LAYOUT_RIGHT

See Also:

• Constant Field Values

LAYOUT_CENTER

public static final int LAYOUT_CENTER

See Also:

• Constant Field Values

LAYOUT_NEWLINE_BEFORE

public static final int LAYOUT_NEWLINE_BEFORE

See Also:

• Constant Field Values

LAYOUT_NEWLINE_AFTER

public static final int LAYOUT_NEWLINE_AFTER

See Also:

• Constant Field Values

ImageItem

public ImageItem(String label,
                 Image img,
                 int layout,
                 String altText)

• 주어진 레이블, 이미지, 레이아웃 지시어 및 대체 텍스트 문자열로 새 ImageItem을 작성합니다. 이 구성자를 호출하는 것은 다음을 호출하는 것과 같습니다.

ImageItem(label, image, layout, altText, PLAIN);

Parameters:

• altText - 이미지 위치에 사용할 수 있는 텍스트

Throws:

• IllegalArgumentException - layout 값이 지시어의 올바른 조합이 아닌 경우

See Also:

• ImageItem(String, Image, int, String, int)

ImageItem

public ImageItem(String label,
                 Image image,
                 int layout,
                 String altText,
                 int appearanceMode)

• 주어진 레이블, 이미지, 레이아웃 지시어, 대체 텍스트 문자열 및 모양 모드로 새 ImageItem 객체를 작성합니다. 레이블이나 대체 텍스트는 존재하거나 null일 수 있습니다.

appearanceMode 매개 변수(모양 모드 참조)를 보면 응용 프로그램이 이 ImageItem에 사용할 플랫폼이 무엇인지 알 수 있습니다. 하이퍼링크나 버튼같은 동작을 제공하려면 응용 프로그램은 기본 Command를 이 ImageItem과 연관시키고 이 ImageItem에 ItemCommandListener를 추가해야 합니다.

ImageItem을 버튼으로 사용하는 예는 다음과 같습니다.

ImageItem imgItem =
         new ImageItem("Default: ", img,
                       Item.LAYOUT_CENTER, null,
                       Item.BUTTON);
     imgItem.setDefaultCommand(
         new Command("Set", Command.ITEM, 1);
     // icl is ItemCommandListener
     imgItem.setItemCommandListener(icl);

Parameters:

• appearanceMode - ImageItem의 모양 모드. Item.PLAIN, Item.HYPERLINK 또는 Item.BUTTON 중 하나

Throws:

• IllegalArgumentException - appearanceMode가 유효하지 않은 경우

Since:

• MIDP 2.0

getImage

public Image getImage()

Returns:

• ImageItem이 사용하는 이미지

See Also:

• setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Parameters:

• img - ImageItem의 Image 또는 없는 경우 null

See Also:

• getImage()

getAltText

public String getAltText()

Returns:

• 대체 텍스트 값 또는 없는 경우 null

See Also:

• setAltText(java.lang.String)

setAltText

public void setAltText(String text)

Parameters:

• text - 새 대체 텍스트

See Also:

• getAltText()

getLayout

public int getLayout()

Overrides:

• getLayout in class Item

Returns:

• 레이아웃 지시어 값의 조합

See Also:

• setLayout(int)

setLayout

public void setLayout(int layout)

Overrides:

• setLayout in class Item

Parameters:

• layout - 레이아웃 지시어 값의 조합

Throws:

• IllegalArgumentException - layout의 값이 레이아웃 지시어의 유효한 조합이 아닌 경우

See Also:

• getLayout()

getAppearanceMode

public int getAppearanceMode()

Returns:

• 모양 모드 값. Item.PLAIN, Item.HYPERLINK 또는 Item.BUTTON 중 하나

Since:

• MIDP 2.0

생성자 상세

ImageItem

public ImageItem(String label,
                 Image img,
                 int layout,
                 String altText)

• 주어진 레이블, 이미지, 레이아웃 지시어 및 대체 텍스트 문자열로 새 ImageItem을 작성합니다. 이 구성자를 호출하는 것은 다음을 호출하는 것과 같습니다.

ImageItem(label, image, layout, altText, PLAIN);

Parameters:

• altText - 이미지 위치에 사용할 수 있는 텍스트

Throws:

• IllegalArgumentException - layout 값이 지시어의 올바른 조합이 아닌 경우

See Also:

• ImageItem(String, Image, int, String, int)

ImageItem

public ImageItem(String label,
                 Image image,
                 int layout,
                 String altText,
                 int appearanceMode)

• 주어진 레이블, 이미지, 레이아웃 지시어, 대체 텍스트 문자열 및 모양 모드로 새 ImageItem 객체를 작성합니다. 레이블이나 대체 텍스트는 존재하거나 null일 수 있습니다.

appearanceMode 매개 변수(모양 모드 참조)를 보면 응용 프로그램이 이 ImageItem에 사용할 플랫폼이 무엇인지 알 수 있습니다. 하이퍼링크나 버튼같은 동작을 제공하려면 응용 프로그램은 기본 Command를 이 ImageItem과 연관시키고 이 ImageItem에 ItemCommandListener를 추가해야 합니다.

ImageItem을 버튼으로 사용하는 예는 다음과 같습니다.

ImageItem imgItem =
         new ImageItem("Default: ", img,
                       Item.LAYOUT_CENTER, null,
                       Item.BUTTON);
     imgItem.setDefaultCommand(
         new Command("Set", Command.ITEM, 1);
     // icl is ItemCommandListener
     imgItem.setItemCommandListener(icl);

Parameters:

• appearanceMode - ImageItem의 모양 모드. Item.PLAIN, Item.HYPERLINK 또는 Item.BUTTON 중 하나

Throws:

• IllegalArgumentException - appearanceMode가 유효하지 않은 경우

Since:

• MIDP 2.0

getImage

public Image getImage()

Returns:

• ImageItem이 사용하는 이미지

See Also:

• setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Parameters:

• img - ImageItem의 Image 또는 없는 경우 null

See Also:

• getImage()

getAltText

public String getAltText()

Returns:

• 대체 텍스트 값 또는 없는 경우 null

See Also:

• setAltText(java.lang.String)

setAltText

public void setAltText(String text)

Parameters:

• text - 새 대체 텍스트

See Also:

• getAltText()

getLayout

public int getLayout()

Overrides:

• getLayout in class Item

Returns:

• 레이아웃 지시어 값의 조합

See Also:

• setLayout(int)

setLayout

public void setLayout(int layout)

Overrides:

• setLayout in class Item

Parameters:

• layout - 레이아웃 지시어 값의 조합

Throws:

• IllegalArgumentException - layout의 값이 레이아웃 지시어의 유효한 조합이 아닌 경우

See Also:

• getLayout()

getAppearanceMode

public int getAppearanceMode()

Returns:

• 모양 모드 값. Item.PLAIN, Item.HYPERLINK 또는 Item.BUTTON 중 하나

Since:

• MIDP 2.0

메서드 상세

getImage

public Image getImage()

Returns:

• ImageItem이 사용하는 이미지

See Also:

• setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Parameters:

• img - ImageItem의 Image 또는 없는 경우 null

See Also:

• getImage()

getAltText

public String getAltText()

Returns:

• 대체 텍스트 값 또는 없는 경우 null

See Also:

• setAltText(java.lang.String)

setAltText

public void setAltText(String text)

Parameters:

• text - 새 대체 텍스트

See Also:

• getAltText()

getLayout

public int getLayout()

Overrides:

• getLayout in class Item

Returns:

• 레이아웃 지시어 값의 조합

See Also:

• setLayout(int)

setLayout

public void setLayout(int layout)

Overrides:

• setLayout in class Item

Parameters:

• layout - 레이아웃 지시어 값의 조합

Throws:

• IllegalArgumentException - layout의 값이 레이아웃 지시어의 유효한 조합이 아닌 경우

See Also:

• getLayout()

getAppearanceMode

public int getAppearanceMode()

Returns:

• 모양 모드 값. Item.PLAIN, Item.HYPERLINK 또는 Item.BUTTON 중 하나

Since:

• MIDP 2.0