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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
// 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.
#ifndef CHROME_BROWSER_UI_IME_IME_WINDOW_H_
#define CHROME_BROWSER_UI_IME_IME_WINDOW_H_
#include <memory>
#include <string>
#include "base/strings/string16.h"
#include "content/public/browser/notification_observer.h"
#include "content/public/browser/notification_registrar.h"
#include "content/public/browser/web_contents_delegate.h"
#include "content/public/browser/web_contents_observer.h"
#include "extensions/browser/extension_icon_image.h"
#include "ui/gfx/geometry/rect.h"
#include "ui/gfx/image/image.h"
#include "ui/views/widget/widget_delegate.h"
#include "ui/views/widget/widget_observer.h"
class GURL;
class Profile;
namespace content {
class RenderFrameHost;
class WebContents;
}
namespace extensions {
class Extension;
}
namespace gfx {
class Rect;
}
namespace ui {
class ImeNativeWindow;
class ImeWindowObserver;
// The implementation for the IME window.
// This is used in the IME extension API.
// The IME window is in-activatable & always-on-top.
// There are 2 types of IME window:
// - Normal type: the titlebar is located at top.
// - Follow-cursor type: the titlebar is located at left, and the window is
// auto-aligned with the text cursor or composition.
// The destructor is private, so the client should call Close() to release
// the instance. And Close() is async.
class ImeWindow : public content::NotificationObserver,
public extensions::IconImage::Observer,
public content::WebContentsDelegate {
public:
enum Mode { NORMAL, FOLLOW_CURSOR };
// Takes |url| as string instead of GURL because resolving GURL requires
// |extension|. As the client code already passes in |extension|, it'd be
// better to simply the client code.
// |opener_render_frame_host| is the RenderFrameHost from where the IME window
// is opened so that the security origin can be correctly set.
ImeWindow(Profile* profile,
const extensions::Extension* extension,
content::RenderFrameHost* opener_render_frame_host,
const std::string& url,
Mode mode,
const gfx::Rect& bounds);
// Methods delegate to ImeNativeWindow.
void Show();
void Hide();
void Close();
void SetBounds(const gfx::Rect& bounds);
// Aligns the follow-cursor window to the given cursor bounds.
// If no follow-cursor window is at present, this method does nothing.
void FollowCursor(const gfx::Rect& cursor_bounds);
// Gets the web contents' frame ID, which is used to get the JS 'window'
// object in the custom bindings.
int GetFrameId() const;
// The callback that is called when the native window has been destroyed.
void OnWindowDestroyed();
void AddObserver(ImeWindowObserver* observer);
void RemoveObserver(ImeWindowObserver* observer);
// Getters.
Mode mode() const { return mode_; }
const std::string& title() const { return title_; }
const extensions::IconImage* icon() const { return icon_.get(); }
const ImeNativeWindow* ime_native_window() const { return native_window_; }
// extensions::IconImage::Observer:
void OnExtensionIconImageChanged(extensions::IconImage* image) override;
private:
~ImeWindow() override;
// content::NotificationObserver:
void Observe(int type,
const content::NotificationSource& source,
const content::NotificationDetails& details) override;
// content::WebContentsDelegate overrides.
content::WebContents* OpenURLFromTab(
content::WebContents* source,
const content::OpenURLParams& params) override;
bool CanDragEnter(content::WebContents* source,
const content::DropData& data,
blink::WebDragOperationsMask operations_allowed) override;
void CloseContents(content::WebContents* source) override;
void MoveContents(content::WebContents* source,
const gfx::Rect& pos) override;
bool IsPopupOrPanel(const content::WebContents* source) const override;
// Creates the native window.
ImeNativeWindow* CreateNativeWindow(ImeWindow* ime_window,
const gfx::Rect& bounds,
content::WebContents* contents);
content::NotificationRegistrar registrar_;
// The mode of this IME window which is either normal or follow-cursor.
// The follow-cursor window has the non client view on the left instead
// of top, and its position can auto-change according to the text cursor
// or composition.
Mode mode_;
// The window title which is shown in the non client view.
std::string title_;
// The window icon which is shown in the non client view.
std::unique_ptr<extensions::IconImage> icon_;
// The web contents for the IME window page web UI.
std::unique_ptr<content::WebContents> web_contents_;
ImeNativeWindow* native_window_; // Weak, it does self-destruction.
base::ObserverList<ImeWindowObserver> observers_;
DISALLOW_COPY_AND_ASSIGN(ImeWindow);
};
} // namespace ui
#endif // CHROME_BROWSER_UI_IME_IME_WINDOW_H_
|
