|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.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
内の 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()
Look & Feel によっては無効な状態のアイコンが描画されないことがあり、その場合、無効な状態のアイコンは無視されます。
disabledIcon
プロパティーsetDisabledIcon(javax.swing.Icon)
,
LookAndFeel.getDisabledIcon(javax.swing.JComponent, 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)
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)
,
SwingConstants
public 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)
,
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)
textPosition
- 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 を返してオーバーライドします。
ImageObserver
内の imageUpdate
Component
内の imageUpdate
img
- 表示されるイメージinfoflags
- 詳細は imageUpdate
を参照x
- x 座標y
- y 座標w
- 幅h
- 高さ
false
、そうでない場合は true
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 Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。