chrome_frame/ready_mode/ready_mode.h

   1 // Copyright (c) 2011 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_FRAME_READY_MODE_READY_MODE_H_
   6 #define CHROME_FRAME_READY_MODE_READY_MODE_H_
   7
   8 #include <atlbase.h>
   9 #include <atlcom.h>
  10
  11 #include "base/basictypes.h"
  12
  13 interface IWebBrowser2;
  14
  15 // Integrates Ready Mode functionality with a specified IWebBrowser2 instance.
  16 // Displays prompts allowing the user to permanently activate, permanently
  17 // disable, or temporarily disable Chrome Frame whenever a Chrome Frame-enabled
  18 // site is rendered in the browser.
  19 namespace ready_mode {
  20
  21 // Defines an interface for disabling Chrome Frame based on user interaction
  22 // with Ready Mode.
  23 class Delegate {
  24  public:
  25   virtual ~Delegate() {}
  26
  27   // Disables Chrome Frame functionality in the current process. Will be
  28   // called after the installer has been invoked to manipulate the system or
  29   // user-level state.
  30   virtual void DisableChromeFrame() = 0;
  31 };  // class Delegate
  32
  33 // Enables Ready Mode for the specified IWebBrowser2 instance, if Chrome Frame
  34 // is currently in Ready Mode. If Chrome Frame is temporarily or permanently
  35 // declined, will invoke chrome_frame->DisableChromeFrame() to synchronize the
  36 // process state with the system- / user-level state.
  37 void Configure(Delegate* chrome_frame, IWebBrowser2* web_browser);
  38
  39 };  // namespace ready_mode
  40
  41 #endif  // CHROME_FRAME_READY_MODE_READY_MODE_H_