java.awt
クラス Label

java.lang.Object
  java.awt.Component
      java.awt.Label

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

public class Label
extends Component
implements Accessible

Label オブジェクトは、コンテナ内にテキストを配置するためのコンポーネントです。ラベルは、単一行の読み込み専用テキストを表示します。テキストを変更するにはアプリケーションを使い、ユーザが直接編集することはできません。

以下に例を示します。

 setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10));
 add(new Label("Hi There!"));
 add(new Label("Another Label"));
 

上記のコードは、次のラベルを作成します。

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

入れ子のクラスの概要

protected class

Label.AccessibleAWTLabel このクラスは Label クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

static int	CENTER ラベルが中央揃えされることを示します。
static int	LEFT ラベルが左揃えされることを示します。
static int	RIGHT ラベルが右揃えされることを示します。

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

Label()
空のラベルを構築します。

Label(String text)
新しいラベルを左揃えして、指定されたテキスト文字列で構築します。

Label(String text, int alignment)
指定されたテキスト文字列を、指定された配置で表示する新しいラベルを構築します。

メソッドの概要

void	addNotify() このラベルのピアを作成します。
AccessibleContext	getAccessibleContext() この Label に関連した AccessibleContext を返します。
int	getAlignment() このラベルの現在の配置を返します。
String	getText() このラベルのテキストを返します。
protected String	paramString() この Label の状態を表す文字列を返します。
void	setAlignment(int alignment) このラベルの配置を、指定された配置に設定します。
void	setText(String text) このラベルのテキストを、指定されたテキストに設定します。

クラス java.awt.Component から継承されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールドの詳細

LEFT

public static final int LEFT

ラベルが左揃えされることを示します。

関連項目:

定数フィールド値

CENTER

public static final int CENTER

ラベルが中央揃えされることを示します。

関連項目:

定数フィールド値

RIGHT

public static final int RIGHT

ラベルが右揃えされることを示します。

導入されたバージョン:

JDK1.0t.

関連項目:

定数フィールド値

コンストラクタの詳細

Label

public Label()
      throws HeadlessException

空のラベルを構築します。ラベルのテキストは、空の文字列 "" です。

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

Label

public Label(String text)
      throws HeadlessException

新しいラベルを左揃えして、指定されたテキスト文字列で構築します。

パラメータ:

text - ラベルが表示する文字列。null 値を指定しても、NullPointerException をスローせず受け付けられる

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

Label

public Label(String text,
             int alignment)
      throws HeadlessException

指定されたテキスト文字列を、指定された配置で表示する新しいラベルを構築します。alignment の値は、Label.LEFT、Label.RIGHT、Label.CENTER のいずれかです。

パラメータ:

text - ラベルが表示する文字列。null 値を指定しても、NullPointerException をスローせず受け付けられる

alignment - 配置方法の値

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

メソッドの詳細

addNotify

public void addNotify()

このラベルのピアを作成します。ピアを使用すると、その機能性を変えることなくラベルの外観を修正することができます。

オーバーライド:

クラス Component 内の addNotify

関連項目:

Component.isDisplayable(), Component.removeNotify()

getAlignment

public int getAlignment()

このラベルの現在の配置を返します。値は、Label.LEFT、Label.RIGHT、Label.CENTER のいずれかです。

関連項目:

setAlignment(int)

setAlignment

public void setAlignment(int alignment)

このラベルの配置を、指定された配置に設定します。値は、Label.LEFT、Label.RIGHT、Label.CENTER のいずれかです。

パラメータ:

alignment - 設定される配置

例外:

IllegalArgumentException - alignment に不適切な値が指定された場合

関連項目:

getAlignment()

getText

public String getText()

このラベルのテキストを返します。

戻り値:

このラベルのテキスト。テキストが null に設定されている場合は null

関連項目:

setText(java.lang.String)

setText

public void setText(String text)

このラベルのテキストを、指定されたテキストに設定します。

パラメータ:

text - このラベルが表示するテキスト。text が null の場合は、空の文字列 "" として処理される

関連項目:

getText()

paramString

protected String paramString()

この Label の状態を表す文字列を返します。このメソッドは、デバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

クラス Component 内の paramString

戻り値:

このラベルのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

この Label に関連した AccessibleContext を返します。ラベルの場合、AccessibleContext は AccessibleAWTLabel の形式を取ります。必要に応じて新しい AccessibleAWTLabel インスタンスを作成します。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

この Label の AccessibleContext として機能する AccessibleAWTLabel