chrome/browser/ui/cocoa/toolbar/toolbar_controller.h

   1 // Copyright (c) 2012 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_TOOLBAR_TOOLBAR_CONTROLLER_H_
   6 #define CHROME_BROWSER_UI_COCOA_TOOLBAR_TOOLBAR_CONTROLLER_H_
   7
   8 #import <Cocoa/Cocoa.h>
   9
  10 #include "base/mac/scoped_nsobject.h"
  11 #include "base/memory/scoped_ptr.h"
  12 #include "base/prefs/pref_member.h"
  13 #import "chrome/browser/ui/cocoa/command_observer_bridge.h"
  14 #import "chrome/browser/ui/cocoa/url_drop_target.h"
  15 #import "chrome/browser/ui/cocoa/view_resizer.h"
  16 #import "ui/base/cocoa/tracking_area.h"
  17
  18 @class AutocompleteTextField;
  19 @class AutocompleteTextFieldEditor;
  20 @class BackForwardMenuController;
  21 class Browser;
  22 @class BrowserActionsContainerView;
  23 @class BrowserActionsController;
  24 class CommandUpdater;
  25 class LocationBarViewMac;
  26 @class MenuButton;
  27 class Profile;
  28 @class ReloadButton;
  29 @class ToolbarButton;
  30 @class WrenchMenuController;
  31
  32 namespace content {
  33 class WebContents;
  34 }
  35
  36 namespace ToolbarControllerInternal {
  37 class NotificationBridge;
  38 }
  39
  40 // A controller for the toolbar in the browser window. Manages
  41 // updating the state for location bar and back/fwd/reload/go buttons.
  42 // Manages the bookmark bar and its position in the window relative to
  43 // the web content view.
  44
  45 @interface ToolbarController : NSViewController<CommandObserverProtocol,
  46                                                 URLDropTargetController> {
  47  @protected
  48   // The ordering is important for unit tests. If new items are added or the
  49   // ordering is changed, make sure to update |-toolbarViews| and the
  50   // corresponding enum in the unit tests.
  51   IBOutlet MenuButton* backButton_;
  52   IBOutlet MenuButton* forwardButton_;
  53   IBOutlet ReloadButton* reloadButton_;
  54   IBOutlet ToolbarButton* homeButton_;
  55   IBOutlet MenuButton* wrenchButton_;
  56   IBOutlet AutocompleteTextField* locationBar_;
  57   IBOutlet BrowserActionsContainerView* browserActionsContainerView_;
  58
  59  @private
  60   CommandUpdater* commands_;  // weak, one per window
  61   Profile* profile_;  // weak, one per window
  62   Browser* browser_;  // weak, one per window
  63   scoped_ptr<CommandObserverBridge> commandObserver_;
  64   scoped_ptr<LocationBarViewMac> locationBarView_;
  65   base::scoped_nsobject<AutocompleteTextFieldEditor>
  66       autocompleteTextFieldEditor_;
  67   id<ViewResizer> resizeDelegate_;  // weak
  68   base::scoped_nsobject<BackForwardMenuController> backMenuController_;
  69   base::scoped_nsobject<BackForwardMenuController> forwardMenuController_;
  70   base::scoped_nsobject<BrowserActionsController> browserActionsController_;
  71
  72   // Lazily-instantiated menu controller.
  73   base::scoped_nsobject<WrenchMenuController> wrenchMenuController_;
  74
  75   // Used for monitoring the optional toolbar button prefs.
  76   scoped_ptr<ToolbarControllerInternal::NotificationBridge> notificationBridge_;
  77   BooleanPrefMember showHomeButton_;
  78   BOOL hasToolbar_;  // If NO, we may have only the location bar.
  79   BOOL hasLocationBar_;  // If |hasToolbar_| is YES, this must also be YES.
  80   BOOL locationBarAtMinSize_; // If the location bar is at the minimum size.
  81
  82   // We have an extra retain in the locationBar_.
  83   // See comments in awakeFromNib for more info.
  84   base::scoped_nsobject<AutocompleteTextField> locationBarRetainer_;
  85
  86   // Tracking area for mouse enter/exit/moved in the toolbar.
  87   ui::ScopedCrTrackingArea trackingArea_;
  88
  89   // We retain/release the hover button since interaction with the
  90   // button may make it go away (e.g. delete menu option over a
  91   // bookmark button).  Thus this variable is not weak.  The
  92   // hoveredButton_ is required to have an NSCell that responds to
  93   // setMouseInside:animate:.
  94   NSButton* hoveredButton_;
  95 }
  96
  97 // Initialize the toolbar and register for command updates. The profile is
  98 // needed for initializing the location bar. The browser is needed for
  99 // the toolbar model and back/forward menus.
 100 - (id)initWithCommands:(CommandUpdater*)commands
 101                profile:(Profile*)profile
 102                browser:(Browser*)browser
 103         resizeDelegate:(id<ViewResizer>)resizeDelegate;
 104
 105 // Get the C++ bridge object representing the location bar for this tab.
 106 - (LocationBarViewMac*)locationBarBridge;
 107
 108 // Called by the Window delegate so we can provide a custom field editor if
 109 // needed.
 110 // Note that this may be called for objects unrelated to the toolbar.
 111 // returns nil if we don't want to override the custom field editor for |obj|.
 112 - (id)customFieldEditorForObject:(id)obj;
 113
 114 // Make the location bar the first responder, if possible.
 115 - (void)focusLocationBar:(BOOL)selectAll;
 116
 117 // Forces the toolbar (and transitively the location bar) to update its current
 118 // state.  If |tab| is non-NULL, we're switching (back?) to this tab and should
 119 // restore any previous location bar state (such as user editing) as well.
 120 - (void)updateToolbarWithContents:(content::WebContents*)tab;
 121
 122 // Sets whether or not the current page in the frontmost tab is bookmarked.
 123 - (void)setStarredState:(BOOL)isStarred;
 124
 125 // Happens when the zoom for the active tab changes, the active tab switches, or
 126 // a new tab or browser window is created. |canShowBubble| indicates if it is
 127 // appropriate to show a zoom bubble for the change.
 128 - (void)zoomChangedForActiveTab:(BOOL)canShowBubble;
 129
 130 // Called to update the loading state. Handles updating the go/stop
 131 // button state.  |force| is set if the update is due to changing
 132 // tabs, as opposed to the page-load finishing.  See comment in
 133 // reload_button.h.
 134 - (void)setIsLoading:(BOOL)isLoading force:(BOOL)force;
 135
 136 // Allow turning off the toolbar (but we may keep the location bar without a
 137 // surrounding toolbar). If |toolbar| is YES, the value of |hasLocationBar| is
 138 // ignored. This changes the behavior of other methods, like |-view|.
 139 - (void)setHasToolbar:(BOOL)toolbar hasLocationBar:(BOOL)locBar;
 140
 141 // Point on the star icon for the bookmark bubble to be - in the
 142 // associated window's coordinate system.
 143 - (NSPoint)bookmarkBubblePoint;
 144
 145 // Returns the desired toolbar height for the given compression factor.
 146 - (CGFloat)desiredHeightForCompression:(CGFloat)compressByHeight;
 147
 148 // Set the opacity of the divider (the line at the bottom) *if* we have a
 149 // |ToolbarView| (0 means don't show it); no-op otherwise.
 150 - (void)setDividerOpacity:(CGFloat)opacity;
 151
 152 // Create and add the Browser Action buttons to the toolbar view.
 153 - (void)createBrowserActionButtons;
 154
 155 // Return the BrowserActionsController for this toolbar.
 156 - (BrowserActionsController*)browserActionsController;
 157
 158 // Returns the wrench button.
 159 - (NSView*)wrenchButton;
 160
 161 @end
 162
 163 // A set of private methods used by subclasses. Do not call these directly
 164 // unless a subclass of ToolbarController.
 165 @interface ToolbarController(ProtectedMethods)
 166 // Designated initializer which takes a nib name in order to allow subclasses
 167 // to load a different nib file.
 168 - (id)initWithCommands:(CommandUpdater*)commands
 169                profile:(Profile*)profile
 170                browser:(Browser*)browser
 171         resizeDelegate:(id<ViewResizer>)resizeDelegate
 172           nibFileNamed:(NSString*)nibName;
 173 @end
 174
 175 // A set of private methods used by tests, in the absence of "friends" in ObjC.
 176 @interface ToolbarController(PrivateTestMethods)
 177 // Returns an array of views in the order of the outlets above.
 178 - (NSArray*)toolbarViews;
 179 - (void)showOptionalHomeButton;
 180 - (void)installWrenchMenu;
 181 - (WrenchMenuController*)wrenchMenuController;
 182 // Return a hover button for the current event.
 183 - (NSButton*)hoverButtonForEvent:(NSEvent*)theEvent;
 184 @end
 185
 186 #endif  // CHROME_BROWSER_UI_COCOA_TOOLBAR_TOOLBAR_CONTROLLER_H_