Как Использовать Кнопки, Флажки, и Переключатели

Чтобы создать кнопку, можно инстанцировать одного из многих классов, которые убывают от AbstractButton class. Следующая таблица показывает определенный с помощью Swing AbstractButton подклассы, которые Вы могли бы хотеть использовать:

Во-первых, этот раздел объясняет основной API кнопки это AbstractButton определяет — и таким образом все кнопки Swing имеют вместе. Затем, это описывает небольшое количество API это JButton добавляет к AbstractButton. После этого этот раздел показывает Вам, как использовать специализированный API, чтобы реализовать флажки и переключатели.

Как Использовать Общий API Кнопки

Вот изображение приложения, которое выводит на экран три кнопки:

Как ButtonDemo шоу в качестве примера, кнопка Swing может вывести на экран и текст и изображение. В ButtonDemo, у каждой кнопки есть свой текст в различном месте относительно ее изображения. Подчеркнутая буква в тексте каждой кнопки показывает мнемосхему — альтернативу клавиатуры — для каждой кнопки. В большинстве взгляда и чувств, пользователь может нажать кнопку, нажимая клавишу Alt и мнемосхему. Например, Alt-M нажал бы кнопку Middle в ButtonDemo.

Когда кнопка отключается, стиль автоматически генерирует отключенное появление кнопки. Однако, Вы могли обеспечить изображение, которое будет заменено нормальное изображение. Например, Вы могли обеспечить серые версии изображений, используемых в левых и правых кнопках.

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

Ниже код от ButtonDemo.java это создает кнопки в предыдущем примере и реагирует на нажатия кнопок. Полужирный код является кодом, который остался бы, если бы у кнопок не было никаких изображений.

//In initialization code:
    ImageIcon leftButtonIcon = createImageIcon("images/right.gif");
    ImageIcon middleButtonIcon = createImageIcon("images/middle.gif");
    ImageIcon rightButtonIcon = createImageIcon("images/left.gif");

    b1 = new JButton("Disable middle button", leftButtonIcon);
    b1.setVerticalTextPosition(AbstractButton.CENTER);
    b1.setHorizontalTextPosition(AbstractButton.LEADING); //aka LEFT, for left-to-right locales
    b1.setMnemonic(KeyEvent.VK_D);
    b1.setActionCommand("disable");

    b2 = new JButton("Middle button", middleButtonIcon);
    b2.setVerticalTextPosition(AbstractButton.BOTTOM);
    b2.setHorizontalTextPosition(AbstractButton.CENTER);
    b2.setMnemonic(KeyEvent.VK_M);

    b3 = new JButton("Enable middle button", rightButtonIcon);
    //Use the default text position of CENTER, TRAILING (RIGHT).
    b3.setMnemonic(KeyEvent.VK_E);
    b3.setActionCommand("enable");
    b3.setEnabled(false);

    //Listen for actions on buttons 1 and 3.
    b1.addActionListener(this);
    b3.addActionListener(this);

    b1.setToolTipText("Click this button to disable "
                      + "the middle button.");
    b2.setToolTipText("This middle button does nothing "
                      + "when you click it.");
    b3.setToolTipText("Click this button to enable the "
                      + "middle button.");
    ...
}

public void actionPerformed(ActionEvent e) {
    if ("disable".equals(e.getActionCommand())) {
        b2.setEnabled(false);
        b1.setEnabled(false);
        b3.setEnabled(true);
    } else {
        b2.setEnabled(true);
        b1.setEnabled(true);
        b3.setEnabled(false);
    }
} 

protected static ImageIcon createImageIcon(String path) {
    java.net.URL imgURL = ButtonDemo.class.getResource(path);
    ...//error handling omitted for clarity...
    return new ImageIcon(imgURL);
}

Как Использовать Функции JButton

Обычные кнопки — JButton у объектов — есть только немного больше функциональности чем AbstractButton class обеспечивает: можно сделать a JButton будьте кнопкой значения по умолчанию.

