public class JLabel extends JComponent implements SwingConstants, Accessible
JLabel
オブジェクトには、文字列やイメージを表示することができます。両方を一緒に表示することもできます。垂直方向と水平方向の配置方法を設定することによって、ラベルの表示領域内でのラベル内容の表示場所を指定することができます。デフォルトでは、ラベルは表示領域内で垂直方向に中央揃えされて表示されます。また、デフォルトでは、テキストのみのラベルはリーディングエッジにそろえられ、イメージのみのラベルは水平方向に中央揃えにされます。
また、イメージに対するテキストの位置を相対的に指定することもできます。デフォルトでは、テキストはイメージのトレーリングエッジに表示され、テキストとイメージは垂直方向にそろえられます。
ラベルのリーディングエッジおよびトレーリングエッジは、ComponentOrientation
プロパティーの値から判定されます。現在では、デフォルトの ComponentOrientation 設定は、リーディングエッジが左、トレーリングエッジが右にマッピングされています。
さらに、setIconTextGap
メソッドを使用して、テキストとイメージの間の距離をピクセル数で指定することができます。デフォルトは 4 ピクセルです。
詳細は、「The Java Tutorial」の「How to Use Labels」を参照してください。
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeansTM 用の長期間の格納サポートが java.beans
パッケージに追加されています。XMLEncoder
を参照してください。
修飾子と型 | クラスと説明 |
---|---|
protected class |
JLabel.AccessibleJLabel
このオブジェクトの Accessible 役割を取得するために使用されるクラスです。
|
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
protected Component |
labelFor |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
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)
このコンポーネントが表示する単一行のテキストを定義する。
|
void |
setUI(LabelUI ui)
このコンポーネントをレンダリングする L&F オブジェクトを設定します。
|
void |
setVerticalAlignment(int alignment)
ラベルの内容の Y 軸に沿った配置方法を設定します。
|
void |
setVerticalTextPosition(int textPosition)
ラベルのイメージに対するテキストの垂直位置を設定します。
|
void |
updateUI()
現在の Look & Feel からの値に UI プロパティーをリセットします。
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
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()
updateUI
、クラス: JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
、クラス: JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
public String getText()
setText(java.lang.String)
public void setText(String text)
このプロパティーのデフォルト値は null です。
これは JavaBeans バウンドプロパティーです。
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setIcon(Icon icon)
このプロパティーのデフォルト値は null です。
これは JavaBeans バウンドプロパティーです。
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)
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 を返します。imageUpdate
、インタフェース: ImageObserver
imageUpdate
、クラス: Component
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
にはなりません。paramString
、クラス: JComponent
public Component getLabelFor()
getDisplayedMnemonic()
, setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- ラベルが割り当てられているコンポーネント。ラベルがコンポーネントに割り当てられていない場合は nullgetDisplayedMnemonic()
, setDisplayedMnemonic(int)
public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: JComponent
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.