blob: 2ad93e4a503aa84e8dd0eb40eee8fce5b1b8926e (
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
85
86
87
88
89
90
91
92
93
94
95
96
|
// 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_VIEWS_ACCESSIBLE_TOOLBAR_VIEW_H_
#define CHROME_BROWSER_VIEWS_ACCESSIBLE_TOOLBAR_VIEW_H_
#include "base/hash_tables.h"
#include "base/task.h"
#include "chrome/browser/views/accessibility_event_router_views.h"
#include "views/focus/focus_manager.h"
#include "views/view.h"
namespace views {
class FocusSearch;
}
// This class provides keyboard access to any view that extends it, typically
// a toolbar. The user sets focus to a control in this view by pressing
// F6 to traverse all panes, or by pressing a shortcut that jumps directly
// to this toolbar.
class AccessibleToolbarView : public views::View,
public views::FocusChangeListener,
public views::FocusTraversable {
public:
AccessibleToolbarView();
virtual ~AccessibleToolbarView();
// Set focus to the toolbar with complete keyboard access.
// Focus will be restored to the ViewStorage with id |view_storage_id|
// if the user escapes. If |initial_focus| is not NULL, that control will get
// the initial focus, if it's enabled and focusable. Returns true if
// the toolbar was able to receive focus.
virtual bool SetToolbarFocus(int view_storage_id, View* initial_focus);
// Set focus to the toolbar with complete keyboard access, with the
// focus initially set to the default child. Focus will be restored
// to the ViewStorage with id |view_storage_id| if the user escapes.
// Returns true if the toolbar was able to receive focus.
virtual bool SetToolbarFocusAndFocusDefault(int view_storage_id);
// Overridden from views::View:
virtual FocusTraversable* GetPaneFocusTraversable();
virtual bool AcceleratorPressed(const views::Accelerator& accelerator);
virtual void SetVisible(bool flag);
virtual bool GetAccessibleRole(AccessibilityTypes::Role* role);
// Overridden from views::FocusChangeListener:
virtual void FocusWillChange(View* focused_before,
View* focused_now);
// Overridden from views::FocusTraversable:
virtual views::FocusSearch* GetFocusSearch();
virtual FocusTraversable* GetFocusTraversableParent();
virtual View* GetFocusTraversableParentView();
protected:
// A subclass can override this to provide a default focusable child
// other than the first focusable child.
virtual views::View* GetDefaultFocusableChild() { return NULL; }
// Remove toolbar focus.
virtual void RemoveToolbarFocus();
void RestoreLastFocusedView();
View* GetFirstFocusableChild();
View* GetLastFocusableChild();
bool toolbar_has_focus_;
ScopedRunnableMethodFactory<AccessibleToolbarView> method_factory_;
// Save the focus manager rather than calling GetFocusManager(),
// so that we can remove focus listeners in the destructor.
views::FocusManager* focus_manager_;
// Our custom focus search implementation that traps focus in this
// toolbar and traverses all views that are focusable for accessibility,
// not just those that are normally focusable.
views::FocusSearch focus_search_;
// Registered accelerators
views::Accelerator home_key_;
views::Accelerator end_key_;
views::Accelerator escape_key_;
views::Accelerator left_key_;
views::Accelerator right_key_;
// Last focused view that issued this traversal.
int last_focused_view_storage_id_;
DISALLOW_COPY_AND_ASSIGN(AccessibleToolbarView);
};
#endif // CHROME_BROWSER_VIEWS_ACCESSIBLE_TOOLBAR_VIEW_H_
|
