Spec-Zone .ru
спецификации, руководства, описания, API
|
public class JLabel extends JComponent implements SwingConstants, Accessible
A JLabel
объект может вывести на экран или текст, изображение, или обоих. Можно определить, где в области дисплея метки содержание метки выровненное, устанавливая выравнивание по вертикали и выравнивание по горизонтали. По умолчанию метки вертикально центрируются в их области дисплея. Метки только для текста являются выровненным передним краем по умолчанию; метки только для изображения горизонтально центрируются по умолчанию.
Можно также определить позицию текста относительно изображения. По умолчанию текст находится на запаздывающем краю изображения с текстом и изображением, вертикально выровненным.
Ведущий и запаздывающий край метки определяется от значения ComponentOrientation
свойство. В настоящее время установка ComponentOrientation значения по умолчанию отображает передний край на левый и запаздывающий край, чтобы исправиться.
Наконец, можно использовать setIconTextGap
метод, чтобы определить, сколько пикселей должно появиться между текстом и изображением. Значение по умолчанию является 4 пикселями.
См.
Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего JavaBeansTM была добавлена к java.beans
пакет. Пожалуйста, см. XMLEncoder
.
Модификатор и Тип | Класс и Описание |
---|---|
protected class |
JLabel. AccessibleJLabel
class, используемый, чтобы получить доступную роль для этого объекта.
|
JComponent. AccessibleJComponent
Контейнер. AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и Тип | Поле и Описание |
---|---|
protected Component |
labelFor |
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, 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()
Создает a
JLabel экземпляр без изображения и с пустой строкой для title. |
JLabel(Icon image)
Создает a
JLabel экземпляр с указанным изображением. |
JLabel(Icon image, int horizontalAlignment)
Создает a
JLabel экземпляр с указанным изображением и выравниванием по горизонтали. |
JLabel(String text)
Создает a
JLabel экземпляр с указанным текстом. |
JLabel(String text, Icon icon, int horizontalAlignment)
Создает a
JLabel экземпляр с указанным текстом, изображением, и выравниванием по горизонтали. |
JLabel(String text, int horizontalAlignment)
Создает a
JLabel экземпляр с указанным текстом и выравниванием по горизонтали. |
Модификатор и Тип | Метод и Описание |
---|---|
protected int |
checkHorizontalKey(int key, String message)
Проверьте, что ключ является юридическим значением для horizontalAlignment свойств.
|
protected int |
checkVerticalKey(int key, String message)
Проверьте, что ключ является юридическим значением для verticalAlignment или verticalTextPosition свойств.
|
AccessibleContext |
getAccessibleContext()
Получите AccessibleContext этого объекта
|
Значок |
getDisabledIcon()
Возвращает значок, используемый меткой, когда это отключается.
|
int |
getDisplayedMnemonic()
Возвратите код клавиши, который указывает на ускоряющую клавишу.
|
int |
getDisplayedMnemonicIndex()
Возвращает символ, как индексирование, что стиль должен обеспечить художественное оформление для как представление мнемонического символа.
|
int |
getHorizontalAlignment()
Возвращает выравнивание содержания метки вдоль X осей.
|
int |
getHorizontalTextPosition()
Возвращает горизонтальную позицию текста метки, относительно его изображения.
|
Значок |
getIcon()
Возвращает графическое изображение (глиф, значок), который выводит на экран метка.
|
int |
getIconTextGap()
Возвращает количество пространства между текстом и значком, выведенным на экран в этой метке.
|
Компонент |
getLabelFor()
Получите компонент, который это маркирует.
|
Строка |
getText()
Возвращает текстовую строку, которую выводит на экран метка.
|
LabelUI |
getUI()
Возвращается L&F объект, который представляет этот компонент.
|
Строка |
getUIClassID()
Возвращает строку, которая определяет имя l&f class, который представляет этот компонент.
|
int |
getVerticalAlignment()
Возвращает выравнивание содержания метки вдоль Оси Y.
|
int |
getVerticalTextPosition()
Возвращает вертикальную позицию текста метки, относительно его изображения.
|
boolean |
imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Это переопределяется, чтобы возвратить false, если Изображение текущего Значка не равно переданному в Изображении
img . |
protected String |
paramString()
Возвращает строковое представление этого JLabel.
|
void |
setDisabledIcon(Icon disabledIcon)
Установите значок, который будет выведен на экран, если этот JLabel "отключается" (JLabel.setEnabled (ложь)).
|
void |
setDisplayedMnemonic(char aChar)
Определяет displayedMnemonic как значение случайной работы.
|
void |
setDisplayedMnemonic(int key)
Определите код клавиши, который указывает на ускоряющую клавишу.
|
void |
setDisplayedMnemonicIndex(int index)
Обеспечивает подсказку для стили, относительно которого символ в тексте должен быть украшен, чтобы представить мнемосхему.
|
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()
Сбрасывает свойство 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
.public JLabel(String text, int horizontalAlignment)
JLabel
экземпляр с указанным текстом и выравниванием по горизонтали. Метка центрируется вертикально в ее области дисплея.text
- Текст, который будет выведен на экран меткой.horizontalAlignment
- Одна из следующих констант, определенных в SwingConstants
: LEFT
, CENTER
, RIGHT
, LEADING
или TRAILING
.public JLabel(String text)
JLabel
экземпляр с указанным текстом. Метка выровненная против переднего края ее области дисплея, и центрируемый вертикально.text
- Текст, который будет выведен на экран меткой.public JLabel(Icon image, int horizontalAlignment)
JLabel
экземпляр с указанным изображением и выравниванием по горизонтали. Метка центрируется вертикально в ее области дисплея.image
- Изображение, которое будет выведено на экран меткой.horizontalAlignment
- Одна из следующих констант, определенных в SwingConstants
: LEFT
, CENTER
, RIGHT
, LEADING
или TRAILING
.public JLabel(Icon image)
JLabel
экземпляр с указанным изображением. Метка центрируется вертикально и горизонтально в ее области дисплея.image
- Изображение, которое будет выведено на экран меткой.public JLabel()
JLabel
экземпляр без изображения и с пустой строкой для title. Метка центрируется вертикально в ее области дисплея. Содержание метки, когда-то набор, будет выведено на экран на переднем крае области дисплея метки.public LabelUI getUI()
public void setUI(LabelUI ui)
ui
- LabelUI L&F объектUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
updateUI
в class JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
в class JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
public String getText()
setText(java.lang.String)
public void setText(String text)
Значение по умолчанию этого свойства является нулем.
Это - JavaBeans связанное свойство.
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setIcon(Icon icon)
Значение по умолчанию этого свойства является нулем.
Это - JavaBeans связанное свойство.
public Icon getDisabledIcon()
Некоторый взгляд и чувства не могли бы представить отключенный Значок, когда они проигнорируют это.
disabledIcon
свойствоsetDisabledIcon(javax.swing.Icon)
, LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)
, ImageIcon
public void setDisabledIcon(Icon disabledIcon)
Значение по умолчанию этого свойства является нулем.
disabledIcon
- Значок, чтобы вывести на экран, когда компонент отключаетсяgetDisabledIcon()
, JComponent.setEnabled(boolean)
public void setDisplayedMnemonic(int key)
getLabelFor()
, setLabelFor(java.awt.Component)
public void setDisplayedMnemonic(char aChar)
aChar
- случайная работа, определяющая мнемосхему, чтобы вывести на экранsetDisplayedMnemonic(int)
public int getDisplayedMnemonic()
getLabelFor()
, setLabelFor(java.awt.Component)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
Значение этого обновляется как свойства, касающиеся мнемонического изменения (такие как мнемосхема непосредственно, текст...). Вам придется только когда-либо вызывать это, если Вы не хотите, чтобы символ значения по умолчанию был подчеркнут. Например, если текст был, 'Спасают Аса, с мнемосхемой, и Вы хотели быть украшенными, поскольку 'Спасают Аса, необходимо бы вызвать setDisplayedMnemonicIndex(5)
после вызова setDisplayedMnemonic(KeyEvent.VK_A)
.
index
- Индексируйте в Строку, чтобы подчеркнутьIllegalArgumentException
- будет брошен если index
= длина текста, или < -1public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
protected int checkHorizontalKey(int key, String message)
key
- значение свойства, чтобы проверитьmessage
- IllegalArgumentException детализируют сообщениеIllegalArgumentException
- если ключ не ОСТАВЛЯЮТ, ЦЕНТРИРУЙТЕСЬ, ИСПРАВЬТЕСЬ, ВЕДЯ или ЗАПАЗДЫВАЯ.setHorizontalTextPosition(int)
, setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String message)
key
- значение свойства, чтобы проверитьmessage
- IllegalArgumentException детализируют сообщениеIllegalArgumentException
- если ключ не является TOP, ЦЕНТРОМ, или НИЖНЕЙ ЧАСТЬЮ.setVerticalAlignment(int)
, setVerticalTextPosition(int)
public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
Значение по умолчанию этого свойства является 4 пикселями.
Это - JavaBeans связанное свойство.
getIconTextGap()
public int getVerticalAlignment()
SwingConstants
: TOP
, CENTER
, или BOTTOM
.SwingConstants
, setVerticalAlignment(int)
public void setVerticalAlignment(int alignment)
Значение по умолчанию этого свойства является ЦЕНТРОМ.
alignment
- Одна из следующих констант, определенных в SwingConstants
: TOP
, CENTER
(значение по умолчанию), или BOTTOM
.SwingConstants
, getVerticalAlignment()
public int getHorizontalAlignment()
SwingConstants
: LEFT
, CENTER
, RIGHT
, LEADING
или TRAILING
.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
.setVerticalTextPosition(int)
, SwingConstants
public void setVerticalTextPosition(int textPosition)
Значение по умолчанию этого свойства является ЦЕНТРОМ.
Это - JavaBeans связанное свойство.
textPosition
- Одна из следующих констант, определенных в SwingConstants
: TOP
, CENTER
(значение по умолчанию), или BOTTOM
.SwingConstants
, getVerticalTextPosition()
public int getHorizontalTextPosition()
SwingConstants
: LEFT
, CENTER
, RIGHT
, LEADING
или TRAILING
.SwingConstants
public void setHorizontalTextPosition(int textPosition)
textPosition
- Одна из следующих констант, определенных в SwingConstants
: LEFT
, CENTER
, RIGHT
, LEADING
, или TRAILING
(значение по умолчанию).IllegalArgumentException
SwingConstants
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
img
.imageUpdate
в интерфейсе ImageObserver
imageUpdate
в class Component
img
- наблюдаемое изображениеinfoflags
- см. imageUpdate
для получения дополнительной информацииx
- координата xy
- координата yw
- widthh
- heightfalse
если infoflags указывают, что изображение полностью загружается; true
иначе.ImageObserver
, Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
null
.paramString
в class JComponent
public Component getLabelFor()
getDisplayedMnemonic()
, setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- Компонент, который эта метка для, или нуль, если метка не является меткой для компонентаgetDisplayedMnemonic()
, setDisplayedMnemonic(int)
public AccessibleContext getAccessibleContext()
getAccessibleContext
в интерфейсе Accessible
getAccessibleContext
в class Component
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92