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 (c) 2009 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_CHROMEOS_CROS_LANGUAGE_LIBRARY_H_
#define CHROME_BROWSER_CHROMEOS_CROS_LANGUAGE_LIBRARY_H_
#include <string>
#include "base/observer_list.h"
#include "base/singleton.h"
#include "base/time.h"
#include "third_party/cros/chromeos_language.h"
namespace chromeos {
// This class handles the interaction with the ChromeOS language library APIs.
// Classes can add themselves as observers. Users can get an instance of this
// library class like this: LanguageLibrary::Get()
class LanguageLibrary {
public:
class Observer {
public:
virtual ~Observer() = 0;
virtual void LanguageChanged(LanguageLibrary* obj) = 0;
virtual void ImePropertiesChanged(LanguageLibrary* obj) = 0;
};
// This gets the singleton LanguageLibrary
static LanguageLibrary* Get();
void AddObserver(Observer* observer);
void RemoveObserver(Observer* observer);
// Returns the list of IMEs and keyboard layouts we can select
// (i.e. active). If the cros library is not found or IBus/DBus daemon
// is not alive, this function returns a fallback language list (and
// never returns NULL).
InputLanguageList* GetActiveLanguages();
// Returns the list of IMEs and keyboard layouts we support, including
// ones not active. If the cros library is not found or IBus/DBus
// daemon is not alive, this function returns a fallback language list
// (and never returns NULL).
InputLanguageList* GetSupportedLanguages();
// Changes the current IME engine to |id| and enable IME (when |category|
// is LANGUAGE_CATEGORY_IME). Changes the current XKB layout to |id| and
// disable IME (when |category| is LANGUAGE_CATEGORY_XKB). |id| is a unique
// identifier of a IME engine or XKB layout. Please check chromeos_language.h
// in src third_party/cros/ for details.
void ChangeLanguage(LanguageCategory category, const std::string& id);
// Activates an IME property identified by |key|. Examples of keys are:
// "InputMode.Katakana", "InputMode.HalfWidthKatakana", "TypingMode.Romaji",
// and "TypingMode.Kana."
void ActivateImeProperty(const std::string& key);
// Deactivates an IME property identified by |key|.
void DeactivateImeProperty(const std::string& key);
// Activates the language specified by |category| and |id|. Returns true
// on success.
bool ActivateLanguage(LanguageCategory category, const std::string& id);
// Dectivates the language specified by |category| and |id|. Returns
// true on success.
bool DeactivateLanguage(LanguageCategory category, const std::string& id);
// Get a configuration of ibus-daemon or IBus engines and stores it on
// |out_value|. Returns true if |out_value| is successfully updated.
// When you would like to retrieve 'panel/custom_font', |section| should
// be "panel", and |config_name| should be "custom_font".
bool GetImeConfig(
const char* section, const char* config_name, ImeConfigValue* out_value);
// Updates a configuration of ibus-daemon or IBus engines with |value|.
// Returns true if the configuration is successfully updated.
// You can specify |section| and |config_name| arguments in the same way
// as GetImeConfig() above.
bool SetImeConfig(const char* section,
const char* config_name,
const ImeConfigValue& value);
const InputLanguage& current_language() const {
return current_language_;
}
const ImePropertyList& current_ime_properties() const {
return current_ime_properties_;
}
private:
friend struct DefaultSingletonTraits<LanguageLibrary>;
LanguageLibrary();
~LanguageLibrary();
// This method is called when there's a change in language status.
static void LanguageChangedHandler(
void* object, const InputLanguage& current_language);
// This method is called when an IME engine sends "RegisterProperties" signal.
static void RegisterPropertiesHandler(
void* object, const ImePropertyList& prop_list);
// This method is called when an IME engine sends "UpdateProperty" signal.
static void UpdatePropertyHandler(
void* object, const ImePropertyList& prop_list);
// Ensures that the monitoring of language changes is started. Starts
// the monitoring if necessary. Returns true if the monitoring has been
// successfully started.
bool EnsureStarted();
// Ensures that the cros library is loaded and the the monitoring is
// started. Loads the cros library and starts the monitoring if
// necessary. Returns true if the two conditions are both met.
bool EnsureLoadedAndStarted();
// Called by the handler to update the language status.
// This will notify all the Observers.
void UpdateCurrentLanguage(const InputLanguage& current_language);
// Called by the handler to register IME properties.
void RegisterProperties(const ImePropertyList& prop_list);
// Called by the handler to update IME properties.
void UpdateProperty(const ImePropertyList& prop_list);
// A reference to the language api, to allow callbacks when the language
// status changes.
LanguageStatusConnection* language_status_connection_;
ObserverList<Observer> observers_;
// The language (IME or XKB layout) which currently selected.
InputLanguage current_language_;
// The IME properties which the current IME engine uses. The list might be
// empty when no IME is used.
ImePropertyList current_ime_properties_;
DISALLOW_COPY_AND_ASSIGN(LanguageLibrary);
};
} // namespace chromeos
#endif // CHROME_BROWSER_CHROMEOS_CROS_LANGUAGE_LIBRARY_H_
|
