// 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_CHROMEOS_STATUS_INPUT_METHOD_MENU_H_ #define CHROME_BROWSER_CHROMEOS_STATUS_INPUT_METHOD_MENU_H_ #pragma once #include #include "chrome/browser/chromeos/cros/input_method_library.h" #include "chrome/browser/chromeos/status/status_area_host.h" #include "chrome/browser/prefs/pref_member.h" #include "content/common/notification_observer.h" #include "content/common/notification_registrar.h" #include "content/common/notification_type.h" #include "ui/base/models/simple_menu_model.h" #include "views/controls/menu/menu_2.h" #include "views/controls/menu/view_menu_delegate.h" class PrefService; class SkBitmap; namespace chromeos { // A class for the dropdown menu for switching input method and keyboard layout. // Since the class provides the views::ViewMenuDelegate interface, it's easy to // create a button widget (e.g. views::MenuButton, chromeos::StatusAreaButton) // which shows the dropdown menu on click. class InputMethodMenu : public views::ViewMenuDelegate, public ui::MenuModel, public InputMethodLibrary::Observer, public NotificationObserver { public: InputMethodMenu(PrefService* pref_service, StatusAreaHost::ScreenMode screen_mode, bool for_out_of_box_experience_dialog); virtual ~InputMethodMenu(); // ui::MenuModel implementation. virtual bool HasIcons() const; virtual int GetItemCount() const; virtual ui::MenuModel::ItemType GetTypeAt(int index) const; virtual int GetCommandIdAt(int index) const; virtual string16 GetLabelAt(int index) const; virtual bool IsItemDynamicAt(int index) const; virtual bool GetAcceleratorAt(int index, ui::Accelerator* accelerator) const; virtual bool IsItemCheckedAt(int index) const; virtual int GetGroupIdAt(int index) const; virtual bool GetIconAt(int index, SkBitmap* icon); virtual ui::ButtonMenuItemModel* GetButtonMenuItemAt(int index) const; virtual bool IsEnabledAt(int index) const; virtual ui::MenuModel* GetSubmenuModelAt(int index) const; virtual void HighlightChangedTo(int index); virtual void ActivatedAt(int index); virtual void MenuWillShow(); virtual void SetMenuModelDelegate(ui::MenuModelDelegate* delegate); // views::ViewMenuDelegate implementation. Sub classes can override the method // to adjust the position of the menu. virtual void RunMenu(views::View* unused_source, const gfx::Point& pt); // InputMethodLibrary::Observer implementation. virtual void InputMethodChanged( InputMethodLibrary* obj, const InputMethodDescriptor& current_input_method, size_t num_active_input_methods); virtual void ActiveInputMethodsChanged( InputMethodLibrary* obj, const InputMethodDescriptor& current_input_method, size_t num_active_input_methods); virtual void PreferenceUpdateNeeded( InputMethodLibrary* obj, const InputMethodDescriptor& previous_input_method, const InputMethodDescriptor& current_input_method); virtual void PropertyListChanged( InputMethodLibrary* obj, const ImePropertyList& current_ime_properties); virtual void FirstObserverIsAdded(InputMethodLibrary* obj); // NotificationObserver implementation. virtual void Observe(NotificationType type, const NotificationSource& source, const NotificationDetails& details); // Sets the minimum width of the dropdown menu. void SetMinimumWidth(int width); // Rebuilds model and menu2 objects. void PrepareMenu(); // Registers input method preferences for the login screen. static void RegisterPrefs(PrefService* local_state); // Returns a string for the indicator on top right corner of the Chrome // window. The method is public for unit tests. static std::wstring GetTextForIndicator( const InputMethodDescriptor& input_method); // Returns a string for the drop-down menu and the tooltip for the indicator. // The method is public for unit tests. static std::wstring GetTextForMenu(const InputMethodDescriptor& input_method); protected: // Prepares menu: saves user metrics and rebuilds. void PrepareForMenuOpen(); // Returns menu2 object for language menu. views::Menu2& input_method_menu() { return input_method_menu_; } private: // Updates UI of a container of the menu (e.g. the "US" menu button in the // status area). Sub classes have to implement the interface for their own UI. virtual void UpdateUI(const std::string& input_method_id, // e.g. "mozc" const std::wstring& name, // e.g. "US", "INTL" const std::wstring& tooltip, size_t num_active_input_methods) = 0; // Sub classes have to implement the interface. This interface should return // true if the dropdown menu should show an item like "Customize languages // and input..." WebUI. virtual bool ShouldSupportConfigUI() = 0; // Sub classes have to implement the interface which opens an UI for // customizing languages and input. virtual void OpenConfigUI() = 0; // Parses |input_method| and then calls UpdateUI(). void UpdateUIFromInputMethod(const InputMethodDescriptor& input_method, size_t num_active_input_methods); // Rebuilds |model_|. This function should be called whenever // |input_method_descriptors_| is updated, or ImePropertiesChanged() is // called. void RebuildModel(); // Returns true if the zero-origin |index| points to one of the input methods. bool IndexIsInInputMethodList(int index) const; // Returns true if the zero-origin |index| points to one of the IME // properties. When returning true, |property_index| is updated so that // property_list.at(property_index) points to the menu item. bool GetPropertyIndex(int index, int* property_index) const; // Returns true if the zero-origin |index| points to the "Configure IME" menu // item. bool IndexPointsToConfigureImeMenuItem(int index) const; // The current input method list. scoped_ptr input_method_descriptors_; // Objects for reading/writing the Chrome prefs. StringPrefMember previous_input_method_pref_; StringPrefMember current_input_method_pref_; // We borrow ui::SimpleMenuModel implementation to maintain the current // content of the pop-up menu. The ui::MenuModel is implemented using this // |model_|. scoped_ptr model_; // The language menu which pops up when the button in status area is clicked. views::Menu2 input_method_menu_; int minimum_input_method_menu_width_; PrefService* pref_service_; NotificationRegistrar registrar_; // The mode of the host screen (e.g. browser, screen locker, login screen.) const StatusAreaHost::ScreenMode screen_mode_; // true if the menu is for a dialog in OOBE screen. In the dialog, we don't // use radio buttons. const bool for_out_of_box_experience_dialog_; DISALLOW_COPY_AND_ASSIGN(InputMethodMenu); }; } // namespace chromeos #endif // CHROME_BROWSER_CHROMEOS_STATUS_INPUT_METHOD_MENU_H_