java.awt

Флажок класса

java.lang. Объект

java.awt. Компонент

java.awt. Флажок

Все Реализованные Интерфейсы:

ImageObserver, ItemSelectable, MenuContainer, Сериализуемый, Доступный

public class Checkbox
extends Component
implements ItemSelectable, Accessible

Флажок является графическим компонентом, который может быть в любом "на" (true) или "прочь" (false) состояние. Щелчок по флажку изменяет свое состояние от "на" "прочь", или от "прочь" до "на".

Следующий пример кода создает ряд флажков в расположении сетки:

 setLayout(new GridLayout(3, 1));
 add(new Checkbox("one", null, true));
 add(new Checkbox("two"));
 add(new Checkbox("three"));
 

Это изображение изображает флажки и расположение сетки, создаваемое этим примером кода:

Кнопка маркируется one находится в "на" состоянии, и другие два находятся в "от" состояния. В этом примере, который использует GridLayout class, состояния этих трех флажков устанавливаются независимо.

Альтернативно, несколько флажков могут группироваться под управлением единственного объекта, используя CheckboxGroup class. В группе флажков самое большее одна кнопка может быть в "на" состоянии в любой момент времени. Щелчок по флажку, чтобы повернуть это на силах любой другой флажок в той же самой группе, которая идет в "от" состояния.

С тех пор:

JDK1.0

См. Также:

GridLayout, CheckboxGroup, Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	Флажок. AccessibleAWTCheckbox Этот class реализует поддержку доступности Checkbox class.

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля, наследованные от class java.awt. Компонент

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

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

Сводка конструктора

Конструкторы

Конструктор и Описание
Checkbox() Создает флажок с пустой строкой для ее метки.
Checkbox(String label) Создает флажок с указанной меткой.
Checkbox(String label, boolean state) Создает флажок с указанной меткой и устанавливает указанное состояние.
Checkbox(String label, boolean state, CheckboxGroup group) Создает Флажок с указанной меткой, набором к указанному состоянию, и в указанной группе флажков.
Checkbox(String label, CheckboxGroup group, boolean state) Создает флажок с указанной меткой, в указанной группе флажков, и наборе к указанному состоянию.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addItemListener(ItemListener l) Добавляет указанный слушатель элемента, чтобы получить события элемента от этого флажка.
void	addNotify() Создает коллегу Флажка.
AccessibleContext	getAccessibleContext() Связали AccessibleContext с этим Флажком.
CheckboxGroup	getCheckboxGroup() Определяет группу этого флажка.
ItemListener[]	getItemListeners() Возвращает массив всех слушателей элемента, зарегистрированных на этом флажке.
Строка	getLabel() Получает метку этого флажка.
<T extends EventListener> T[]	getListeners(Class<T> listenerType) Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это Checkbox.
Объект[]	getSelectedObjects() Возвращает массив (длина 1) содержащий метку флажка или нуль, если флажок не устанавливается.
boolean	getState() Определяет, является ли этот флажок в "на" или "от" состояния.
protected String	paramString() Возвращает строку, представляющую состояние этого Checkbox.
protected void	processEvent(AWTEvent e) События процессов на этом флажке.
protected void	processItemEvent(ItemEvent e) События элемента процессов, происходящие на этом флажке, диспетчеризируя их любому зарегистрированному ItemListener объекты.
void	removeItemListener(ItemListener l) Удаляет указанного слушателя элемента так, чтобы слушатель элемента больше не получил события элемента от этого флажка.
void	setCheckboxGroup(CheckboxGroup g) Наборы группа этого флажка к указанной группе флажков.
void	setLabel(String label) Наборы метка этого флажка, чтобы быть строковым параметром.
void	setState(boolean state) Устанавливает состояние этого флажка к указанному состоянию.

Методы, наследованные от class java.awt. Компонент

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, getBaseline, getBaselineResizeBehavior, 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, 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, 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, revalidate, 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

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

Флажок

public Checkbox()
         throws HeadlessException

Создает флажок с пустой строкой для ее метки. Состояние этого флажка устанавливается в "прочь", и это не часть любой группы флажков.

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true

См. Также:

GraphicsEnvironment.isHeadless()

Флажок

public Checkbox(String label)
         throws HeadlessException

Создает флажок с указанной меткой. Состояние этого флажка устанавливается в "прочь", и это не часть любой группы флажков.

Параметры:

label - строковая метка для этого флажка, или null ни для какой метки.

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless возвраты true

См. Также:

GraphicsEnvironment.isHeadless()

Флажок

public Checkbox(String label,
                boolean state)
         throws HeadlessException

Создает флажок с указанной меткой и устанавливает указанное состояние. Этот флажок не является частью любой группы флажков.

Параметры:

label - строковая метка для этого флажка, или null ни для какой метки

state - начальное состояние этого флажка

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless возвраты true

См. Также:

GraphicsEnvironment.isHeadless()

Флажок

public Checkbox(String label,
                boolean state,
                CheckboxGroup group)
         throws HeadlessException

Создает Флажок с указанной меткой, набором к указанному состоянию, и в указанной группе флажков.

Параметры:

label - строковая метка для этого флажка, или null ни для какой метки.

state - начальное состояние этого флажка.

group - группа флажков для этого флажка, или null ни для какой группы.

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless возвраты true

С тех пор:

JDK1.1

См. Также:

GraphicsEnvironment.isHeadless()

Флажок

public Checkbox(String label,
                CheckboxGroup group,
                boolean state)
         throws HeadlessException

Создает флажок с указанной меткой, в указанной группе флажков, и наборе к указанному состоянию.

Параметры:

label - строковая метка для этого флажка, или null ни для какой метки.

