|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JLabel
public class JLabel
短いテキスト文字列やイメージの表示領域です。 両方を一緒に表示することもできます。ラベルは入力イベントには反応しません。そのため、ラベルはキーボードフォーカスを取得しません。しかし、近くにあるコンポーネントにキーボードショートカットが割り当てられていて、そのコンポーネントが自分でショートカットを表示できない場合には、ラベルを利用して表示することができます。
JLabel オブジェクトには、文字列やイメージを表示することができます。 両方を一緒に表示することもできます。垂直方向と水平方向の配置方法を設定することによって、ラベルの表示領域内でのラベル内容の表示場所を指定することができます。デフォルトでは、ラベルは表示領域内で垂直方向に中央揃えされて表示されます。また、デフォルトでは、テキストのみのラベルはリーディングエッジに揃えられ、イメージのみのラベルは水平方向に中央揃えにされます。
また、イメージに対するテキストの位置を相対的に指定することもできます。デフォルトでは、テキストはイメージのトレーリングエッジに表示され、テキストとイメージは垂直方向に揃えられます。
ラベルのリーディングエッジおよびトレーリングエッジは、ComponentOrientation プロパティーの値から判定されます。現在では、デフォルトの ComponentOrientation 設定は、リーディングエッジが左、トレーリングエッジが右にマッピングされています。
さらに、setIconTextGap メソッドを使用して、テキストとイメージの間の距離をピクセル数で指定することができます。デフォルトは 4 ピクセルです。
詳細は、「The Java Tutorial」の「How to Use Labels」を参照してください。
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans™ の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。
| 入れ子のクラスの概要 | |
|---|---|
protected class |
JLabel.AccessibleJLabel
このオブジェクトのアクセシビリティー対応の役割を取得するために使用されるクラスです。 |
| クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース |
|---|
JComponent.AccessibleJComponent |
| クラス java.awt.Container から継承された入れ子のクラス/インタフェース |
|---|
Container.AccessibleAWTContainer |
| クラス java.awt.Component から継承された入れ子のクラス/インタフェース |
|---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
| フィールドの概要 | |
|---|---|
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, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, 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()
無効な状態のラベルのアイコンを返します。 |
int |
getDisplayedMnemonic()
ニーモニックキーを示すキーコードを返します。 |
int |
getDisplayedMnemonicIndex()
Look & Feel がニーモニック文字を表すための修飾を提供する文字をインデックスとして返します。 |
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 |
setDisplayedMnemonicIndex(int index)
ニーモニックを表すためにテキストのどの文字を装飾するかについてのヒントを、Look & Feel に提供します。 |
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()
現在の Look & Feel からの値に UI プロパティーをリセットします。 |
| クラス 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 のインスタンスを、指定されたイメージと水平方向の配置方法で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。
image - ラベルに表示されるイメージhorizontalAlignment - SwingConstants で定義されている定数 LEFT、CENTER、RIGHT、LEADING、または TRAILING のうちの 1 つpublic JLabel(Icon image)
JLabel のインスタンスを、指定されたイメージで作成します。ラベルは、表示領域内で垂直方向と水平方向に中央揃えされます。
image - ラベルに表示されるイメージpublic JLabel()
JLabel のインスタンスを、イメージなしの空のタイトル文字列で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。ラベルの内容が設定されると、ラベルは表示領域のリーディングエッジに表示されます。
| メソッドの詳細 |
|---|
public LabelUI getUI()
public void setUI(LabelUI ui)
ui - LabelUI L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)public void updateUI()
JComponent 内の updateUIJComponent.updateUI()public String getUIClassID()
JComponent 内の getUIClassIDJComponent.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()
Look & Feel によっては無効な状態のアイコンが描画されないことがあり、その場合、無効な状態のアイコンは無視されます。
disabledIcon プロパティーsetDisabledIcon(javax.swing.Icon),
LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon),
ImageIconpublic 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)
public void setDisplayedMnemonicIndex(int index)
throws IllegalArgumentException
この値は、ニーモニックの変更 (ニーモニック自身またはテキストの変更など) に関連するプロパティーとして更新されます。デフォルトの文字を下線付きでないようにする場合、これだけを呼び出す必要があります。たとえば、ニーモニック「a」を持つテキスト「Save As」について、「Save As」のように「A」を修飾する場合は、setDisplayedMnemonic(KeyEvent.VK_A) を呼び出してから setDisplayedMnemonicIndex(5) を呼び出します。
index - 下線を付ける String に対するインデックス
IllegalArgumentException - index がテキストの長さに等しいか、-1 よりも小さい場合public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
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),
SwingConstantspublic void setHorizontalAlignment(int alignment)
これは JavaBeans バウンドプロパティーです。
alignment - SwingConstants で定義されている定数 LEFT、CENTER (イメージのみのラベルのデフォルト)、RIGHT、LEADING (テキストのみのラベルのデフォルト)、TRAILING のうちの 1 つSwingConstants,
getHorizontalAlignment()public int getVerticalTextPosition()
SwingConstants で定義されている定数 TOP、CENTER、または BOTTOM のうちの 1 つsetVerticalTextPosition(int),
SwingConstantspublic void setVerticalTextPosition(int textPosition)
このプロパティーのデフォルト値は CENTER です。
これは JavaBeans バウンドプロパティーです。
textPosition - SwingConstants で定義されている定数 TOP、CENTER (デフォルト)、または BOTTOM のうちの 1 つSwingConstants,
getVerticalTextPosition()public int getHorizontalTextPosition()
SwingConstants で定義されている定数 LEFT、CENTER、RIGHT、LEADING、または TRAILING のうちの 1 つSwingConstantspublic void setHorizontalTextPosition(int textPosition)
textPosition - SwingConstants で定義されている定数 LEFT、CENTER、RIGHT、LEADING、または TRAILING (デフォルト) のうちの 1 つ
IllegalArgumentExceptionSwingConstants
public boolean imageUpdate(Image img,
int infoflags,
int x,
int y,
int w,
int h)
img と異なる場合は、false を返してオーバーライドします。
ImageObserver 内の imageUpdateComponent 内の imageUpdateimg - 表示されるイメージinfoflags - 詳細は imageUpdate を参照x - x 座標y - y 座標w - 幅h - 高さ
false、そうでない場合は trueImageObserver,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)protected String paramString()
null にはなりません。
JComponent 内の paramStringpublic Component getLabelFor()
getDisplayedMnemonic(),
setDisplayedMnemonic(int)public void setLabelFor(Component c)
c - ラベルが割り当てられているコンポーネント。 ラベルがコンポーネントに割り当てられていない場合は nullgetDisplayedMnemonic(),
setDisplayedMnemonic(int)public AccessibleContext getAccessibleContext()
Accessible 内の getAccessibleContextJComponent 内の getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。