Флажок (Платформа Java SE 7)

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 класс, состояния этих трех флажков устанавливаются независимо.
Альтернативно, несколько флажков могут группироваться под управлением единственного объекта, используя CheckboxGroup класс. В группе флажков самое большее одна кнопка может быть в "на" состоянии в любой момент времени. Щелчок по флажку, чтобы повернуть это на силах любой другой флажок в той же самой группе, которая идет в "от" состояния.
С тех пор:

JDK1.0

См. Также:
GridLayout, CheckboxGroup, Сериализированная Форма

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

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

Вложенные классы/интерфейсы java.awt унаследованный от класса. Компонент
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка
- Поля java.awt унаследованный от класса. Компонент
  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)` Возвращает массив всех объектов, в настоящий момент зарегистрированных как `FooListener`s на это `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)` Устанавливает состояние этого флажка к указанному состоянию.

Методы 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

Методы 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 в классе 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 параметр с литералом класса, такой как FooListener.class. Например, можно запросить a Checkbox c для его слушателей элемента со следующим кодом:
```
ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
```
    Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
    Переопределения:
    
    getListeners в классе Component
    
    Параметры:
    listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
    
    Возвраты:
    массив всех объектов, зарегистрированных как FooListeners на этом флажке, или пустом массиве, если никакие такие слушатели не были добавлены
    
    Броски:
    
    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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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

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

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

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

Поля java.awt унаследованный от класса. Компонент

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

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

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

Методы java.awt унаследованный от класса. Компонент

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

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

Флажок

Флажок

Флажок

Флажок

Флажок

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

addNotify

getLabel

setLabel

getState

setState

getSelectedObjects

getCheckboxGroup

setCheckboxGroup

addItemListener

removeItemListener

getItemListeners

getListeners

processEvent

processItemEvent

paramString

getAccessibleContext