Класс 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. В группе флажков не более одной кнопки может находиться в состоянии "включено" в любой момент. Нажатие на флажок для его включения приводит к переключению любого другого флажка в той же группе, который находится в состоянии "включено", в состояние "выключено".

С момента:

1.0

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`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()`	Создаёт объект-представителя для флажка.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим флажком.
`CheckboxGroup`	`getCheckboxGroup()`	Определяет группу этого флажка.
`ItemListener[]`	`getItemListeners()`	Возвращает массив всех слушателей событий элементов, зарегистрированных на этом флажке.
`String`	`getLabel()`	Возвращает метку этого флажка.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, в настоящее время зарегистрированных как слушатели событий элементов на этом флажке.
`Object[]`	`getSelectedObjects()`	Возвращает массив (длина 1), содержащий метку флажка или null, если флажок не выбран.
`boolean`	`getState()`	Определяет, находится ли этот флажок в состоянии "включено" или "выключено".
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого флажка.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события на этом флажке.
`protected void`	`processItemEvent(ItemEvent e)`	Обрабатывает события элементов, происходящие на этом флажке, рассылать их всем зарегистрированным слушателям событий элементов.
`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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, 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

См. также:

Checkbox

public Checkbox(String label) throws HeadlessException

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

Параметры:

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

Использует:

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

См. также:

Checkbox

public Checkbox(String label, boolean state) throws HeadlessException

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

Параметры:

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

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

Использует:

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

См. также:

Checkbox

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

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

Параметры:

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

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

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

Использует:

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

С:

1.1

См. также:

Checkbox

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

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

Параметры:

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

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

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

Использует:

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

С:

1.1

См. также:

Подробное описание методов

addNotify

public void addNotify()

Создаёт виджет-представитель флажка. Представитель позволяет изменить внешний вид флажка без изменения его функциональности.

Переопределяет:

addNotify в классе Component

См. также:

getLabel

public String getLabel()

Возвращает метку этого флажка.

Возвращает:

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

См. также:

setLabel

public void setLabel(String label)

Устанавливает метку этого флажка на строковое значение аргумента.

Параметры:

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

См. также:

getState

public boolean getState()

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

Возвращает:

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

См. также:

setState

public void setState(boolean state)

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

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

Параметры:

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

См. также:

getSelectedObjects

public Object[] getSelectedObjects()

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

Определено в:

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

Возвращает:

список выбранных объектов, или null

См. также:

getCheckboxGroup

public CheckboxGroup getCheckboxGroup()

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

Возвращает:

группу этого флажка, или null, если флажок не входит в группу флажков.

См. также:

setCheckboxGroup

public void setCheckboxGroup(CheckboxGroup g)

Устанавливает группу этого флажка на заданную группу флажков. Если этот флажок уже входит в другую группу, он сначала удаляется из неё.

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

Параметры:

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

См. также:

addItemListener

public void addItemListener(ItemListener l)

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

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

Определено в:

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

Параметры:

l - слушатель событий элементов

С:

1.1

См. также:

removeItemListener

public void removeItemListener(ItemListener l)

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

Для получения подробной информации об архитектуре потоков AWT обратитесь к AWT Threading Issues.

Specified by:

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

Parameters:

l - слушатель событий изменения

Since:

1.1

See Also:

getItemListeners

public ItemListener[] getItemListeners()

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

Returns:

все слушатели событий изменения этой кнопки или пустой массив, если слушатели событий изменения не зарегистрированы

Since:

1.4

See Also:

getListeners

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

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

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

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

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

Overrides:

getListeners в классе Component

Type Parameters:

T - тип слушателей

Parameters:

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

Returns:

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

Throws:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

Since:

1.3

See Also:

processEvent

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

Since:

1.1

See Also:

processItemEvent

protected void processItemEvent(ItemEvent e)

Обрабатывает события изменения, происходящие на этой кнопке, направляя их всем зарегистрированным объектам типа ItemListener.

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

Объект типа ItemListener зарегистрирован через addItemListener.
События изменения включены через enableEvents.

Parameters:

e - событие изменения

Since:

1.1

See Also:

paramString

protected String paramString()

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

Overrides:: paramString в классе Component
Returns:: строка параметров этого флажка

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleAWTCheckbox, служащий AccessibleContext этого флажка
Since:: 1.3

© 1993, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Checkbox.html