|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JLabel
短いテキスト文字列やイメージの表示領域です。両方を一緒に表示することもできます。ラベルは入力イベントには反応しません。そのため、ラベルはキーボードフォーカスを取得しません。しかし、近くにあるコンポーネントにキーボードショートカットが割り当てられていて、そのコンポーネントが自分でショートカットを表示できない場合には、ラベルを利用して表示することができます。
JLabel
オブジェクトには、文字列やイメージを表示することができます。両方を一緒に表示することもできます。垂直方向と水平方向の配置方法を設定することによって、ラベルの表示領域内でのラベル内容の表示場所を指定することができます。デフォルトでは、ラベルは表示領域内で垂直方向に中央揃えされて表示されます。また、デフォルトでは、テキストのみのラベルはリーディングエッジに揃えられ、イメージのみのラベルは水平方向に中央揃えにされます。
また、イメージに対するテキストの位置を相対的に指定することもできます。デフォルトでは、テキストはイメージのトレーリングエッジに表示され、テキストとイメージは垂直方向に揃えられます。
ラベルのリーディングエッジおよびトレーリングエッジは、ComponentOrientation
プロパティの値から判定されます。現在では、デフォルトの ComponentOrientation 設定は、リーディングエッジが左、トレーリングエッジが右にマッピングされています。
さらに、setIconTextGap
メソッドを使用して、テキストとイメージの間の距離をピクセル数で指定することができます。デフォルトは 4 ピクセルです。
詳細は、「The Java Tutorial」の「How to Use Labels」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
内部クラスの概要 | |
protected class |
JLabel.AccessibleJLabel
オブジェクトのユーザ補助機能を取得するために使用されるクラスです。 |
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
クラス java.awt.Container から継承した内部クラス |
Container.AccessibleAWTContainer |
クラス java.awt.Component から継承した内部クラス |
Component.AccessibleAWTComponent |
フィールドの概要 | |
protected Component |
labelFor
|
クラス javax.swing.JComponent から継承したフィールド |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース javax.swing.SwingConstants から継承したフィールド |
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NORTH, NORTH_EAST, NORTH_WEST, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
JLabel()
JLabel のインスタンスを、タイトルをイメージなしの空の文字列で作成します。 |
|
JLabel(Icon image)
JLabel のインスタンスを、指定されたイメージで作成します。 |
|
JLabel(Icon image,
int horizontalAlignment)
JLabel のインスタンスを、指定されたイメージと水平方向の配置方法で作成します。 |
|
JLabel(String text)
JLabel のインスタンスを、指定されたテキストで作成します。 |
|
JLabel(String text,
Icon icon,
int horizontalAlignment)
JLabel のインスタンスを、指定されたテキスト、イメージ、および水平方向の配置方法で作成します。 |
|
JLabel(String text,
int horizontalAlignment)
JLabel のインスタンスを、指定されたテキストと水平方向の配置方法で作成します。 |
メソッドの概要 | |
protected int |
checkHorizontalKey(int key,
String message)
horizontalAlignment プロパティに対してキーが正当な値であるかどうかを判定します。 |
protected int |
checkVerticalKey(int key,
String message)
verticalAlignment または verticalTextPosition プロパティに対してキーが正当な値であるかどうかを判定します。 |
AccessibleContext |
getAccessibleContext()
このオブジェクトの AccessibleContext を返します。 |
Icon |
getDisabledIcon()
disabledIcon プロパティの値を返します。 |
int |
getDisplayedMnemonic()
ニーモニックキーを示すキーコードを返します。 |
int |
getHorizontalAlignment()
ラベルの内容の X 軸に沿った配置方法を返します。 |
int |
getHorizontalTextPosition()
ラベルテキストのイメージに対する水平位置を返します。 |
Icon |
getIcon()
ラベルに表示するグラフィックイメージ (グリフやアイコン) を返します。 |
int |
getIconTextGap()
このラベルに表示されているテキストとアイコンとの距離を返します。 |
Component |
getLabelFor()
このラベルが割り当てられているコンポーネントを返します。 |
String |
getText()
ラベルが表示するテキスト文字列を返します。 |
LabelUI |
getUI()
このコンポーネントを描画する L&F オブジェクトを返します。 |
String |
getUIClassID()
このコンポーネントを描画する L&F クラスの名前を指定する文字列を返します。 |
int |
getVerticalAlignment()
ラベルの内容の Y 軸に沿った配置方法を返します。 |
int |
getVerticalTextPosition()
ラベルテキストのイメージに対する垂直位置を返します。 |
boolean |
imageUpdate(Image img,
int infoflags,
int x,
int y,
int w,
int h)
現在の Icon の Image が、渡された Image の img と異なる場合は、false を返してオーバーライドします。 |
protected String |
paramString()
この JLabel の文字列表現を返します。 |
void |
setDisabledIcon(Icon disabledIcon)
この JLabel が無効にされている (JLabel.setEnabled(false) が実行されている) 場合に表示されるアイコンを設定します。 |
void |
setDisplayedMnemonic(char aChar)
displayedMnemonic を char 値で設定します。 |
void |
setDisplayedMnemonic(int key)
ニーモニックキーを示すキーコードを設定します。 |
void |
setHorizontalAlignment(int alignment)
ラベルの内容の X 軸に沿った配置方法を設定します。 |
void |
setHorizontalTextPosition(int textPosition)
ラベルテキストのイメージに対する水平位置を設定します。 |
void |
setIcon(Icon icon)
このコンポーネントが表示するアイコンを定義します。 |
void |
setIconTextGap(int iconTextGap)
アイコンプロパティとテキストプロパティが両方とも設定されている場合に、このプロパティはそれらの間の距離を定義します。 |
void |
setLabelFor(Component c)
このラベルが割り当てられているコンポーネントを設定します。 |
void |
setText(String text)
このコンポーネントが表示する 1 行のテキストを定義します。 |
void |
setUI(LabelUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。 |
void |
setVerticalAlignment(int alignment)
ラベルの内容の Y 軸に沿った配置方法を設定します。 |
void |
setVerticalTextPosition(int textPosition)
ラベルのイメージに対するテキストの垂直位置を設定します。 |
void |
updateUI()
L&F が変更されたことを示す UIFactory からの通知です。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
protected Component labelFor
コンストラクタの詳細 |
public JLabel(String text, Icon icon, int horizontalAlignment)
JLabel
のインスタンスを、指定されたテキスト、イメージ、および水平方向の配置方法で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。テキストはイメージのトレーリングエッジに表示されます。text
- ラベルに表示されるテキストicon
- ラベルに表示されるイメージhorizontalAlignment
- SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
、LEADING
、または TRAILING
のうちの 1 つpublic JLabel(String text, int horizontalAlignment)
JLabel
のインスタンスを、指定されたテキストと水平方向の配置方法で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。text
- ラベルに表示されるテキストhorizontalAlignment
- SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
、LEADING
、または TRAILING
のうちの 1 つpublic JLabel(String text)
JLabel
のインスタンスを、指定されたテキストで作成します。ラベルは、表示領域のリーディングエッジに揃えられ、垂直方向に中央揃えされます。text
- ラベルに表示されるテキストpublic JLabel(Icon image, int horizontalAlignment)
JLabel
のインスタンスを、指定されたイメージと水平方向の配置方法で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。icon
- ラベルに表示されるイメージhorizontalAlignment
- SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
、LEADING
、または TRAILING
のうちの 1 つpublic JLabel(Icon image)
JLabel
のインスタンスを、指定されたイメージで作成します。ラベルは、表示領域内で垂直方向と水平方向に中央揃えされます。icon
- ラベルに表示されるイメージpublic JLabel()
JLabel
のインスタンスを、タイトルをイメージなしの空の文字列で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。ラベルの内容が設定されると、ラベルは表示領域のリーディングエッジに表示されます。メソッドの詳細 |
public LabelUI getUI()
public void setUI(LabelUI ui)
ui
- LabelUI L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public String getText()
setText(java.lang.String)
public void setText(String text)
このプロパティのデフォルト値は null です。
これは JavaBeans バウンドプロパティです。
setVerticalTextPosition(int)
,
setHorizontalTextPosition(int)
,
setIcon(javax.swing.Icon)
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setIcon(Icon icon)
このプロパティのデフォルト値は null です。
これは JavaBeans バウンドプロパティです。
setVerticalTextPosition(int)
,
setHorizontalTextPosition(int)
,
getIcon()
public Icon getDisabledIcon()
setDisabledIcon(javax.swing.Icon)
,
ImageIcon
public void setDisabledIcon(Icon disabledIcon)
このプロパティのデフォルト値は null です。
disabledIcon
- コンポーネントが無効である場合に表示される IcongetDisabledIcon()
,
JComponent.setEnabled(boolean)
public void setDisplayedMnemonic(int key)
getLabelFor()
,
setLabelFor(java.awt.Component)
public void setDisplayedMnemonic(char aChar)
aChar
- 表示されるニーモニックを指定する charsetDisplayedMnemonic(int)
public int getDisplayedMnemonic()
getLabelFor()
,
setLabelFor(java.awt.Component)
protected int checkHorizontalKey(int key, String message)
key
- チェックするプロパティ値message
- IllegalArgumentException の詳細メッセージIllegalArgumentException
- キーが LEFT、CENTER、RIGHT、LEADING、TRAILING のどれでもない場合setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String message)
key
- チェックするプロパティ値message
- IllegalArgumentException の詳細メッセージIllegalArgumentException
- キーが TOP、CENTER、または BOTTOM ではない場合setVerticalAlignment(int)
,
setVerticalTextPosition(int)
public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
このプロパティのデフォルト値は 4 ピクセルです。
これは JavaBeans バウンドプロパティです。
getIconTextGap()
public int getVerticalAlignment()
SwingConstants
で定義されている定数 TOP
、CENTER
、または BOTTOM
のうちの 1 つSwingConstants
,
setVerticalAlignment(int)
public void setVerticalAlignment(int alignment)
このプロパティのデフォルト値は CENTER です。
alignment
- SwingConstants
で定義されている定数 TOP
、CENTER
(デフォルト)、または BOTTOM
のうちの 1 つSwingConstants
,
getVerticalAlignment()
public int getHorizontalAlignment()
SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
、LEADING
、または TRAILING
のうちの 1 つsetHorizontalAlignment(int)
,
SwingConstants
public void setHorizontalAlignment(int alignment)
これは JavaBeans バウンドプロパティです。
alignment
- SwingConstants
で定義されている定数。LEFT
、CENTER
(イメージのみのラベルのデフォルト)、RIGHT
、LEADING
(テキストのみのラベルのデフォルト)、TRAILING
のどれかSwingConstants
,
getHorizontalAlignment()
public int getVerticalTextPosition()
SwingConstants
で定義されている定数 TOP
、CENTER
、または BOTTOM
のうちの 1 つsetVerticalTextPosition(int)
,
SwingConstants
public void setVerticalTextPosition(int textPosition)
このプロパティのデフォルト値は CENTER です。
これは JavaBeans バウンドプロパティです。
textPosition
- SwingConstants
で定義されている定数 TOP
、CENTER
(デフォルト)、または BOTTOM
のうちの 1 つSwingConstants
,
getVerticalTextPosition()
public int getHorizontalTextPosition()
SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
、LEADING
、または TRAILING
のうちの 1 つSwingConstants
public void setHorizontalTextPosition(int textPosition)
x
- SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
、LEADING
、または TRAILING
(デフォルト) のうちの 1 つIllegalArgumentException
- SwingConstants
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
img
と異なる場合は、false を返してオーバーライドします。Component
内の imageUpdate
ImageObserver
,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
null
にはなりません。JComponent
内の paramString
public Component getLabelFor()
getDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- ラベルが割り当てられているコンポーネント。ラベルがコンポーネントに割り当てられていない場合は nullgetDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.