[Mac] Move event hooks from CrApplication to BrowserCrApplication.

chrome/browser/chrome_browser_application_mac.h

-// Copyright (c) 2010 The Chromium Authors. All rights reserved.
+// Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_CHROME_BROWSER_APPLICATION_MAC_H_
 #define CHROME_BROWSER_CHROME_BROWSER_APPLICATION_MAC_H_
 #pragma once
 
 #ifdef __OBJC__
 
 #import "content/common/chrome_application_mac.h"
 
-@interface BrowserCrApplication : CrApplication
+// Event hooks must implement this protocol.
+@protocol CrApplicationEventHookProtocol
+- (void)hookForEvent:(NSEvent*)theEvent;
+@end
+
+@interface BrowserCrApplication : CrApplication {

[Robert Sesek, 2011/11/09 18:38:59]

 @private

[Scott Hess - ex-Googler, 2011/11/09 18:48:32]

Done.  If you haven't noticed, I get dinged for this every time.  I think
@private landed during my Objective-C interregnum.

+  // Array of objects implementing CrApplicationEventHookProtocol.
+  scoped_nsobject<NSMutableArray> eventHooks_;
+}
+
 // Our implementation of |-terminate:| only attempts to terminate the
 // application, i.e., begins a process which may lead to termination. This
 // method cancels that process.
 - (void)cancelTerminate:(id)sender;
+
+// Add or remove an event hook to be called for every sendEvent:
+// that the application receives.  These handlers are called before
+// the normal [NSApplication sendEvent:] call is made.
+
+// This is not a good alternative to a nested event loop.  It should
+// be used only when normal event logic and notification breaks down
+// (e.g. when clicking outside a canBecomeKey:NO window to "switch
+// context" out of it).
+- (void)addEventHook:(id<CrApplicationEventHookProtocol>)hook;
+- (void)removeEventHook:(id<CrApplicationEventHookProtocol>)hook;
 @end
 
 namespace chrome_browser_application_mac {
 
 // Bin for unknown exceptions. Exposed for testing purposes.
 extern const size_t kUnknownNSException;
 
 // Returns the histogram bin for |exception| if it is one we track
 // specifically, or |kUnknownNSException| if unknown.  Exposed for testing
 // purposes.
@@ skipping 13 matching lines @@
 
 // Calls -[NSApp terminate:].
 void Terminate();
 
 // Cancels a termination started by |Terminate()|.
 void CancelTerminate();
 
 }  // namespace chrome_browser_application_mac
 
 #endif  // CHROME_BROWSER_CHROME_BROWSER_APPLICATION_MAC_H_