Самое большее одна кнопка в высокоуровневом контейнере может быть кнопкой значения по умолчанию. У кнопки значения по умолчанию обычно есть выделенное появление и действия, по которым щелкают всякий раз, когда у высокоуровневого контейнера есть клавиатурный фокус, и пользователь нажимает клавишу Return или клавишу Enter. Вот изображение диалогового окна, реализованного в примере ListDialog, в котором кнопка Set является кнопкой значения по умолчанию:

Вы устанавливаете кнопку значения по умолчанию, вызывая setDefaultButton метод на высокоуровневой корневой области контейнера. Вот код, который устанавливает кнопку значения по умолчанию для ListDialog пример:

//In the constructor for a JDialog subclass:
getRootPane().setDefaultButton(setButton);

Точная реализация функции кнопки значения по умолчанию зависит от стили. Например, в стили Windows, кнопка значения по умолчанию изменяется на то, какой бы ни у кнопки есть фокус, так, чтобы нажатие Вошло, нажимает фокусируемую кнопку. Когда ни у какой кнопки нет фокуса, кнопка, которую Вы первоначально определили, поскольку кнопка значения по умолчанию становится кнопкой значения по умолчанию снова.

Как Использовать Флажки

JCheckBox class оказывает поддержку для кнопок флажка. Можно также поместить флажки в меню, используя JCheckBoxMenuItem class. Поскольку JCheckBox и JCheckBoxMenuItem наследуйтесь от AbstractButton, У флажков Swing есть все обычные характеристики кнопки, как обсуждено ранее в этом разделе. Например, можно определить изображения, которые будут использоваться во флажках.

Флажки подобны переключателям, но их модель выбора отличается, условно. Любое число флажков в группе — ни одного, некоторых, или всех — не может быть выбрано. У группы переключателей, с другой стороны, может быть только одна нажатая кнопка.

Вот изображение приложения, которое использует четыре флажка, чтобы настроить мультфильм:

Флажок генерирует одно событие элемента и одно событие действия на щелчок. Обычно, Вы слушаете только для событий элемента, так как они позволяют Вам определять, снял ли выбранный щелчок или флажок. Ниже код от CheckBoxDemo.java это создает флажки в предыдущем примере и реагирует на щелчки.

//In initialization code:
    chinButton = new JCheckBox("Chin");
    chinButton.setMnemonic(KeyEvent.VK_C); 
    chinButton.setSelected(true);

    glassesButton = new JCheckBox("Glasses");
    glassesButton.setMnemonic(KeyEvent.VK_G); 
    glassesButton.setSelected(true);

    hairButton = new JCheckBox("Hair");
    hairButton.setMnemonic(KeyEvent.VK_H); 
    hairButton.setSelected(true);

    teethButton = new JCheckBox("Teeth");
    teethButton.setMnemonic(KeyEvent.VK_T); 
    teethButton.setSelected(true);

    //Register a listener for the check boxes.
    chinButton.addItemListener(this);
    glassesButton.addItemListener(this);
    hairButton.addItemListener(this);
    teethButton.addItemListener(this);
...
public void itemStateChanged(ItemEvent e) {
    ...
    Object source = e.getItemSelectable();

    if (source == chinButton) {
        //...make a note of it...
    } else if (source == glassesButton) {
        //...make a note of it...
    } else if (source == hairButton) {
        //...make a note of it...
    } else if (source == teethButton) {
        //...make a note of it...
    }

    if (e.getStateChange() == ItemEvent.DESELECTED)
        //...make a note of it...
    ...
    updatePicture();
}

Как Использовать Переключатели

Переключатели являются группами кнопок, в которых, условно, за один раз может быть нажата только одна кнопка. Выпуск Swing поддерживает переключатели с JRadioButton и ButtonGroup классы. Чтобы поместить переключатель в меню, используйте JRadioButtonMenuItem class. Другими способами вывести на экран варианты "один из многих" являются поля комбинированного списка и списки. Переключатели выглядят подобными флажкам, но, условно, флажки не устанавливают границ того, сколько элементов может быть выбрано за один раз.

