blob: a297a497faca07f8e8aa376469f418030a3bfa03 (
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
// 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_COMMAND_UPDATER_H_
#define CHROME_BROWSER_COMMAND_UPDATER_H_
#include "base/basictypes.h"
#include "base/containers/hash_tables.h"
#include "ui/base/window_open_disposition.h"
class CommandObserver;
class CommandUpdaterDelegate;
////////////////////////////////////////////////////////////////////////////////
//
// CommandUpdater class
//
// This object manages the enabled state of a set of commands. Observers
// register to listen to changes in this state so they can update their
// presentation.
//
class CommandUpdater {
public:
// Create a CommandUpdater with |delegate| to handle the execution of specific
// commands.
explicit CommandUpdater(CommandUpdaterDelegate* delegate);
~CommandUpdater();
// Returns true if the specified command ID is supported.
bool SupportsCommand(int id) const;
// Returns true if the specified command ID is enabled. The command ID must be
// supported by this updater.
bool IsCommandEnabled(int id) const;
// Performs the action associated with this command ID using CURRENT_TAB
// disposition.
// Returns true if the command was executed (i.e. it is supported and is
// enabled).
bool ExecuteCommand(int id);
// Performs the action associated with this command ID using the given
// disposition.
// Returns true if the command was executed (i.e. it is supported and is
// enabled).
bool ExecuteCommandWithDisposition(int id, WindowOpenDisposition disposition);
// Adds an observer to the state of a particular command. If the command does
// not exist, it is created, initialized to false.
void AddCommandObserver(int id, CommandObserver* observer);
// Removes an observer to the state of a particular command.
void RemoveCommandObserver(int id, CommandObserver* observer);
// Removes |observer| for all commands on which it's registered.
void RemoveCommandObserver(CommandObserver* observer);
// Notify all observers of a particular command that the command has been
// enabled or disabled. If the command does not exist, it is created and
// initialized to |state|. This function is very lightweight if the command
// state has not changed.
void UpdateCommandEnabled(int id, bool state);
private:
// A piece of data about a command - whether or not it is enabled, and a list
// of objects that observe the enabled state of this command.
class Command;
// Get a Command node for a given command ID, creating an entry if it doesn't
// exist if desired.
Command* GetCommand(int id, bool create);
// The delegate is responsible for executing commands.
CommandUpdaterDelegate* delegate_;
// This is a map of command IDs to states and observer lists
typedef base::hash_map<int, Command*> CommandMap;
CommandMap commands_;
DISALLOW_COPY_AND_ASSIGN(CommandUpdater);
};
#endif // CHROME_BROWSER_COMMAND_UPDATER_H_
|