|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JLabel
短いテキスト文字列やイメージの表示領域です。両方を一緒に表示することもできます。ラベルは入力イベントには反応しません。そのため、ラベルはキーボードフォーカスを取得しません。しかし、近くにあるコンポーネントにキーボードショートカットが割り当てられていて、そのコンポーネントが自分でショートカットを表示できない場合には、ラベルを利用して表示することができます。
JLabel
オブジェクトには、文字列やイメージを表示することができます。両方を一緒に表示することもできます。垂直方向と水平方向の配置方法を設定することによって、ラベルの表示領域内でのラベル内容の表示場所を指定することができます。デフォルトでは、ラベルは表示領域内で垂直方向に中央揃えされて表示されます。また、デフォルトでは、テキストのみのラベルは左揃えになり、イメージのみのラベルは水平方向に中央揃えされます。
また、イメージに対するテキストの位置を相対的に指定することもできます。デフォルトでは、テキストはイメージの右側に表示され、テキストとイメージの上端が揃えられます。
さらに、setIconTextGap
メソッドを使用して、テキストとイメージの間の距離をピクセル数で指定することができます。デフォルトは 4 ピクセルです。
詳細は、「The Java Tutorial」の「How to Use Labels」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
内部クラスの概要 | |
protected class |
JLabel.AccessibleJLabel
このオブジェクトのユーザ補助機能を取得するために使用するクラスです。 |
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
フィールドの概要 | |
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 |
コンストラクタの概要 | |
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()
ラベルテキストのイメージに対する垂直位置を返します。 |
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
のうちの 1 つpublic JLabel(String text, int horizontalAlignment)
JLabel
のインスタンスを、指定されたテキストと水平方向の配置方法で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。text
- ラベルに表示されるテキストhorizontalAlignment
- SwingConstants
で定義されている定数 LEFT
、CENTER
、または RIGHT
のうちの 1 つpublic JLabel(String text)
JLabel
のインスタンスを、指定されたテキストで作成します。ラベルは、表示領域内で左揃えになり、垂直方向に中央揃えされます。text
- ラベルに表示されるテキストpublic JLabel(Icon image, int horizontalAlignment)
JLabel
のインスタンスを、指定されたイメージと水平方向の配置方法で作成します。ラベルは、表示領域内で垂直方向に中央揃えされます。icon
- ラベルに表示されるイメージhorizontalAlignment
- SwingConstants
で定義されている定数 LEFT
、CENTER
、または RIGHT
のうちの 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.updateUI()
public String 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 の詳細メッセージsetHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String message)
key
- チェックするプロパティ値message
- IllegalArgumentException の詳細メッセージ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
のうちの 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
のどれかSwingConstants
public void setHorizontalTextPosition(int textPosition)
textPosition
- SwingConstants
で定義されている定数 LEFT
、CENTER
、RIGHT
(デフォルト)、LEADING
、または TRAILING
のうちの 1 つSwingConstants
protected String paramString()
null
にはなりません。
JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。
public AccessibleContext getAccessibleContext()
public Component getLabelFor()
getDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- ラベルが割り当てられているコンポーネント。ラベルがコンポーネントに割り当てられていない場合は nullgetDisplayedMnemonic()
,
setDisplayedMnemonic(int)
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |