src/chrome/browser/ui/cocoa/version_independent_window.h

   1 // Copyright 2014 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_VERSION_INDEPENDENT_WINDOW_H_
   6 #define CHROME_BROWSER_UI_COCOA_VERSION_INDEPENDENT_WINDOW_H_
   7
   8 #import "chrome/browser/ui/cocoa/chrome_event_processing_window.h"
   9
  10 #include "base/mac/scoped_nsobject.h"
  11
  12 @interface NSWindow (VersionIndependentWindow)
  13
  14 // Returns the NSView closest to the root of the NSView hierarchy that is
  15 // eligible for adding subviews.
  16 // The frame of the view in screen coordinates is coincident with the window's
  17 // frame in screen coordinates.
  18 - (NSView*)cr_windowView;
  19
  20 @end
  21
  22 // By default, the contentView does not occupy the full size of a framed
  23 // window. Chrome still wants to draw in the title bar. Historically, Chrome
  24 // has done this by adding subviews directly to the root view. This causes
  25 // several problems. The most egregious is related to layer ordering when the
  26 // root view does not have a layer. By giving the contentView the same size as
  27 // the window, there is no longer any need to add subviews to the root view.
  28 //
  29 // No views should be manually added to [[window contentView] superview].
  30 // Instead, they should be added to [window cr_windowView].
  31 //
  32 // If the window does not have a titlebar, then its contentView already has the
  33 // same size as the window. In this case, this class has no effect.
  34 //
  35 // This class currently does not support changing the window's style after the
  36 // window has been initialized.
  37 @interface VersionIndependentWindow : ChromeEventProcessingWindow {
  38  @private
  39   // Holds the view that replaces [window contentView]. This view has the same
  40   // size as the window.  Empty if there is no titlebar.
  41   base::scoped_nsobject<NSView> chromeWindowView_;
  42 }
  43
  44 // Designated initializer.
  45 - (instancetype)initWithContentRect:(NSRect)contentRect
  46                           styleMask:(NSUInteger)windowStyle
  47                             backing:(NSBackingStoreType)bufferingType
  48                               defer:(BOOL)deferCreation
  49              wantsViewsOverTitlebar:(BOOL)wantsViewsOverTitlebar;
  50
  51 @end
  52
  53 #endif  // CHROME_BROWSER_UI_COCOA_VERSION_INDEPENDENT_WINDOW_H_