group - группа флажков для этого флажка, или null ни для какой группы.

state - начальное состояние этого флажка.

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless возвраты true

С тех пор:

JDK1.1

См. Также:

GraphicsEnvironment.isHeadless()

Деталь метода

addNotify

public void addNotify()

Создает коллегу Флажка. Коллега позволяет Вам изменять вид Флажка, не изменяя его функциональность.

Переопределения:

addNotify в class Component

См. Также:

Toolkit.createCheckbox(java.awt.Checkbox), Component.getToolkit()

getLabel

public String getLabel()

Получает метку этого флажка.

Возвраты:

метка этого флажка, или null если у этого флажка нет никакой метки.

См. Также:

setLabel(String)

setLabel

public void setLabel(String label)

Наборы метка этого флажка, чтобы быть строковым параметром.

Параметры:

label - строка, чтобы установить как новая метка, или null ни для какой метки.

См. Также:

getLabel()

getState

public boolean getState()

Определяет, является ли этот флажок в "на" или "от" состояния. Булево значение true указывает "на" состоянии, и false указывает "от" состояния.

Возвраты:

состояние этого флажка, как булево значение

См. Также:

setState(boolean)

setState

public void setState(boolean state)

Устанавливает состояние этого флажка к указанному состоянию. Булево значение true указывает "на" состоянии, и false указывает "от" состояния.

Отметьте, что этот метод должен прежде всего использоваться, чтобы инициализировать состояние флажка. Программно установка состояния флажка не инициирует ItemEvent. Единственный способ инициировать ItemEvent взаимодействием с пользователем.

Параметры:

state - булево состояние флажка

См. Также:

getState()

getSelectedObjects

public Object[] getSelectedObjects()

Возвращает массив (длина 1) содержащий метку флажка или нуль, если флажок не устанавливается.

Определенный:

getSelectedObjects в интерфейсе ItemSelectable

См. Также:

ItemSelectable

getCheckboxGroup

public CheckboxGroup getCheckboxGroup()

Определяет группу этого флажка.

Возвраты:

группа этого флажка, или null если флажок не является частью группы флажков.

См. Также:

setCheckboxGroup(CheckboxGroup)

setCheckboxGroup

public void setCheckboxGroup(CheckboxGroup g)

Наборы группа этого флажка к указанной группе флажков. Если этот флажок уже находится в различной группе флажков, он сначала вынимается из той группы.

Если состояние этого флажка true и новой группе уже выбрали флажок, состояние этого флажка изменяется на false. Если состояние этого флажка true и у новой группы нет никакого установленного флажка, этот флажок становится установленным флажком для новой группы, и ее состояние true.

Параметры:

g - новая группа флажков, или null удалить этот флажок из любой группы флажков

См. Также:

getCheckboxGroup()

addItemListener

public void addItemListener(ItemListener l)

Добавляет указанный слушатель элемента, чтобы получить события элемента от этого флажка. События элемента отправляются слушателям в ответ на ввод данных пользователем, но не в ответ на звонки setState (). Если l является нулем, никакое исключение не выдается, и никакое действие не выполняется.

Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.

Определенный:

addItemListener в интерфейсе ItemSelectable

Параметры:

l - слушатель элемента

С тех пор:

JDK1.1

См. Также:

removeItemListener(java.awt.event.ItemListener), getItemListeners(), setState(boolean), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

Удаляет указанного слушателя элемента так, чтобы слушатель элемента больше не получил события элемента от этого флажка. Если l является нулем, никакое исключение не выдается, и никакое действие не выполняется.

Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.

Определенный:

removeItemListener в интерфейсе ItemSelectable

Параметры:

l - слушатель элемента

С тех пор:

JDK1.1

См. Также:

addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener[] getItemListeners()

Возвращает массив всех слушателей элемента, зарегистрированных на этом флажке.

Возвраты:

весь этот флажок ItemListeners или пустой массив, если никакие слушатели элемента в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это Checkbox. FooListeners регистрируются, используя addFooListener метод.

Можно определить listenerType параметр с литералом class, такой как FooListener.class. Например, можно запросить a Checkbox c для его слушателей элемента со следующим кодом:

ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));

Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.

Переопределения:

getListeners в class Component

Параметры:

listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener

Возвраты:

массив всех объектов, зарегистрированных как FooListeners на этом флажке, или пустом массиве, если никакие такие слушатели не были добавлены

Броски:

ClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListener

С тех пор:

1.3

См. Также:

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

События процессов на этом флажке. Если событие является экземпляром ItemEvent, этот метод вызывает processItemEvent метод. Иначе, это вызывает свой суперкласс processEvent метод.

Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.

Переопределения:

processEvent в class Component

Параметры:

e - событие

С тех пор:

JDK1.1

См. Также:

ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

События элемента процессов, происходящие на этом флажке, диспетчеризируя их любому зарегистрированному ItemListener объекты.

Этот метод не вызывают, если события элемента не включаются для этого компонента. События элемента включаются, когда одно из следующего происходит:

• ItemListener объект регистрируется через addItemListener.
• Через события элемента включают enableEvents.

Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.

Параметры:

e - событие элемента

С тех пор:

JDK1.1

См. Также:

ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

Возвращает строку, представляющую состояние этого Checkbox. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.

Переопределения:

paramString в class Component

Возвраты:

строка параметра этого флажка

getAccessibleContext

public AccessibleContext getAccessibleContext()

Связали AccessibleContext с этим Флажком. Для флажков AccessibleContext принимает форму AccessibleAWTCheckbox. Новый AccessibleAWTCheckbox создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleAWTCheckbox, который служит AccessibleContext этого Флажка

С тех пор:

1.3