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
|
// 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 VIEWS_VIEWS_DELEGATE_H_
#define VIEWS_VIEWS_DELEGATE_H_
#pragma once
#include <string>
#if defined(OS_WIN)
#include <windows.h>
#endif
#include "views/accessibility/accessibility_types.h"
namespace gfx {
class Rect;
}
namespace ui {
class Clipboard;
}
namespace views {
class View;
class Window;
// ViewsDelegate is an interface implemented by an object using the views
// framework. It is used to obtain various high level application utilities
// and perform some actions such as window placement saving.
//
// The embedding app must set views_delegate to assign its ViewsDelegate
// implementation.
class ViewsDelegate {
public:
virtual ~ViewsDelegate() {}
// Gets the clipboard.
virtual ui::Clipboard* GetClipboard() const = 0;
// Saves the position, size and maximized state for the window with the
// specified name.
virtual void SaveWindowPlacement(views::Window* window,
const std::wstring& window_name,
const gfx::Rect& bounds,
bool maximized) = 0;
// Retrieves the saved position and size for the window with the specified
// name.
virtual bool GetSavedWindowBounds(views::Window* window,
const std::wstring& window_name,
gfx::Rect* bounds) const = 0;
// Retrieves the saved maximized state for the window with the specified
// name.
virtual bool GetSavedMaximizedState(views::Window* window,
const std::wstring& window_name,
bool* maximized) const = 0;
// Notify the delegate that an accessibility event has happened in
// a particular view.
virtual void NotifyAccessibilityEvent(
views::View* view, AccessibilityTypes::Event event_type) = 0;
// For accessibility, notify the delegate that a menu item was focused
// so that alternate feedback (speech / magnified text) can be provided.
virtual void NotifyMenuItemFocused(
const std::wstring& menu_name,
const std::wstring& menu_item_name,
int item_index,
int item_count,
bool has_submenu) = 0;
#if defined(OS_WIN)
// Retrieves the default window icon to use for windows if none is specified.
virtual HICON GetDefaultWindowIcon() const = 0;
#endif
// AddRef/ReleaseRef are invoked while a menu is visible. They are used to
// ensure we don't attempt to exit while a menu is showing.
virtual void AddRef() = 0;
virtual void ReleaseRef() = 0;
// The active ViewsDelegate used by the views system.
static ViewsDelegate* views_delegate;
};
} // namespace views
#endif // VIEWS_VIEWS_DELEGATE_H_
|
