Support for interactive set-chrome-as-default in Windows.

chrome/browser/shell_integration.h

 // Copyright (c) 2012 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_SHELL_INTEGRATION_H_
 #define CHROME_BROWSER_SHELL_INTEGRATION_H_
 #pragma once
 
 #include <string>
 
 #include "base/basictypes.h"
 #include "base/file_path.h"
 #include "base/memory/ref_counted.h"
 #include "base/string16.h"
 #include "googleurl/src/gurl.h"
 #include "ui/gfx/image/image.h"
 
 class CommandLine;
 
 class ShellIntegration {
  public:
   // Sets Chrome as the default browser (only for the current user). Returns
   // false if this operation fails.
   static bool SetAsDefaultBrowser();
 
+  // Initializes an OS shell flow which (if followed by the user) should set
+  // Chrome as the default browser. Returns false if the flow cannot be
+  // initialized or if it is not supported (introduced for Windows8).

[grt (UTC plus 2), 2012/05/25 20:27:38]

Windows8 -> Windows 8

[motek., 2012/05/28 17:40:33]

Done.

+  static bool StartSetAsDefaultBrowserInteractive();
+
   // Sets Chrome as the default client application for the given protocol
   // (only for the current user). Returns false if this operation fails.
   static bool SetAsDefaultProtocolClient(const std::string& protocol);
 
+  // In Windows 8 a browser can be made default-in-metro only in an interactive
+  // flow. We will distinguish between two types of permissions here to avoid
+  // forcing user into UI interaction when this should not be done.

[grt (UTC plus 2), 2012/05/25 20:27:38]

user -> the user

[motek., 2012/05/28 17:40:33]

Done.

+  enum DefaultSettingsChangePermission {
+    CHANGE_DEFAULT_NOT_ALLOWED = 0,
+    CHANGE_DEFAULT_UNATTENDED,
+    CHANGE_DEFAULT_INTERACTIVE,
+  };
+
   // Returns true if the running browser can be set as the default browser.

[grt (UTC plus 2), 2012/05/25 20:27:38]

update comment.  suggest something like: "Returns requirements for making the
running browser the user's default." or something like that.

[motek., 2012/05/28 17:40:33]

Done.

-  static bool CanSetAsDefaultBrowser();
+  static DefaultSettingsChangePermission CanSetAsDefaultBrowser();
 
   // Returns true if the running browser can be set as the default client

[grt (UTC plus 2), 2012/05/25 20:27:38]

here, too

[motek., 2012/05/28 17:40:33]

Done.

   // application for specific protocols.
-  static bool CanSetAsDefaultProtocolClient();
+  static DefaultSettingsChangePermission CanSetAsDefaultProtocolClient();
 
   // On Linux, it may not be possible to determine or set the default browser
   // on some desktop environments or configurations. So, we use this enum and
   // not a plain bool. (Note however that if used like a bool, this enum will
   // have reasonable behavior.)
   enum DefaultWebClientState {
     NOT_DEFAULT_WEB_CLIENT = 0,
     IS_DEFAULT_WEB_CLIENT,
     UNKNOWN_DEFAULT_WEB_CLIENT = -1
   };
@@ skipping 209 matching lines @@
     // Set Chrome as the default handler for this protocol.
     virtual void SetAsDefault() OVERRIDE;
 
     std::string protocol_;
 
     DISALLOW_COPY_AND_ASSIGN(DefaultProtocolClientWorker);
   };
 };
 
 #endif  // CHROME_BROWSER_SHELL_INTEGRATION_H_