UIKeyCommand

Наследование

NSObject
UIKeyCommand

NSObject
UIKeyCommand

Соответствует

Оператор импорта

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 7.0 и позже.

UIKeyCommand класс указывает нажатия клавиш, выполняемые на аппаратной клавиатуре и получающемся действии, которое должно иметь место. Аппаратные клавиатуры позволяют пользователю удерживать Управление, Опцию, Команду, или другую модифицирующую клавишу и нажимать ключ в комбинации, чтобы инициировать команды такой, как сокращено, скопировать, или вставка. Можно использовать экземпляры этого класса для определения пользовательских последовательностей команды, которые распознает приложение, и затем обеспечьте надлежащий ответ.

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

Система всегда имеет первую возможность обработать ключевые команды. Ключевые команды, отображающиеся на известные системные события (такой, как сокращено, копия и вставка) автоматически направляются к надлежащим методам респондента. Для других ключевых команд UIKit ищет объект в цепочке респондента с ключевым объектом команды, соответствующим нажатые клавиши. Если это находит такой объект, это тогда обходит поиск цепочки респондента первого объекта, реализующего соответствующий метод действия и вызывающего первый, который это находит.

Создание ключевого объекта команды


    
    init (input:modifierFlags:action:)
    + keyCommandWithInput:modifierFlags:action:

Создает и возвращает новый ключевой объект команды, соответствующий указанный ввод.

Объявление

Swift

init(input input: String, modifierFlags modifierFlags: UIKeyModifierFlags, action action: Selector) -> UIKeyCommand

Objective C

+ (UIKeyCommand *)keyCommandWithInput:(NSString *)input modifierFlags:(UIKeyModifierFlags)modifierFlags action:(SEL)action

Параметры

`input`	Клавиши, которые должны быть нажаты пользователем. Строка должна содержать один или несколько символов, соответствующих нажатым клавишам. Для списка специальных символов, не имеющих текстового представления, посмотрите `“Input Strings for Special Keys”`.
`modifierFlags`	Битовая маска модифицирующих клавиш, которые должны быть нажаты. Можно использовать этот параметр для указания, какие модифицирующие клавиши (Команда, Опция, и т.д.) должны также быть нажаты пользователем. Можно указать больше чем одну модифицирующую клавишу. Для списка возможных значений посмотрите `“UIKeyModifierFlags”`.
`action`	Метод действия выполниться на объекте респондента.

Возвращаемое значение

Ключевой объект команды.

Обсуждение

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

Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

Получение ключевых атрибутов команды

input Свойство

Строка символов, соответствующих клавишам, которые должны быть нажаты для соответствия этой ключевой команды. (только для чтения)

Объявление

Swift

var input: String { get }

Objective C

@property(nonatomic, readonly) NSString *input

Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.
modifierFlags Свойство

Битовая маска флагов модификатора, которые должны быть нажаты для соответствия этой ключевой команды. (только для чтения)

Объявление

Swift

var modifierFlags: UIKeyModifierFlags { get }

Objective C

@property(nonatomic, readonly) UIKeyModifierFlags modifierFlags

Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

Константы

UIKeyModifierFlags
Эти константы указывают, какие модифицирующие клавиши нажимаются.

Объявление

Swift

struct UIKeyModifierFlags : RawOptionSetType { init(_ rawValue: Int) init(rawValue rawValue: Int) static var AlphaShift: UIKeyModifierFlags { get } static var Shift: UIKeyModifierFlags { get } static var Control: UIKeyModifierFlags { get } static var Alternate: UIKeyModifierFlags { get } static var Command: UIKeyModifierFlags { get } static var NumericPad: UIKeyModifierFlags { get } }

Objective C

typedef { UIKeyModifierAlphaShift = 1 << 16, UIKeyModifierShift = 1 << 17, UIKeyModifierControl = 1 << 18, UIKeyModifierAlternate = 1 << 19, UIKeyModifierCommand = 1 << 20, UIKeyModifierNumericPad = 1 << 21, } UIKeyModifierFlags;

Константы
- AlphaShift
  
  UIKeyModifierAlphaShift
  
  Клавиша Caps Lock в настоящее время занята.
  
  Доступный в iOS 7.0 и позже.
- Shift
  
  UIKeyModifierShift
  
  Клавиша Shift нажимается.
  
  Доступный в iOS 7.0 и позже.
- Control
  
  UIKeyModifierControl
  
  Клавиша CTRL нажимается.
  
  Доступный в iOS 7.0 и позже.
- Alternate
  
  UIKeyModifierAlternate
  
  Функциональная клавиша нажимается.
  
  Доступный в iOS 7.0 и позже.
- Command
  
  UIKeyModifierCommand
  
  Командная клавиша нажимается.
  
  Доступный в iOS 7.0 и позже.
- NumericPad
  
  UIKeyModifierNumericPad
  
  Ключ расположен на цифровой клавиатуре.
  
  Доступный в iOS 7.0 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Объявление

Swift

let UIKeyInputUpArrow: String let UIKeyInputDownArrow: String let UIKeyInputLeftArrow: String let UIKeyInputRightArrow: String let UIKeyInputEscape: String

Objective C

NSString *const UIKeyInputUpArrow; NSString *const UIKeyInputDownArrow; NSString *const UIKeyInputLeftArrow; NSString *const UIKeyInputRightArrow; NSString *const UIKeyInputEscape;

Константы
- UIKeyInputUpArrow
  
  Строка, представляющая клавишу со стрелкой вверх.
  
  Доступный в iOS 7.0 и позже.
- UIKeyInputDownArrow
  
  Строка, представляющая клавишу со стрелкой вниз.
  
  Доступный в iOS 7.0 и позже.
- UIKeyInputLeftArrow
  
  Строка, представляющая клавишу со стрелкой влево.
  
  Доступный в iOS 7.0 и позже.
- UIKeyInputRightArrow
  
  Строка, представляющая клавишу со стрелкой вправо.
  
  Доступный в iOS 7.0 и позже.
- UIKeyInputEscape
  
  Строка, представляющая Клавишу выхода.
  
  Доступный в iOS 7.0 и позже.