Обзор ключевых событий

Существенные факты о ключевых событиях, как представлено в Ключевых событиях и Пути Ключевых событий, являются следующим:

• Ключевые события имеют три определенных типа (NSEventType), каждый из которых связан с NSResponder метод:

  Постоянный тип события	Метод события
  NSKeyDown	keyDown:
  NSKeyUp	keyUp:
  NSFlagsChanged	flagsChanged:

  flagsChanged: метод может быть полезен для обнаружения нажатия модифицирующих клавиш без любой другой клавиши, нажатой одновременно. Например, если пользователь нажимает функциональную клавишу отдельно, Ваш объект респондента может обнаружить это в своей реализации flagsChanged:.

• Большинство ключевых событий — т.е. те, которые представляют символы, которые будут вставлены как текст — диспетчеризируется NSWindow объект связался с ключевым окном первому респонденту.

• Если первый респондент не обрабатывает событие, оно передает событие цепочка респондента (см. Цепочку Респондента).

• Путь поставки ключевого события варьируется согласно тому, представляет ли событие символ, ключевой эквивалент, действие клавиатуры или команду управления интерфейсом клавиатуры. Глобальный объект приложения (NSApp) сначала ищет ключевые эквиваленты и затем команды управления интерфейсом клавиатуры и обрабатывает их особенно (см. Путь Ключевых событий для подробных данных). Если событие не имеет ни один их, оно диспетчеризирует его NSWindow объект, представляющий ключевое окно, поочередно диспетчеризирующее событие первому респонденту в a keyDown: сообщение.

• Объект респондента определяет то, что ключевое событие представляет и обрабатывает его соответственно. В этой точке ключевое событие могло представлять любую из следующих вещей:

  • Действие клавиатуры, которое является сочетанием клавиш или сочетанием клавиш, связанным с селектором сообщения действия в словаре привязок клавиш (см. Привязки клавиш).

  • Специализированная команда или действие (одно не использование словаря привязок клавиш)

  • Символ или символы для вставки в текст

  Посмотрите Переопределение keyDown: Метод для получения дополнительной информации.

• Как с сообщениями ключевого события, от сообщения действия клавиатуры отказываются цепочка респондента, если первый респондент не обрабатывает его.

Переопределение keyDown: Метод

Большая часть респондента возражает (такие как пользовательские представления), обрабатывают ключевые события путем переопределения keyDown: метод, объявленный NSResponder. Объект может обработать событие всегда, это считает целесообразным. Текстовый объект обычно интерпретирует сообщение как запрос для вставки текста, в то время как рисованного объект мог бы только интересоваться несколькими ключами, теми, которые Удаляют и клавиши со стрелками как команды, чтобы удалить и переместить выбранные пункты. Как с событиями от нажатия мыши, объект респондента часто хочет запросить переданный - в NSEvent объект узнать больше о событии и получить данные это должно обработать его. Некоторые более полезные NSEvent методы для ключевых событий являются следующим:

