Report user actions for interactions with the Windows Settings app.

chrome/browser/settings_app_monitor_win.h

+// Copyright 2016 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_SETTINGS_APP_MONITOR_WIN_H_
+#define CHROME_BROWSER_SETTINGS_APP_MONITOR_WIN_H_
+
+#include <windows.h>
+
+#include "base/callback_forward.h"
+#include "base/macros.h"
+#include "base/memory/weak_ptr.h"
+#include "base/strings/string16.h"
+#include "base/strings/string_piece.h"
+#include "base/threading/thread.h"
+#include "base/threading/thread_checker.h"
+
+namespace shell_integration {
+namespace win {
+
+// A monitor that watches the Windows Settings app and notifies a delegate of
+// particularly interesting events. An asychronous initialization procedure is
+// started at instance creation, after which the delegate's |OnInitialized|
+// method is invoked. Following successful initilization, the monitor is ready
+// to observe the Settings app.
+class SettingsAppMonitor {
+ public:
+  class Delegate {
+   public:
+    virtual ~Delegate() {}
+
+    // Invoked to indicate that initialization is complete. |result| indicates
+    // whether or not the operation succeeded and, if not, the reason for
+    // failure.
+    virtual void OnInitialized(HRESULT result) = 0;
+
+    // Invoked when the Settings app has received keyboard focus.
+    virtual void OnAppFocused() = 0;
+
+    // Invoked when the user has invoked the Web browser chooser.
+    virtual void OnChooserInvoked() = 0;
+
+    // Invoked when the user has chosen a particular Web browser.
+    virtual void OnBrowserChosen(const base::string16& browser_name) = 0;
+  };
+
+  // |delegate| must outlive the monitor.
+  explicit SettingsAppMonitor(Delegate* delegate);
+  ~SettingsAppMonitor();
+
+ private:
+  class Context;
+
+  // Methods for passing actions on to the instance's Delegate.
+  void OnInitialized(HRESULT result);
+  void OnAppFocused();
+  void OnChooserInvoked();
+  void OnBrowserChosen(const base::string16& browser_name);
+
+  base::ThreadChecker thread_checker_;
+  Delegate* delegate_;
+
+  // A thread in the COM MTA in which automation calls are made.
+  base::Thread automation_thread_;
+
+  // A pointer to the context object that lives on the automation thread.
+  base::WeakPtr<Context> context_;
+
+  // A factory for the weak pointer handed to |context_|, through which
+  // notifications to the delegate are passed.
+  base::WeakPtrFactory<SettingsAppMonitor> weak_ptr_factory_;
+
+  DISALLOW_COPY_AND_ASSIGN(SettingsAppMonitor);
+};
+
+}  // namespace win
+}  // namespace shell_integration
+
+#endif  // CHROME_BROWSER_SETTINGS_APP_MONITOR_WIN_H_