Cocoa: setting the key equivalent

Question

i want to set the key equivalent of a menuitem with [menuitem setKeyEquivalent:(NSString *)s], how can i do that if i have multiple modifiers ?

i tried:

unichar shift = NSShiftKeyMask, cmd = NSCommandKeyMask;
NSMutableString *keyequiv = [[NSMutableString alloc] init];

[keyequiv appendString:[NSString stringWithCharacter:&shift, 1]];
[keyequiv appendString:[NSString stringWithCharacter:&cmd, 1]];
[keyequiv appendString:@"x"];
[menuItem setKeyEquivalent:keyequivalent];

but that doesnt work.

Wrong

Any way to setup F1 as the key equivalent? thx – Saphead

Answer 1

The modifier key masks are just that: masks, not characters. You can't insert them into the key equivalent string. To apply them, use setKeyEquivalentModifierMask:

[menuItem setKeyEquivalentModifierMask: NSShiftKeyMask | NSCommandKeyMask];
[menuItem setKeyEquivalent:@"x"];

As with any other mask, use the bitwise OR operator | to form combinations. See "Setting a Menu Item's Key Equivalent" for more details.

Behling

Note that NSShiftKeyMask, NSCommandKeyMask etc are deprecated. Instead use NSEventModifierFlagShift, NSEventModifierFlagCommand , etc. – Diamante

Answer 2

The setKeyEquivalent: method is used to specify the character which triggers the command, but not the modifiers. It will set default modifiers by examining the character you pass. If you pass a lowercase character, it will use just command. If you pass an uppercase character, it will use shift+command. Because of this, you simply need to do this for shift+command+x:

[menuItem setKeyEquivalent:@"X"];

If you want to use other modifiers, you then call setKeyEquivalentModifierMask: with the proper constants, chosen from NSShiftKeyMask, NSAlternateKeyMask (option), NSCommandKeyMask, and NSControlKeyMask.

Orphanage

Answer 3

Example for Swift 2.0:

let key = String(utf16CodeUnits: [unichar(NSBackspaceCharacter)], count: 1) as String
item.keyEquivalentModifierMask = Int(NSEventModifierFlags.CommandKeyMask.rawValue | NSEventModifierFlags.ControlKeyMask.rawValue)
item.keyEquivalent = key

Vickery

Answer 4

Example for Swift 3.0:

item.keyEquivalent = "x"
item.keyEquivalentModifierMask = [NSAlternateKeyMask, NSCommandKeyMask]

Jessicajessie

Answer 5

Example for Swift 5:

item.keyEquivalent = "q"
item.keyEquivalentModifierMask = [.command]

Pusey

item.keyEquivalentModifierMask = .option.union(.command) – Beachhead