Класс Checkbox

java.lang.Object
- java.awt.Component
- - java.awt.Checkbox

Все реализованные интерфейсы:: ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible

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"));

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

The following context describes the graphic.

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

В качестве альтернативы, несколько флажков могут быть сгруппированы под управлением одного объекта, используя класс CheckboxGroup. В группе флажков одновременно может быть активным не более одного флажка. Нажатие на флажок для его активации переводит любой другой флажок в той же группе, который был включён, в состояние «выключено».

С:: JDK1.0
См. также:: GridLayout, CheckboxGroup, Форматированный вывод сериализованных данных

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

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

Вложенные классы/интерфейсы, унаследованные от класса java.awt.Component

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

Поля

Поля, унаследованные от класса java.awt.Component

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()` Создаёт компаньон объекта Checkbox.
`AccessibleContext`	`getAccessibleContext()` Получает AccessibleContext, связанный с этим флажком.
`CheckboxGroup`	`getCheckboxGroup()` Определяет группу этого флажка.
`ItemListener[]`	`getItemListeners()` Возвращает массив всех слушателей событий, зарегистрированных на этом флажке.
`String`	`getLabel()` Получает метку этого флажка.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` Возвращает массив всех объектов, в настоящее время зарегистрированных как `FooListener` на этом `Checkbox`.
`Object[]`	`getSelectedObjects()` Возвращает массив (длиной 1) содержащий метку флажка или null, если флажок не выбран.
`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)` Устанавливает состояние этого флажка в заданное состояние.

Методы, унаследованные от класса 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, 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

Методы, унаследованные от класса java.lang.Object

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

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

Checkbox

public Checkbox()
         throws HeadlessException

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

Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

Checkbox

public Checkbox(String label)
         throws HeadlessException

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

Параметры:: label - строковая метка для этого флажка, или null для отсутствия метки.
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

Checkbox

public Checkbox(String label,
                boolean state)
         throws HeadlessException

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

Параметры:: label - строковая метка для этого флажка, или null для отсутствия метки; state - начальное состояние этого флажка
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

Checkbox

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

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

Параметры:: label - строковая метка для этого флажка, или null для отсутствия метки.; state - начальное состояние этого флажка.; group - группа флажков для этого флажка, или null для отсутствия группы.
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
С тех пор:: JDK1.1
См. также:: GraphicsEnvironment.isHeadless()

Checkbox

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 в классе 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), содержащий метку флажка, или null, если флажок не выбран.

Определено в:: 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 равно null, исключение не выбрасывается, и никаких действий не выполняется.

См. Вопросы потоков AWT для получения подробной информации о модели потоков AWT.

Определено в:: addItemListener в интерфейсе ItemSelectable
Параметры:: l - слушатель событий элементов
С тех пор:: JDK1.1
См. также:: removeItemListener(java.awt.event.ItemListener), getItemListeners(), setState(boolean), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

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

См. Вопросы потоков AWT для получения подробной информации о модели потоков AWT.

Определено в:: removeItemListener в интерфейсе ItemSelectable
Параметры:: l - слушатель событий элементов
С тех пор:: JDK1.1
См. также:: addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener[] getItemListeners()

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

Возвращает:: все слушатели событий элементов этого флажка или пустой массив, если слушатели событий элементов в настоящее время не зарегистрированы
С тех пор:: 1.4
См. также:: addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

getListeners

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

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

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

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

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

Переопределяет:: getListeners в классе Component
Параметры:: listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, который унаследован от java.util.EventListener
Возвращает:: массив всех объектов, зарегистрированных в качестве FooListener на этом флажке, или пустой массив, если такие слушатели не были добавлены
Исключения:: ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener
С тех пор:: 1.3
См. также:: getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределяет:: processEvent в классе 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 в классе Component
Возвращает:: строку параметров этого флажка

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleAWTCheckbox, который служит AccessibleContext этого флажка
С:: 1.3

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.