summaryrefslogtreecommitdiffstats
path: root/chrome/browser/options_page_base.h
blob: 0e6c7566e8ee5eca9f03450272351113add9e888 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
// Copyright (c) 2010 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_OPTIONS_PAGE_BASE_H_
#define CHROME_BROWSER_OPTIONS_PAGE_BASE_H_
#pragma once

#include <string>

#include "base/basictypes.h"
#include "chrome/browser/options_window.h"
#include "chrome/common/notification_observer.h"
#include "chrome/browser/metrics/user_metrics.h"

class PrefService;
class Profile;
struct UserMetricsAction;

///////////////////////////////////////////////////////////////////////////////
// OptionsPageBase
//
//  A base class for Options dialog pages that handles observing preferences
//
class OptionsPageBase : public NotificationObserver {
 public:
  virtual ~OptionsPageBase();

  // Highlights the specified group to attract the user's attention.
  virtual void HighlightGroup(OptionsGroup highlight_group) { }

  // Overridden from NotificationObserver:
  virtual void Observe(NotificationType type,
                       const NotificationSource& source,
                       const NotificationDetails& details);

 protected:
  // This class cannot be instantiated directly, but its constructor must be
  // called by derived classes.
  explicit OptionsPageBase(Profile* profile);

  // Returns the Profile associated with this page.
  Profile* profile() const { return profile_; }

  // Records a user action and schedules the prefs file to be saved.
  void UserMetricsRecordAction(const UserMetricsAction &action,
                               PrefService* prefs);

  // Allows the UI to update when a preference value changes. The parameter is
  // the specific pref that changed, or NULL if all pref UI should be
  // validated. This should be called during setup, but with NULL as the
  // parameter to allow initial state to be set.
  virtual void NotifyPrefChanged(const std::string* pref_name) {}

 private:
  // The Profile associated with this page.
  Profile* profile_;

  DISALLOW_COPY_AND_ASSIGN(OptionsPageBase);
};

#endif  // CHROME_BROWSER_OPTIONS_PAGE_BASE_H_