Класс KeyCharacterCombination

java.lang.Object

javafx.scene.input.KeyCombination

javafx.scene.input.KeyCharacterCombination

public final class KeyCharacterCombination extends KeyCombination

Этот класс представляет собой комбинацию клавиш, в которой основная клавиша задаётся своим символом. Такая комбинация клавиш зависит от конфигурации функциональной раскладки клавиатуры, настроенной пользователем во время сопоставления комбинации клавиш.

Since:: JavaFX 2.0

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

Вложенные классы/интерфейсы, объявленные в классе javafx.scene.input.KeyCombination

KeyCombination.Modifier, KeyCombination.ModifierValue

Краткое описание полей

Поля, объявленные в классе javafx.scene.input.KeyCombination

ALT_ANY, ALT_DOWN, CONTROL_ANY, CONTROL_DOWN, META_ANY, META_DOWN, NO_MATCH, SHIFT_ANY, SHIFT_DOWN, SHORTCUT_ANY, SHORTCUT_DOWN

Краткое описание конструкторов

Конструктор	Описание
`KeyCharacterCombination(String character, KeyCombination.Modifier... modifiers)`	Создаёт объект `KeyCharacterCombination` для заданного символа основной клавиши и заданного списка модификаторов.
`KeyCharacterCombination(String character, KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)`	Создаёт объект `KeyCharacterCombination` для заданного символа основной клавиши и с явным указанием всех модификаторов клавиш.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Проверяет, равен ли этот объект `KeyCharacterCombination` заданному объекту.
`final String`	`getCharacter()`	Возвращает символ клавиши, связанный с этой комбинацией клавиш.
`String`	`getName()`	Возвращает строковое представление этого объекта `KeyCharacterCombination`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта `KeyCharacterCombination`.
`boolean`	`match(KeyEvent event)`	Проверяет, соответствует ли эта комбинация клавиш комбинации клавиш в данном объекте `KeyEvent`.

Методы, объявленные в классе javafx.scene.input.KeyCombination

getAlt, getControl, getDisplayText, getMeta, getShift, getShortcut, keyCombination, toString, valueOf

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

KeyCharacterCombination

public KeyCharacterCombination(String character, KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)

Создаёт объект KeyCharacterCombination для заданного символа основной клавиши и с явным указанием всех модификаторов клавиш. Каждый модификатор клавиши может быть установлен в PRESSED, RELEASED или IGNORED.

Parameters:: character - символ основной клавиши; shift - значение модификатора клавиши shift; control - значение модификатора клавиши control; alt - значение модификатора клавиши alt; meta - значение модификатора клавиши meta; shortcut - значение модификатора клавиши shortcut

KeyCharacterCombination

public KeyCharacterCombination(String character, KeyCombination.Modifier... modifiers)

Создаёт объект KeyCharacterCombination для заданного символа основной клавиши и заданного списка модификаторов. Все модификаторы клавиш, которые не указаны явно, устанавливаются по умолчанию RELEASED.

Все возможные модификаторы, которые изменяют значение по умолчанию, определены как константы в классе KeyCombination.

Parameters:: character - символ основной клавиши; modifiers - список модификаторов клавиш и соответствующих значений

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

getCharacter

public final String getCharacter()

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

Returns:: Символ клавиши, связанный с этой комбинацией клавиш

match

public boolean match(KeyEvent event)

Проверяет, соответствует ли эта комбинация клавиш комбинации клавиш в данном объекте KeyEvent. Сначала символ клавиши этого объекта преобразуется в код клавиши, способный генерировать этот символ в текущей раскладке клавиатуры, а затем полученный код клавиши вместе с модификаторами клавиш сравниваются с кодом клавиши и модификаторами клавиш из объекта KeyEvent. Это означает, что метод может вернуть true только для событий KEY_PRESSED и KEY_RELEASED, но не для событий KEY_TYPED, которые не имеют допустимых кодов клавиш.

Overrides:: match в классе KeyCombination
Parameters:: event - событие нажатия клавиши
Returns:: true, если комбинации клавиш совпадают, false в противном случае

getName

public String getName()

Возвращает строковое представление этого объекта KeyCharacterCombination.

Строковое представление состоит из разделов, разделенных знаками плюс. Каждый раздел указывает либо модификатор клавиши, либо основную клавишу.

Раздел модификатора клавиши содержит имя модификатора клавиши. Он может быть префиксрован ключевым словом Ignored. Модификатор клавиши без префикса подразумевает его значение PRESSED, в то время как префиксная версия подразумевает значение IGNORED. Если какая-либо клавиша модификатора вообще не указана в строке, это означает, что она имеет значение по умолчанию RELEASED.

Раздел основной клавиши содержит символ основной клавиши в одинарных кавычках и является последним разделом в возвращаемой строке.

Overrides:: getName в классе KeyCombination
Returns:: строковое представление этого объекта KeyCharacterCombination

equals

public boolean equals(Object obj)

Проверяет, равен ли этот объект KeyCharacterCombination заданному объекту.

Overrides:: equals в классе KeyCombination
Parameters:: obj - сравниваемый объект
Returns:: true, если объекты равны, false в противном случае

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого объекта KeyCharacterCombination.

Overrides:: hashCode в классе KeyCombination
Returns:: значение хэш-кода

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.