Класс 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"));
На этом изображении показаны флажки и сетчатая компоновка, созданные этим примером кода:
Кнопка с надписью 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 |
Создаёт флажок с указанной меткой. |
Checkbox |
Создаёт флажок с указанной меткой и устанавливает указанное состояние. |
Checkbox |
Создаёт флажок с указанной меткой, в указанной группе флажков и установленным указанным состоянием. |
Checkbox |
Создаёт флажок с указанной меткой, в указанной группе флажков и установленным указанным состоянием. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addItemListener |
Добавляет указанного обработчика событий к этому флажку для получения событий от этого флажка. |
void |
addNotify() |
Создаёт компонент-визард для флажка. |
AccessibleContext |
getAccessibleContext() |
Возвращает AccessibleContext, связанный с этим флажком. |
CheckboxGroup |
getCheckboxGroup() |
Определяет группу этого флажка. |
ItemListener[] |
getItemListeners() |
Возвращает массив всех зарегистрированных обработчиков событий для этого флажка. |
String |
getLabel() |
Возвращает метку этого флажка. |
<T extends EventListener> |
getListeners |
Возвращает массив всех объектов, которые в данный момент зарегистрированы как FooListener на этом Checkbox. |
Object[] |
getSelectedObjects() |
Возвращает массив (длиной 1) содержащий метку флажка или null, если флажок не выбран. |
boolean |
getState() |
Определяет, находится ли этот флажок в состоянии "включено" или "выключено". |
protected String |
paramString() |
Возвращает строку, представляющую состояние этого Checkbox. |
protected void |
processEvent |
Обрабатывает события на этом флажке. |
protected void |
processItemEvent |
Обрабатывает события, происходящие на этом флажке, передавая их всем зарегистрированным ItemListener объектам. |
void |
removeItemListener |
Удаляет указанного обработчика событий, чтобы он больше не получал события от этого флажка. |
void |
setCheckboxGroup |
Устанавливает группу этого флажка в указанную группу флажков. |
void |
setLabel |
Устанавливает метку этого флажка в заданную строку. |
void |
setState |
Устанавливает состояние этого флажка в указанное состояние. |
Методы, объявленные в классе 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
Подробное описание конструкторов
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()
- Определяется в:
-
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)
См. AWT Threading Issues для получения подробной информации о модели потоков AWT.
- Определяется в:
-
addItemListenerв интерфейсеItemSelectable - Параметры:
-
l- слушатель событий элементов - С момента:
- 1.1
- См. также:
removeItemListener
public void removeItemListener(ItemListener l)
См. AWT Threading Issues для получения подробной информации о модели потоков AWT.
- Определяется в:
-
removeItemListenerв интерфейсеItemSelectable - Параметры:
-
l- слушатель событий элементов - С момента:
- 1.1
- См. также:
getItemListeners
public ItemListener[] getItemListeners()
- Возвращает:
- все слушатели событий изменения состояния этого флажка или пустой массив, если слушатели не зарегистрированы
- С момента:
- 1.4
- См. также:
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
addFooListener. В качестве аргумента listenerType можно указать литерал класса, например FooListener.class. Например, можно получить слушателей событий изменения состояния для флажка следующим образом:
ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));Если такие слушатели отсутствуют, этот метод возвращает пустой массив.
- Переопределяет:
-
getListenersв классеComponent - Параметры типа:
-
T- тип слушателей - Параметры:
-
listenerType- тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, который унаследован отjava.util.EventListener - Возвращает:
- массив всех объектов, зарегистрированных в качестве слушателей на этом флажке, или пустой массив, если такие слушатели не были добавлены
- Исключения:
-
ClassCastException- еслиlistenerTypeне указывает класс или интерфейс, реализующийjava.util.EventListener - С момента:
- 1.3
- См. также:
processEvent
protected void processEvent(AWTEvent e)
ItemEvent, этот метод вызывает метод processItemEvent. В противном случае, он вызывает метод своего предка processEvent. Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.
- Переопределяет:
-
processEventв классеComponent - Параметры:
-
e- событие - С момента:
- 1.1
- См. также:
processItemEvent
protected void processItemEvent(ItemEvent e)
ItemListener. Этот метод вызывается только если события изменения состояния включены для этого компонента. События изменения состояния включены, когда происходит одно из следующих событий:
- Объект
ItemListenerзарегистрирован с помощьюaddItemListener. - События изменения состояния включены с помощью
enableEvents.
Обратите внимание, что если параметр события равен null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие изменения состояния - С момента:
- 1.1
- См. также:
paramString
protected String paramString()
null.- Переопределяет:
-
paramStringв классеComponent - Возвращает:
- строку параметров этого флажка
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleAWTCheckbox, который служит AccessibleContext для этого флажка
- С момента:
- 1.3
© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/Checkbox.html