source: trunk/Cocoa/Pester/Source/NJRHotKeyManager.m @ 559

Last change on this file since 559 was 559, checked in by Nicholas Riley, 10 years ago

NJRHotKeyManager.m: Remove unused "err" variable.

File size: 6.4 KB
Line 
1//
2//  NJRHotKeyManager.m
3//  Pester
4//
5//  Created by Nicholas Riley on Tue Apr 01 2003.
6//  Copyright (c) 2003 Nicholas Riley. All rights reserved.
7//
8
9// based on HotKeyCenter, by Quentin Carnicelli
10// renamed, reorganized, cleaned up, pre-10.2 support removed
11
12#import "NJRHotKeyManager.h"
13#import "NJRHotKey.h"
14#import <Carbon/Carbon.h>
15
16const OSType kHotKeyManagerSignature = 'NHKM';
17
18@interface _NJRHotKeyShortcut : NSObject {
19    @public
20    BOOL isRegistered;
21    EventHotKeyRef hotKeyRef;
22    NJRHotKey *hotKey;
23    id target;
24    SEL action;
25}
26@end
27
28@implementation _NJRHotKeyShortcut
29
30- (void)dealloc;
31{
32    [hotKey release];
33    [target release];
34    [super dealloc];
35}
36
37@end
38
39pascal OSErr keyEventHandler(EventHandlerCallRef inHandlerRef, EventRef inEvent, void *refCon);
40
41@interface NJRHotKeyManager (Private)
42- (OSStatus)_handleHotKeyEvent:(EventRef)inEvent;
43- (BOOL)_registerHotKeyIfNeeded:(_NJRHotKeyShortcut *)shortcut;
44- (void)_unregisterHotKeyIfNeeded:(_NJRHotKeyShortcut *)shortcut;
45- (void)_hotKeyDown:(_NJRHotKeyShortcut *)hotKey;
46- (void)_hotKeyUp:(_NJRHotKeyShortcut *)hotKey;
47- (void)_hotKeyDownWithRef:(EventHotKeyRef)ref;
48- (void)_hotKeyUpWithRef:(EventHotKeyRef)ref;
49- (_NJRHotKeyShortcut *)_findShortcutWithRef:(EventHotKeyRef)ref;
50@end
51
52@implementation NJRHotKeyManager
53
54+ (NJRHotKeyManager *)sharedManager;
55{
56    static NJRHotKeyManager *manager = nil;
57
58    if (manager == nil) {
59        manager = [[self alloc] init];
60
61        EventTypeSpec eventSpec[2] = {
62           { kEventClassKeyboard, kEventHotKeyPressed },
63           { kEventClassKeyboard, kEventHotKeyReleased }
64        };
65
66        InstallEventHandler(GetEventDispatcherTarget(),
67                            NewEventHandlerUPP((EventHandlerProcPtr) keyEventHandler),
68                            2, eventSpec, nil, nil);
69    }
70    return manager;
71}
72
73- (id)init;
74{
75    if ( (self = [super init]) != nil) {
76        shortcutsEnabled = YES;
77        shortcuts = [[NSMutableDictionary alloc] init];
78    }
79
80    return self;
81}
82
83- (void)dealloc;
84{
85    [shortcuts release];
86    [super dealloc];
87}
88
89#pragma mark -
90
91- (BOOL)addShortcutWithIdentifier:(NSString *)identifier hotKey:(NJRHotKey *)hotKey target:(id)target action:(SEL)action;
92{
93    NSParameterAssert(identifier != nil);
94    NSParameterAssert(hotKey != nil);
95    NSParameterAssert(target != nil);
96    NSParameterAssert(action != nil);
97
98    if ([shortcuts objectForKey: identifier] != nil)
99        [self removeShortcutWithIdentifier: identifier];
100
101    _NJRHotKeyShortcut *newShortcut = [[_NJRHotKeyShortcut alloc] init];
102    newShortcut->isRegistered = NO;
103    newShortcut->hotKeyRef = nil;
104    newShortcut->hotKey = [hotKey retain];
105    newShortcut->target = [target retain];
106    newShortcut->action = action;
107
108    [shortcuts setObject: newShortcut forKey: identifier];
109    [newShortcut release];
110   
111    return [self _registerHotKeyIfNeeded: newShortcut];
112}
113
114- (void)removeShortcutWithIdentifier:(NSString *)identifier;
115{
116    _NJRHotKeyShortcut *hotKey = [shortcuts objectForKey: identifier];
117
118    if (hotKey == nil) return;
119    [self _unregisterHotKeyIfNeeded: hotKey];
120    [shortcuts removeObjectForKey: identifier];
121}
122
123- (NSArray *)shortcutIdentifiers;
124{
125    return [shortcuts allKeys];
126}
127
128- (NJRHotKey *)hotKeyForShortcutWithIdentifier:(NSString *)identifier;
129{
130    _NJRHotKeyShortcut *hotKey = [shortcuts objectForKey: identifier];
131
132    return (hotKey == nil ? nil : [[hotKey->hotKey retain] autorelease]);
133}
134
135- (void)setShortcutsEnabled:(BOOL)enabled;
136{
137    NSEnumerator *enumerator = [shortcuts objectEnumerator];
138    _NJRHotKeyShortcut *hotKey;
139
140    while ( (hotKey = [enumerator nextObject]) != nil) {
141        if (enabled)
142            [self _registerHotKeyIfNeeded: hotKey];
143        else
144            [self _unregisterHotKeyIfNeeded: hotKey];
145    }
146    shortcutsEnabled = enabled;
147}
148
149- (BOOL)shortcutsEnabled;
150{
151    return shortcutsEnabled;
152}
153
154#pragma mark -
155
156- (OSStatus)_handleHotKeyEvent:(EventRef)inEvent;
157{
158    OSStatus err;
159    EventHotKeyID hotKeyID;
160    _NJRHotKeyShortcut *shortcut;
161
162    NSAssert(GetEventClass(inEvent) == kEventClassKeyboard, @"Unhandled event class");
163
164    if ( (err = GetEventParameter(inEvent, kEventParamDirectObject, typeEventHotKeyID, nil,
165                                  sizeof(EventHotKeyID), nil, &hotKeyID)) != noErr)
166        return err;
167
168    NSAssert(hotKeyID.signature == kHotKeyManagerSignature, @"Unknown hot key");
169
170    shortcut = (_NJRHotKeyShortcut *)hotKeyID.id;
171    NSAssert(shortcut != nil, @"Got bad hot key");
172
173    switch (GetEventKind(inEvent)) {
174        case kEventHotKeyPressed:
175            [self _hotKeyDown: shortcut];
176            break;
177        case kEventHotKeyReleased:
178            [self _hotKeyUp: shortcut];
179            break;
180        default:
181            break;
182    }
183
184    return noErr;
185}
186
187#pragma mark -
188
189- (BOOL)_registerHotKeyIfNeeded:(_NJRHotKeyShortcut *)shortcut;
190{
191    NJRHotKey *hotKey;
192
193    NSParameterAssert(shortcut != nil);
194
195    hotKey = shortcut->hotKey;
196
197    if (shortcutsEnabled && !(shortcut->isRegistered)) {
198        EventHotKeyID keyID;
199
200        keyID.signature = kHotKeyManagerSignature;
201        keyID.id = (unsigned long)shortcut;
202        if (RegisterEventHotKey([hotKey keyCode], [hotKey modifiers], keyID, GetEventDispatcherTarget(), 0, &shortcut->hotKeyRef) != noErr)
203            return NO;
204
205        shortcut->isRegistered = YES;
206    }
207
208    return YES;
209}
210
211- (void)_unregisterHotKeyIfNeeded:(_NJRHotKeyShortcut *)shortcut;
212{
213    NSParameterAssert(shortcut != nil);
214 
215    if (shortcut->isRegistered && shortcut->hotKeyRef != nil)
216        UnregisterEventHotKey(shortcut->hotKeyRef);
217}
218
219- (void)_hotKeyDown:(_NJRHotKeyShortcut *)hotKey;
220{
221    id target = hotKey->target;
222    SEL action = hotKey->action;
223
224    [target performSelector: action withObject: self];
225}
226
227- (void)_hotKeyUp:(_NJRHotKeyShortcut *)hotKey;
228{
229}
230
231- (void)_hotKeyDownWithRef:(EventHotKeyRef)ref;
232{
233    _NJRHotKeyShortcut *hotKey = [self _findShortcutWithRef: ref];
234
235    if (hotKey != nil)
236        [self _hotKeyDown: hotKey];
237}
238
239- (void)_hotKeyUpWithRef:(EventHotKeyRef)ref;
240{
241}
242
243- (_NJRHotKeyShortcut *)_findShortcutWithRef:(EventHotKeyRef)ref;
244{
245    NSEnumerator *enumerator = [shortcuts objectEnumerator];
246    _NJRHotKeyShortcut *hotKey;
247
248    while ( (hotKey = [enumerator nextObject]) != nil) {
249        if (hotKey->hotKeyRef == ref)
250            return hotKey;
251    }
252    return nil;
253}
254
255@end
256
257pascal OSErr keyEventHandler(EventHandlerCallRef inHandlerRef, EventRef inEvent, void *refCon)
258{
259    return [[NJRHotKeyManager sharedManager] _handleHotKeyEvent: inEvent];
260}
Note: See TracBrowser for help on using the repository browser.