1// Copyright (c) 2010 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4 5#ifndef CHROME_BROWSER_UI_COCOA_RWHVM_EDITCOMMAND_HELPER_H_ 6#define CHROME_BROWSER_UI_COCOA_RWHVM_EDITCOMMAND_HELPER_H_ 7#pragma once 8 9#import <Cocoa/Cocoa.h> 10 11#include "base/basictypes.h" 12#include "base/hash_tables.h" 13#include "base/gtest_prod_util.h" 14#include "chrome/browser/renderer_host/render_widget_host_view_mac.h" 15 16// RenderWidgetHostViewMacEditCommandHelper is the real name of this class 17// but that's too long, so we use a shorter version. 18// 19// This class mimics the behavior of WebKit's WebView class in a way that makes 20// sense for Chrome. 21// 22// WebCore has the concept of "core commands", basically named actions such as 23// "Select All" and "Move Cursor Left". The commands are executed using their 24// string value by WebCore. 25// 26// This class is responsible for 2 things: 27// 1. Provide an abstraction to determine the enabled/disabled state of menu 28// items that correspond to edit commands. 29// 2. Hook up a bunch of objc selectors to the RenderWidgetHostViewCocoa object. 30// (note that this is not a misspelling of RenderWidgetHostViewMac, it's in 31// fact a distinct object) When these selectors are called, the relevant 32// edit command is executed in WebCore. 33class RWHVMEditCommandHelper { 34 FRIEND_TEST_ALL_PREFIXES(RWHVMEditCommandHelperTest, 35 TestAddEditingSelectorsToClass); 36 FRIEND_TEST_ALL_PREFIXES(RWHVMEditCommandHelperTest, 37 TestEditingCommandDelivery); 38 39 public: 40 RWHVMEditCommandHelper(); 41 ~RWHVMEditCommandHelper(); 42 43 // Adds editing selectors to the objc class using the objc runtime APIs. 44 // Each selector is connected to a single c method which forwards the message 45 // to WebCore's ExecuteEditCommand() function. 46 // This method is idempotent. 47 // The class passed in must conform to the RenderWidgetHostViewMacOwner 48 // protocol. 49 void AddEditingSelectorsToClass(Class klass); 50 51 // Is a given menu item currently enabled? 52 // SEL - the objc selector currently associated with an NSMenuItem. 53 // owner - An object we can retrieve a RenderWidgetHostViewMac from to 54 // determine the command states. 55 bool IsMenuItemEnabled(SEL item_action, 56 id<RenderWidgetHostViewMacOwner> owner); 57 58 // Converts an editing selector into a command name that can be sent to 59 // webkit. 60 static NSString* CommandNameForSelector(SEL selector); 61 62 protected: 63 // Gets a list of all the selectors that AddEditingSelectorsToClass adds to 64 // the aforementioned class. 65 // returns an array of NSStrings WITHOUT the trailing ':'s. 66 NSArray* GetEditSelectorNames(); 67 68 private: 69 base::hash_set<std::string> edit_command_set_; 70 DISALLOW_COPY_AND_ASSIGN(RWHVMEditCommandHelper); 71}; 72 73#endif // CHROME_BROWSER_UI_COCOA_RWHVM_EDITCOMMAND_HELPER_H_ 74