• characters и charactersIgnoringModifiers— Респондент может извлечь данные символа Unicode, связанные с событием, и вставить его как текст или интерпретировать его как команды. charactersIgnoringModifiers метод игнорирует любое нажатие клавиши модификатора (за исключением Сдвига) при возврате символьных данных. Обратите внимание на то, что оба имен методов являются множественным числом, потому что нажатие клавиши может произвести больше чем один символ (например, «Е» составлен из и ‘' ‘).

• modifierFlags— Используя этот метод респондент может определить, были ли нажаты какие-либо модифицирующие клавиши.

• isARepeat— Этот метод говорит респонденту, была ли та же клавиша нажата быстро по очереди.

В реализации a keyDown: метод, респондент может извлечь символьные данные, содержавшие связанным NSEvent возразите и вставьте его в отображаемый текст; или это может интерпретировать символьные данные как сочетание клавиш или сочетание клавиш, или связывающееся с действием клавиатуры или запрашивающее некоторое специализированное поведение. Однако Набор Приложения обеспечивает некоторые удобные ярлыки для того, чтобы сделать это, описанное ниже.

- (void)keyDown:(NSEvent *)theEvent {

    [self interpretKeyEvents:[NSArray arrayWithObject:theEvent]];

}

// The following action methods are declared in NSResponder.h

- (void)insertTab:(id)sender {

    if ([[self window] firstResponder] == self) {

        [[self window] selectNextKeyView:self];

    }

}

- (void)insertBacktab:(id)sender {

    if ([[self window] firstResponder] == self) {

        [[self window] selectPreviousKeyView:self];

    }

}

- (void)insertText:(id)string {

    [super insertText:string];  // have superclass insert it

}

- (void)keyDown:(NSEvent *)theEvent {

    // Arrow keys are associated with the numeric keypad

    if ([theEvent modifierFlags] & NSNumericPadKeyMask) {

        [self interpretKeyEvents:[NSArray arrayWithObject:theEvent]];

    } else {

        [super keyDown:theEvent];

    }

}

-(IBAction)moveUp:(id)sender

{

    [self offsetLocationByX:0 andY: 10.0];

    [[self window] invalidateCursorRectsForView:self];

}

-(IBAction)moveDown:(id)sender

{

    [self offsetLocationByX:0 andY:-10.0];

    [[self window] invalidateCursorRectsForView:self];

}

-(IBAction)moveLeft:(id)sender

{

    [self offsetLocationByX:-10.0 andY:0.0];

    [[self window] invalidateCursorRectsForView:self];

}

-(IBAction)moveRight:(id)sender

{

    [self offsetLocationByX:10.0 andY:0.0];

    [[self window] invalidateCursorRectsForView:self];

}

enum {

    NSUpArrowFunctionKey            = 0xF700,

    NSDownArrowFunctionKey          = 0xF701,

    NSLeftArrowFunctionKey          = 0xF702,

    NSRightArrowFunctionKey         = 0xF703,

    NSF1FunctionKey                 = 0xF704,

    NSF2FunctionKey                 = 0xF705,

    NSF3FunctionKey                 = 0xF706,

    // other constants here

    NSUndoFunctionKey               = 0xF743,

    NSRedoFunctionKey               = 0xF744,

    NSFindFunctionKey               = 0xF745,

    NSHelpFunctionKey               = 0xF746,

    NSModeSwitchFunctionKey         = 0xF747

};

- (void)keyDown:(NSEvent *)theEvent {

    if ([theEvent modifierFlags] & NSNumericPadKeyMask) { // arrow keys have this mask

        NSString *theArrow = [theEvent charactersIgnoringModifiers];

        unichar keyChar = 0;

        if ( [theArrow length] == 0 )

            return;            // reject dead keys

        if ( [theArrow length] == 1 ) {

            keyChar = [theArrow characterAtIndex:0];

            if ( keyChar == NSLeftArrowFunctionKey ) {

                [self offsetLocationByX:-10.0 andY:0.0];

                [[self window] invalidateCursorRectsForView:self];

                return;

            }

            if ( keyChar == NSRightArrowFunctionKey ) {

                [self offsetLocationByX:10.0 andY:0.0];

                [[self window] invalidateCursorRectsForView:self];

                return;

            }

            if ( keyChar == NSUpArrowFunctionKey ) {

                [self offsetLocationByX:0 andY: 10.0];

                [[self window] invalidateCursorRectsForView:self];

                return;

            }

            if ( keyChar == NSDownArrowFunctionKey ) {

                [self offsetLocationByX:0 andY:-10.0];

                [[self window] invalidateCursorRectsForView:self];

                return;

            }

            [super keyDown:theEvent];

        }

    }

    [super keyDown:theEvent];

}

        unichar la = NSLeftArrowFunctionKey;

        NSString *laStr = [[[NSString alloc] initWithCharacters:&la length:1] autorelease];

        if ([theArrow isEqual:laStr]) {

            [self offsetLocationByX:-10.0 andY:0.0];

            [[self window] invalidateCursorRectsForView:self];

            return;

        }

Обработка ключевых эквивалентов

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

Приложение направляет ключевое эквивалентное событие путем отправки ему сначала вниз иерархии представления окна. Глобальная переменная NSApplication возразите диспетчеризирует события, которые это распознает как потенциальные ключевые эквиваленты (на основе присутствия флагов модификатора) в sendEvent: метод. Это отправляет a performKeyEquivalent: обменивайтесь сообщениями к ключу NSWindow объект. Этот объект передает ключевые эквиваленты вниз его иерархия представления путем вызова NSView реализация по умолчанию performKeyEquivalent:, который передает сообщение к каждому из его подпредставлений (включая контекстный и всплывающие меню), пока каждый не отвечает YES; если ни один не делает, это возвращается NO. Если никакой объект в иерархии представления не обрабатывает ключевой эквивалент, NSApp тогда отправляет performKeyEquivalent: к меню в строке меню. NSWindow подклассы отговорены переопределить performKeyEquivalent:.

Некоторые классы Какао, такой как NSButton, NSMenu, NSMatrix, и NSSavePanel, обеспечьте реализации по умолчанию performKeyEquivalent:. Например, можно установить клавишу Return как ключевой эквивалент NSButton возразите и, когда эта клавиша нажата, действия кнопки, как будто по ней щелкнули. Однако подклассы других классов Набора Приложения (включая пользовательские представления) должны обеспечить свои собственные реализации performKeyEquivalent:. Реализация должна извлечь символы для ключевого эквивалента от переданного - в NSEvent объект с помощью charactersIgnoringModifiers метод и затем исследует их, чтобы определить, являются ли они ключевым эквивалентом, он распознает. Это обрабатывает ключевой эквивалент очень, как это обработало бы ключевое событие в keyDown: (см. Переопределение keyDown: Метод). После обработки ключевого эквивалента должна возвратиться реализация YES. Если это не обрабатывает ключевой эквивалент, это должно или вызвать реализацию суперкласса performKeyEquivalent: или (если Вы знаете, суперкласс не обрабатывает ключевой эквивалент), возврат NO указать, что ключевой эквивалент должен быть передан далее вниз иерархия представления или к меню в строке меню.

Управление интерфейсом клавиатуры

Архитектура отгрузки события Какао обрабатывает определенные ключевые события как команды, чтобы переместить фокус управления в различный объект пользовательского интерфейса в окне, моделировать щелчок мышью по объекту, отклонить модальные окна и сделать выборы в объектах, позволяющих выборы. Эту возможность вызывают управлением интерфейсом клавиатуры. Большинство объектов пользовательского интерфейса, вовлеченных в управление интерфейсом клавиатуры, NSControl объекты, но объекты, которые не являются средствами управления, могут участвовать также. Когда объект имеет фокус управления, Набор Приложения рисует голубое ключевое фокусирующее кольцо вокруг границы объекта. Если полный доступ клавиатуры включен, ключи, перечисленные в Таблице 5-1, имеют установленный эффект.

Некоторые объекты, найденные на палитрах Interface Builder, не участвуют в управлении интерфейсом клавиатуры, такой как NSImageView, WebView, и PDFView объекты.

В дополнение к ключевому циклу представления окно может иметь ячейку кнопки по умолчанию, использующую Возврат (или Войдите), ключ как его ключевой эквивалент. Программно, можно отправить setDefaultButtonCell: к NSWindow возразите для установки этой ячейки кнопки; можно также установить его в Интерфейсном Разработчике путем устанавливания ключа ячейки кнопки, эквивалентного‘\r’в области Attributes окна Get Info. Ячейка кнопки по умолчанию рисует себя как фокальный элемент для управления интерфейсом клавиатуры, если другая ячейка кнопки не фокусируется на. В этом случае это временно рисует себя как нормальный и отключает его ключевой эквивалент. Клавиша выхода является другим ключом по умолчанию для управления интерфейсом клавиатуры в окне; это сразу прерывает модальный цикл.

Объекты пользовательского интерфейса, соединяющиеся вместе в окне, составляют ключевой цикл представления окна. Ключевой цикл представления является последовательностью NSView объекты соединились друг с другом через их nextKeyView свойство ( previousKeyView свойство при входе в обратное направление). Последнее представление в этой последовательности «циклы» назад к первому представлению. По умолчанию, NSWindow присваивает начального первого респондента и создает ключевой цикл представления с объектами, которые он находит. Если Вы хотите большее управление ключевым циклом представления, необходимо установить его использующий Интерфейсного Разработчика. Посмотрите страницы справки для Интерфейсного Разработчика для подробных данных процедуры.

Для его экземпляров для участия в циклах ключевого представления должно возвратиться пользовательское представление YES от acceptsFirstResponder. Путем выполнения так, это влияет на значение, возвращенное canBecomeKeyView метод. acceptsFirstResponder метод управляет, принимает ли респондент первое состояние респондента, когда его окно спрашивает его к (т.е. когда makeFirstResponder: вызывается с респондентом как параметр). canBecomeKeyView метод управляет, позволяет ли Набор Приложения снабжать вкладками к представлению. Это вызывает acceptsFirstResponder, но это также проверяет на другую информацию прежде, чем определить значение для возврата, такой как, скрыто ли представление и идет ли полный доступ клавиатуры. canBecomeKeyView метод редко переопределяется в то время как acceptsFirstResponder часто переопределяется.

NSView и NSWindow классы определяют много методов для того, чтобы настроить и пересечь ключевой цикл представления программно. Таблица 5-2 перечисляет некоторые более полезные.

Код в Перечислении 5-5 иллюстрирует, как можно было бы использовать некоторые из этих методов для управления циклом ключевого представления.

Перечисление 5-5  , Управляющее циклом ключевого представления

- (void)textDidEndEditing:(NSNotification *)notification {

    NSTextView *text = [notification object];

    unsigned whyEnd = [[[notification userInfo] objectForKey:@"NSTextMovement"] unsignedIntValue];

    NSTextView *newKeyView = text;

    // Unscroll the previous text.

    [text scrollRangeToVisible:NSMakeRange(0, 0)];

    if (whyEnd == NSTabTextMovement) {

        newKeyView = (NSTextView *)[text nextKeyView];

    } else if (whyEnd == NSBacktabTextMovement) {

        newKeyView = (NSTextView *)[text previousKeyView];

    }

    // Set the new key view and select its whole contents.

    [[text window] makeFirstResponder:newKeyView];

    [newKeyView setSelectedRange:NSMakeRange(0, [[newKeyView textStorage] length])];

}