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 2015 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef ASH_KEYBOARD_UI_KEYBOARD_UI_H_
#define ASH_KEYBOARD_UI_KEYBOARD_UI_H_
#include "ash/keyboard/ui/keyboard_export.h"
#include "base/functional/callback_forward.h"
#include "base/memory/raw_ptr.h"
#include "ui/base/ime/text_input_type.h"
#include "ui/events/gestures/gesture_types.h"
namespace aura {
class Window;
}
namespace ui {
class InputMethod;
}
namespace keyboard {
class KeyboardUIController;
// Interface representing a window containing virtual keyboard UI.
class KEYBOARD_EXPORT KeyboardUI {
public:
using LoadCallback = base::OnceCallback<void()>;
KeyboardUI();
KeyboardUI(const KeyboardUI&) = delete;
KeyboardUI& operator=(const KeyboardUI&) = delete;
virtual ~KeyboardUI();
// Begin loading the virtual keyboard window asynchronously.
// Returns a window immediately, but the UI within the window is not
// guaranteed to be fully loaded until |callback| is called.
// |callback| must be called after this function returns.
// This function can only be called once.
virtual aura::Window* LoadKeyboardWindow(LoadCallback callback) = 0;
// Gets the virtual keyboard window i.e. the WebContents window where
// keyboard extensions are loaded. Returns null if the window has not started
// loading.
virtual aura::Window* GetKeyboardWindow() const = 0;
// Get the gesture consumer for the keyboard, which may be different to the
// window itself if there are nested windows.
virtual ui::GestureConsumer* GetGestureConsumer() const = 0;
// Gets the InputMethod that will provide notifications about changes in the
// text input context.
virtual ui::InputMethod* GetInputMethod() = 0;
// Shows the keyboard window. The default implementation simply calls |Show|
// on the window. An overridden implementation can set up animations or delay
// the visibility change.
virtual void ShowKeyboardWindow();
// Hides the keyboard window. The default implementation simply calls |Hide|
// on the window. An overridden implementation can set up animations or delay
// the visibility change.
virtual void HideKeyboardWindow();
// Reloads virtual keyboard URL if the current keyboard's web content URL is
// different. The URL can be different if user switch from password field to
// any other type input field.
// At password field, the system virtual keyboard is forced to load even if
// the current IME provides a customized virtual keyboard. This is needed to
// prevent IME virtual keyboard logging user's password. Once user switch to
// other input fields, the virtual keyboard should switch back to the IME
// provided keyboard, or keep using the system virtual keyboard if IME doesn't
// provide one.
// TODO(crbug.com/40577582): Change this to accept a callback.
virtual void ReloadKeyboardIfNeeded() = 0;
// |controller| may be null when KeyboardUIController is being destroyed.
void SetController(KeyboardUIController* controller);
protected:
KeyboardUIController* keyboard_controller() { return keyboard_controller_; }
private:
raw_ptr<KeyboardUIController> keyboard_controller_ = nullptr;
};
} // namespace keyboard
#endif // ASH_KEYBOARD_UI_KEYBOARD_UI_H_
|
