blob: 9fb0fb62e51242346b5fca1b9dc16838536b1e68 [file] [log] [blame]
// 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.
#include <windows.h>
#include <memory>
#include "base/macros.h"
#include "base/memory/weak_ptr.h"
#include "base/sequence_checker.h"
#include "base/strings/string16.h"
class AutomationController;
// 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 {
class Delegate {
virtual ~Delegate() = default;
// 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;
// Invoked when the Edge promo has received keyboard focus.
virtual void OnPromoFocused() = 0;
// Invoked when the user interacts with the Edge promo.
virtual void OnPromoChoiceMade(bool accept_promo) = 0;
// |delegate| must outlive the monitor.
explicit SettingsAppMonitor(Delegate* delegate);
class AutomationControllerDelegate;
// 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);
void OnPromoFocused();
void OnPromoChoiceMade(bool accept_promo);
Delegate* delegate_;
// Allows the use of the UI Automation API.
std::unique_ptr<AutomationController> automation_controller_;
// Weak pointers are passed to the AutomationControllerDelegate so that it can
// safely call back the monitor from any thread.
base::WeakPtrFactory<SettingsAppMonitor> weak_ptr_factory_;