Поскольку JRadioButton наследовался от AbstractButton, У переключателей Swing есть все обычные характеристики кнопки, как обсуждено ранее в этом разделе. Например, можно определить изображение, выведенное на экран в переключателе.

Вот изображение приложения, которое использует пять переключателей, чтобы позволить Вам выбирать, какой вид домашнего животного выводится на экран:

Каждый раз пользователь щелкает по переключателю (даже если он был уже выбран), кнопка запускает событие действия. Одно или два события элемента также имеют место — один от кнопки, которая была только нажата, и другой от кнопки, которая потеряла выбор (если любой). Обычно, Вы обрабатываете щелчки переключателя, используя слушателя действия.

Ниже код от RadioButtonDemo.java это создает переключатели в предыдущем примере и реагирует на щелчки.

//In initialization code:
    //Create the radio buttons.
    JRadioButton birdButton = new JRadioButton(birdString);
    birdButton.setMnemonic(KeyEvent.VK_B);
    birdButton.setActionCommand(birdString);
    birdButton.setSelected(true);

    JRadioButton catButton = new JRadioButton(catString);
    catButton.setMnemonic(KeyEvent.VK_C);
    catButton.setActionCommand(catString);

    JRadioButton dogButton = new JRadioButton(dogString);
    dogButton.setMnemonic(KeyEvent.VK_D);
    dogButton.setActionCommand(dogString);

    JRadioButton rabbitButton = new JRadioButton(rabbitString);
    rabbitButton.setMnemonic(KeyEvent.VK_R);
    rabbitButton.setActionCommand(rabbitString);

    JRadioButton pigButton = new JRadioButton(pigString);
    pigButton.setMnemonic(KeyEvent.VK_P);
    pigButton.setActionCommand(pigString);

    //Group the radio buttons.
    ButtonGroup group = new ButtonGroup();
    group.add(birdButton);
    group.add(catButton);
    group.add(dogButton);
    group.add(rabbitButton);
    group.add(pigButton);

    //Register a listener for the radio buttons.
    birdButton.addActionListener(this);
    catButton.addActionListener(this);
    dogButton.addActionListener(this);
    rabbitButton.addActionListener(this);
    pigButton.addActionListener(this);
...
public void actionPerformed(ActionEvent e) {
    picture.setIcon(new ImageIcon("images/" 
                                  + e.getActionCommand() 
                                  + ".gif"));
}

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

Следует обычно инициализировать группу переключателей так, чтобы каждый был выбран. Однако, API не осуществляет это правило — у группы переключателей не может быть никакого начального выбора. Как только пользователь сделал выбор, точно одна кнопка нажимается с тех пор.

API Кнопки

Следующие таблицы приводят обычно используемый связанный с кнопкой API. Другие методы Вы могли бы вызвать, такой как setFont и setForeground, перечисляются в таблицах API в Классе JComponent.

API для того, чтобы использовать кнопки попадает в эти категории:

• Установка или Получение Содержания Кнопки
• Точная настройка Появление Кнопки
• Реализация Функциональности Кнопки
• Конструкторы Флажка
• Конструкторы Переключателя
• Конструкторы Выключателя
• Конструкторы/Методы Commonly Used Button Group

Примеры, который Использование Различные Виды Кнопок

Следующие примеры используют кнопки. Также см. Примеры, что Панели инструментов Использования, который перечисляет программы, которые добавляют JButton объекты к JToolBars.

Можно узнать больше о компонентах кнопки JavaFX из следующих документов:

• Используя JavaFX Средства управления UI: Кнопка
• Используя JavaFX Средства управления UI: Переключатель
• Используя JavaFX Средства управления UI: Выключатель
• Используя JavaFX Средства управления UI: Флажок