droid_wrap/android/view.rs
1/*
2 * Copyright (c) 2024. The RigelA open source project team and
3 * its contributors reserve all rights.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software distributed under the
10 * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11 * See the License for the specific language governing permissions and limitations under the License.
12 */
13
14//noinspection SpellCheckingInspection
15/**
16视图和输入法(如软键盘)之间交互的框架类。
17*/
18#[cfg(feature = "android_view_inputmethod")]
19pub mod inputmethod;
20
21use crate::{
22 JObjNew, JObjRef, JProxy, JType, Result,
23 android::{
24 content::{Context, ContextWrapper},
25 graphics::{Canvas, Rect},
26 os::Bundle,
27 },
28 java::lang::{CharSequence, Integer, Runnable},
29 java_class, java_constructor, java_field, java_implement, java_interface, java_method,
30};
31use std::sync::Arc;
32
33/**
34此类代表用户界面组件的基本构建块。View 占据屏幕上的矩形区域,负责绘制和事件处理。View 是小部件的基类,用于创建交互式 UI 组件(按钮、文本字段等)。ViewGroup 子类是布局的基类,布局是不可见的容器,用于容纳其他 View(或其他 ViewGroup)并定义其布局属性。
35开发人员指南
36有关使用此类开发应用程序用户界面的信息,请阅读用户界面开发人员指南。
37使用视图窗口中的所有视图都排列在一棵树中。您可以从代码中添加视图,也可以通过在一个或多个 XML 布局文件中指定视图树来添加视图。有许多专门的视图子类,它们充当控件或能够显示文本、图像或其他内容。创建视图树后,通常您可能希望执行以下几种常见操作:
38- 设置属性:例如,设置 android.widget.TextView 的文本。不同视图子类的可用属性和设置方法会有所不同。请注意,在构建时已知的属性可以在 XML 布局文件中设置。
39- 设置焦点:框架将处理移动焦点以响应用户输入。要强制将焦点移到特定视图,请调用 requestFocus。
40- 设置侦听器:视图允许客户端设置侦听器,当视图发生有趣的事情时,这些侦听器将收到通知。例如,所有视图都允许您设置一个侦听器,以便在视图获得或失去焦点时收到通知。您可以使用 setOnFocusChangeListener(View.OnFocusChangeListener) 注册此类侦听器。其他视图子类提供更专业的侦听器。例如,按钮会公开一个侦听器,以便在单击按钮时通知客户端。
41- 设置可见性:您可以使用 setVisibility(int) 隐藏或显示视图。注意:Android 框架负责测量、布局和绘制视图。除非您实际实施了 ViewGroup,否则您不应自己调用对视图执行这些操作的方法。
42有关更多信息,请查阅官方文档。
43*/
44#[java_class(name = "android/view/View")]
45pub struct View;
46
47impl View {
48 /// 用于标记没有ID的View。
49 pub const NO_ID: i32 = -1;
50
51 /// 赋予不属于活动的视图的最后一个 ID。
52 pub const LAST_APP_AUTOFILL_ID: i32 = i32::MAX / 2;
53
54 /// 此视图可见。与 setVisibility 和 ` ` 一起使用。
55 pub const VISIBLE: i32 = 0x00000000;
56
57 /// 此视图不可见,但出于布局目的它仍占用空间。与 setVisibility 和 ` ` 一起使用。
58 pub const INVISIBLE: i32 = 0x00000004;
59
60 /// 此视图是看不见的,并且没有任何空间用于布局目的。与setVisibility一起使用。
61 pub const GONE: i32 = 0x00000008;
62
63 /**
64 从代码创建视图时使用的简单构造函数。
65 `context` 视图在其中运行的上下文,通过它可以访问当前主题、资源等。
66 */
67 #[java_constructor]
68 pub fn new(context: &Context) -> Self {}
69
70 /**
71 发送 AccessibilityEvent 的便捷方法。TYPE_ANNOUNCEMENT AccessibilityEvent 建议无障碍服务向其用户宣布指定的文本。
72 注意:使用此 API 生成的事件不具有语义含义,仅适用于特殊情况。应用通常可以通过准确提供其 UI 的语义来实现正确的无障碍行为。它们不需要指定向用户宣布的具体内容。一般来说,只宣布转换,不要为按钮按下等简单操作生成确认消息。相反,请简明扼要地标记控件,对于重大的 UI 更改(如窗口更改),请使用 android.app.Activity.setTitle(CharSequence) 和 setAccessibilityPaneTitle(CharSequence)。使用 setAccessibilityLiveRegion(int) 通知用户用户界面内关键视图的更改。这些仍应谨慎使用,因为它们可能会在每次更新视图时生成通知。
73 `text` 通知文本。
74 */
75 #[java_method]
76 pub fn announce_for_accessibility<CS: CharSequence>(&self, text: &CS) {}
77
78 /**
79 返回视图的宽度。
80 返回:视图的宽度(以像素为单位)。
81 */
82 #[java_method]
83 pub fn get_width(&self) -> i32 {}
84
85 /**
86 返回视图的高度。
87 返回:视图的高度(以像素为单位)。
88 */
89 #[java_method]
90 pub fn get_height(&self) -> i32 {}
91
92 //noinspection SpellCheckingInspection
93 /**
94 调用此操作可以尝试将焦点集中到特定视图或其子视图之一。如果视图不可聚焦(isFocusable返回false),或者由于其他条件而无法聚焦(当设备处于触摸模式、不可见、未启用或没有大小时,在触摸模式下无法聚焦(isForusableInTouchMode)),则视图实际上不会聚焦。另请参阅focusSearch(int),这是用来表示有焦点,并希望视图的父母寻找下一个焦点的方法。这相当于用参数FOCUS_DOWN和null调用requestFocus(int, Rect)。
95 返回:这个视图或它的一个后代是否真的成为焦点。
96 */
97 #[java_method]
98 pub fn request_focus(&self) -> bool {}
99
100 /**
101 当此视图想要放弃焦点时调用。如果焦点被清除,则调用 onFocusChanged(boolean, int, Rect)。
102 注意:当不处于触摸模式时,框架将在焦点清除后尝试将焦点放在从顶部开始的第一个可聚焦视图上。因此,如果此视图是从顶部开始的第一个可获得焦点的视图,则将调用与清除焦点相关的所有回调,之后框架将焦点放在此视图上。
103 */
104 #[java_method]
105 pub fn clear_focus(&self) {}
106
107 /**
108 在以此视图为根的层次结构中查找当前具有焦点的视图。
109 返回:当前具有焦点的视图,如果找不到焦点视图,则返回 null。
110 */
111 #[java_method]
112 pub fn find_focus(&self) -> Option<Self> {}
113
114 /**
115 指示此视图的激活状态。
116 返回:如果视图已激活,则返回 true,否则返回 false
117 */
118 #[java_method]
119 pub fn is_activated(&self) -> bool {}
120
121 /**
122 更改此视图的激活状态。视图可以激活也可以不激活。请注意,激活与选择不同。选择是一种瞬时属性,表示用户当前正在与之交互的视图(层次结构)。激活是一种长期状态,用户可以将视图移入或移出。例如,在启用单选或多选的列表视图中,当前选择集中的视图处于激活状态。(嗯,是的,我们对这里的术语深感抱歉。)激活状态会向下传播到设置该状态的视图的子级。
123 `activated` 如果必须激活视图,则为 true,否则为 false
124 */
125 #[java_method]
126 pub fn set_activated(&self, activated: bool) {}
127
128 /**
129 此视图的可视 x 位置(以像素为单位)。这相当于 TranslationX 属性加上当前 Left 属性。
130 返回:此视图的可视 x 位置(以像素为单位)。
131 */
132 #[java_method]
133 pub fn get_x(&self) -> f32 {}
134
135 /**
136 设置此视图的可视 x 位置(以像素为单位)。这相当于将 TranslationX 属性设置为传入的 x 值与当前 left 属性之间的差值。
137 `x` 此视图的可视 x 位置(以像素为单位)。
138 */
139 #[java_method]
140 pub fn set_x(&self, x: f32) {}
141
142 /**
143 此视图的视觉 y 位置(以像素为单位)。这相当于 TranslationY 属性加上当前的 Top 属性。
144 返回:此视图的视觉 y 位置(以像素为单位)。
145 */
146 #[java_method]
147 pub fn get_y(&self) -> f32 {}
148
149 /**
150 设置此视图的视觉 y 位置(以像素为单位)。这相当于将 TranslationY 属性设置为传入的 y 值与当前 top 属性之间的差值。
151 `y` 此视图的视觉 y 位置(以像素为单位)。
152 */
153 #[java_method]
154 pub fn set_y(&self, y: f32) {}
155
156 /**
157 查找具有给定 ID 的第一个后代视图,如果 ID 与 getId() 匹配,则查找视图本身,如果 ID 无效 (< 0) 或层次结构中没有匹配的视图,则返回 null。
158 注意:在大多数情况下 - 取决于编译器支持 - 生成的视图会自动转换为目标类类型。如果目标类类型不受约束,则可能需要显式转换。
159 返回:如果找到,则返回具有给定 ID 的视图,否则返回 null
160 `id` 要搜索的 ID
161 */
162 #[java_method]
163 pub fn find_view_by_id(&self, id: i32) -> Option<Self> {}
164
165 /**
166 返回视图的内容描述。
167 注意:不要覆盖此方法,因为它不会影响呈现给无障碍服务的内容描述。您必须调用 setContentDescription(CharSequence) 来修改内容描述。
168 返回:内容描述
169 */
170 #[java_method]
171 pub fn get_content_description<CS: CharSequence>(&self) -> Option<CS> {}
172
173 /**
174 设置视图的内容描述。内容描述简要描述视图,主要用于辅助功能支持,以确定应如何向用户呈现视图。对于没有文本表示的视图(如 android.widget.ImageButton),有用的内容描述会解释视图的作用。例如,用于拨打电话的带有电话图标的图像按钮可以使用“呼叫”作为其内容描述。用于保存文件的软盘图像可以使用“保存”。这应该省略角色或状态。角色是指视图的用户界面元素类型,例如按钮或复选框。状态是指视图经常变化的属性,例如按钮的开/关状态或音量滑块的音频级别。内容描述更新并不频繁,并且在元素的语义内容(而不是状态)发生变化时使用。例如,在音乐播放期间,播放按钮可能会更改为暂停按钮。
175 `content_description` 内容描述。
176 */
177 #[java_method]
178 pub fn set_content_description<CS: CharSequence>(&self, content_description: Option<CS>) {}
179
180 /**
181 设置此视图的标识符。标识符在此视图的层次结构中不必唯一。标识符应为正数。
182 `id` 用于标识视图的数字
183 */
184 #[java_method]
185 pub fn set_id(&self, id: i32) {}
186
187 /**
188 返回此视图的标识符。
189 返回:用于标识视图的正整数,如果视图没有 ID,则返回 NO_ID
190 */
191 #[java_method]
192 pub fn get_id(&self) -> i32 {}
193
194 /**
195 单击此视图时注册要调用的回调。如果此视图不可点击,则将设为可点击。
196 `l` 将运行的回调
197 */
198 #[java_method]
199 pub fn set_on_click_listener<L: View_OnClickListener + JProxy>(&self, l: &L) {}
200
201 /**
202 注册一个回调,当此视图被点击并按住时调用。如果此视图不是长按可点击的,则变为长按可点击的。
203 `l` 将运行的回调
204 */
205 #[java_method]
206 pub fn set_on_long_click_listener<L: View_OnLongClickListener + JProxy>(&self, l: &L) {}
207
208 /**
209 获取与此视图关联的 LayoutParams。所有视图都应具有布局参数。这些参数为此视图的父级提供参数,指定应如何排列。
210 ViewGroup.LayoutParams 有许多子类,这些子类对应于负责排列其子级的 ViewGroup 的不同子类。如果此视图未附加到父 ViewGroup 或 setLayoutParams(ViewGroup.LayoutParams) 未成功调用,则此方法可能返回 null。当视图附加到父 ViewGroup 时,此方法不得返回 null。
211 返回:与此视图关联的 LayoutParams,如果尚未设置参数,则返回 null
212 */
213 #[java_method]
214 pub fn get_layout_params(&self) -> Option<ViewGroup_LayoutParams> {}
215
216 /**
217 设置与此视图相关的布局参数。这些参数为该视图的父级提供参数,指定应如何排列。ViewGroup 有许多子类。LayoutParams,这些对应于负责排列其子级的 ViewGroup 的不同子类。
218 `params` 此视图的布局参数,不能为空
219 */
220 #[java_method]
221 pub fn set_layout_params(&self, params: &ViewGroup_LayoutParams) {}
222
223 /**
224 设置此视图的可见性状态。
225 `visibility` VISIBLE、INVISIBLE 或 GONE 之一。
226 */
227 #[java_method]
228 pub fn set_visibility(&self, visibility: i32) {}
229
230 /**
231 返回此视图的可见性状态。
232 返回:VISIBLE、INVISIBLE 或 GONE 之一。
233 */
234 #[java_method]
235 pub fn get_visibility(&self) -> i32 {}
236
237 /**
238 如果已定义,则调用此视图的 OnClickListener。执行与点击相关的所有常规操作:报告可访问性事件、播放声音等。
239 返回:如果已分配一个被调用的 OnClickListener,则返回 True,否则返回 false。
240 */
241 #[java_method]
242 pub fn perform_click(&self) -> bool {}
243
244 /**
245 指示此视图是否对点击事件作出反应。如果视图可点击,则返回 true,否则返回 false
246 */
247 #[java_method]
248 pub fn is_clickable(&self) -> bool {}
249
250 /**
251 启用或禁用此视图的点击事件。当视图可点击时,每次点击时它的状态都会更改为“按下”。子类应将视图设置为可点击,以便对用户的点击做出视觉反应。
252 `clickable` true 表示视图可点击,否则为 false
253 */
254 #[java_method]
255 pub fn set_clickable(&self, clickable: bool) {}
256
257 /**
258 禁用时启用或禁用此视图的单击事件。
259 `clickable_when_disabled` true使视图可单击,否则为false
260 */
261 #[java_method]
262 pub fn set_allow_click_when_disabled(&self, clickable_when_disabled: bool) {}
263
264 /**
265 指示此视图是否对长按事件作出反应。
266 返回:如果视图可长按,则返回 true,否则返回 false
267 */
268 #[java_method]
269 pub fn is_long_clickable(&self) -> bool {}
270
271 /**
272 启用或禁用此视图的长按事件。当视图可长按时,它会对用户按住按钮的时间长于点击做出反应。此事件可以启动侦听器或上下文菜单。
273 `long_clickable` true 表示视图可长按,否则为 false
274 */
275 #[java_method]
276 pub fn set_long_clickable(&self, long_clickable: bool) {}
277
278 /**
279 指示此视图是否对上下文点击反应。
280 返回:如果视图是上下文可单击的,则为false,否则否则
281 */
282 #[java_method]
283 pub fn is_context_clickable(&self) -> bool {}
284
285 /**
286 启用或禁用此视图的上下文点击。此事件可以启动侦听器。
287 `context_clickable` true 表示使视图对上下文点击做出反应,否则为 false
288 */
289 #[java_method]
290 pub fn set_context_clickable(&self, context_clickable: bool) {}
291
292 /**
293 返回此视图是否具有附加的 OnClickListener。如果有侦听器,则返回 true,如果没有,则返回 false。
294 */
295 #[java_method]
296 pub fn has_on_click_listeners(&self) -> bool {}
297
298 /**
299 返回此视图是否具有附加的 OnLongClickListener。如果有侦听器,则返回 true,如果没有,则返回 false。
300 */
301 #[java_method]
302 pub fn has_on_long_click_listeners(&self) -> bool {}
303
304 /**
305 返回屏幕是否应保持开启,对应于 KEEP_SCREEN_ON 的当前值。
306 返回:如果设置了 KEEP_SCREEN_ON,则返回 true。
307 */
308 #[java_method]
309 pub fn get_keep_screen_on(&self) -> bool {}
310
311 /**
312 控制屏幕是否应保持开启,修改 KEEP_SCREEN_ON 的值。
313 `keep_screen_on` 提供 true 以设置 KEEP_SCREEN_ON。
314 */
315 #[java_method]
316 pub fn set_keep_screen_on(&self, keep_screen_on: bool) {}
317
318 /**
319 获取此视图的父级。请注意,父级是 ViewParent,不一定是 View。
320 返回:此视图的父级。
321 */
322 #[java_method]
323 pub fn get_parent<VP: ViewParent>(&self) -> Option<VP> {}
324
325 /**
326 注册一个回调,当此视图中按下硬件键时调用该回调。软件输入法中的按键通常不会触发此侦听器的方法。
327 `l` 要附加到此视图的按键侦听器
328 */
329 #[java_method]
330 pub fn set_on_key_listener<L: View_OnKeyListener>(&self, l: &L) {}
331
332 /// 如果此视图位于当前具有 IME 可聚焦状态的窗口中,则为 true。
333 #[java_method]
334 pub fn has_ime_focus(&self) -> bool {}
335
336 /**
337 如果此视图具有嵌套滚动父级,则返回 true。
338 嵌套滚动父级的存在表明此视图已启动嵌套滚动,并且已被视图层次结构中更高层次的祖先视图接受。
339 返回:此视图是否具有嵌套滚动父级
340 */
341 #[java_method]
342 pub fn has_nested_scrolling_parent(&self) -> bool {}
343
344 /// 二进制兼容性存根。当我们最终完成 O API 时将被删除。
345 #[java_method]
346 pub fn get_tooltip<CS: CharSequence>(&self) -> Option<CS> {}
347
348 /**
349 返回视图的工具提示文本。
350 注意:不要重写此方法,因为它不会影响工具提示中显示的文本。您必须调用 setTooltipText(CharSequence) 来修改工具提示文本。
351 返回:工具提示文本
352 */
353 #[java_method]
354 pub fn get_tooltip_text<CS: CharSequence>(&self) -> Option<CS> {}
355
356 /// 二进制兼容性存根。当我们最终完成 O API 时将被删除。
357 #[java_method]
358 pub fn set_tooltip<CS: CharSequence>(&self, tooltip_text: Option<CS>) {}
359
360 /**
361 设置工具提示文本,该文本将显示在视图旁边的小弹出窗口中。工具提示将显示在:
362 长按时,除非另有处理(通过 OnLongClickListener 或上下文菜单)。
363 悬停时,在指针停止移动后的短暂延迟后
364 注意:不要覆盖此方法,因为它不会影响工具提示中显示的文本。
365 `tooltip_text` 工具提示文本,如果不需要工具提示,则为 null。
366 */
367 #[java_method]
368 pub fn set_tooltip_text<CS: CharSequence>(&self, tooltip_text: Option<CS>) {}
369
370 /**
371 导致 Runnable 被添加到消息队列,在指定的时间过后运行。Runnable 将在用户界面线程上运行。
372 返回:如果 Runnable 成功放入消息队列,则返回 true。如果失败,则返回 false,通常是因为处理消息队列的 looper 正在退出。请注意,结果为 true 并不意味着 Runnable 将被处理 - 如果 looper 在消息传递时间发生之前退出,则消息将被丢弃。
373 `action` 将执行的 Runnable。
374 `delay_millis` Runnable 执行前的延迟(以毫秒为单位)。
375 */
376 #[java_method]
377 pub fn post_delayed<R: Runnable>(&self, action: &R, delay_millis: u64) -> bool {}
378
379 /**
380 设置一个回调,当触控笔 MotionEvent 在该视图的边界内发生时,应调用该回调。回调将从 UI 线程调用。
381 设置回调允许此视图充当手写委托器,以便可以通过触控笔在此委托器视图上的移动来启动委托编辑器视图的手写模式。回调实现应显示并聚焦委托编辑器视图。
382 如果为 isHandwritingDelegate() 返回 true 的视图在相同地触控笔 MotionEvent 序列正在进行时创建输入连接,则将为该视图启动手写模式。
383 一个常见的用例是自定义视图看起来像文本编辑器,但实际上不支持文本编辑本身,单击自定义视图会导致显示 EditText。为了在这种情况下支持手写启动,可以在自定义视图上调用此方法以将其配置为委托器。
384 EditText 应调用 setIsHandwritingDelegate 将其设置为委托。回调实现通常与显示 EditText 的单击侦听器实现相同。
385 如果传递了 null,则此视图将不再充当手写启动委托人。
386 `callback` 当触控笔 MotionEvent 在该视图的范围内发生时应调用的回调
387 */
388 #[java_method]
389 pub fn set_handwriting_delegator_callback<R: Runnable>(&self, callback: Option<&R>) {}
390
391 /**
392 返回由 setHandwritingDelegatorCallback 设置的回调,当触控笔 MotionEvent 在该视图的范围内发生时应调用该回调。该回调只能从 UI 线程调用。
393 */
394 #[java_method]
395 pub fn get_handwriting_delegator_callback<R: Runnable>(&self) -> Option<R> {}
396
397 /**
398 导致 Runnable 被添加到消息队列。Runnable 将在用户界面线程上运行。
399 返回:如果 Runnable 成功放入消息队列,则返回 true。如果失败,则返回 false,通常是因为处理消息队列的循环程序正在退出。
400 `action` 将执行的 Runnable。
401 */
402 #[java_method]
403 pub fn post<R: Runnable>(&self, action: &R) -> bool {}
404
405 /**
406 使 Runnable 在下一个动画时间步骤执行。Runnable 将在用户界面线程上运行。
407 `action` 将执行的 Runnable。
408 */
409 #[java_method]
410 pub fn post_on_animation<R: Runnable>(&self, action: &R) {}
411
412 /**
413 使 Runnable 在指定的时间量过去后在下一个动画时间步骤执行。 Runnable 将在用户界面线程上运行。
414 `action` 将执行的 Runnable。
415 `delay_millis` Runnable 执行前的延迟(以毫秒为单位)。
416 */
417 #[java_method]
418 pub fn post_on_animation_delayed<R: Runnable>(&self, action: &R, delay_millis: u64) {}
419
420 /**
421 从消息队列中移除指定的 Runnable。
422 返回:如果此视图可以要求 Handler 移除 Runnable,则返回 true,否则返回 false。当返回值为 true 时,Runnable 可能已从消息队列中实际移除(例如,如果 Runnable 尚未在队列中)。
423 `action` 要从消息处理队列中移除的 Runnable
424 */
425 #[java_method]
426 pub fn remove_callbacks<R: Runnable>(&self, action: &R) -> bool {}
427}
428
429/// 定义视图父类的职责。这是视图想要与其父类交互时看到的 API。
430#[java_interface(name = "android/view/ViewParent")]
431pub trait ViewParent {
432 #[doc(hidden)]
433 type VP: ViewParent;
434
435 /// 当发生某些更改导致此视图父级的子级布局无效时调用。这将安排视图树的布局过程。
436 fn request_layout(&self);
437
438 /// 指示是否在此视图父级上请求布局。
439 /// 返回:如果请求布局,则返回 true,否则返回 false
440 fn is_layout_requested(&self) -> bool;
441
442 /**
443 当子视图希望视图层次结构收集透明区域并将其报告给窗口合成器时调用。在视图层次结构中“打”洞的视图(例如 SurfaceView)可以使用此 API 来提高系统的性能。当层次结构中不存在此类视图时,此优化是不必要的,并且可能会略微降低视图层次结构的性能。
444 `child` 请求透明区域计算的视图
445 */
446 fn request_transparent_region(&self, child: &View);
447
448 /**
449 如果父级存在则返回该父级,否则返回 null。
450 返回:ViewParent,如果此 ViewParent 没有父级则返回 null。
451 */
452 fn get_parent(&self) -> Option<Self::VP>;
453
454 /**
455 当此父级的子级需要焦点时调用
456 `child` 此 ViewParent 需要焦点的子级。此视图将包含焦点视图。它不一定是实际具有焦点的视图。
457 `focused` 实际具有焦点的子级后代视图
458 */
459 fn request_child_focus(&self, child: &View, focused: &View);
460
461 /**
462 告诉视图层次结构需要重新评估全局视图属性。
463 `child` 属性已更改的视图。
464 */
465 fn recompute_view_attributes(&self, child: &View);
466
467 /**
468 当此父级的子级放弃焦点时调用
469 `child` 放弃焦点的视图
470 */
471 fn clear_child_focus(&self, child: &View);
472
473 /**
474 查找指定方向上想要获得焦点的最近视图
475 `v` 当前获得焦点的视图
476 `direction` FOCUS_UP、FOCUS_DOWN、FOCUS_LEFT 和 FOCUS_RIGHT 之一
477 */
478 fn focus_search(&self, v: &View, direction: i32) -> View;
479
480 /**
481 更改子项的 z 顺序,使其位于所有其他子项之上。如果此容器使用顺序相关的布局方案(例如 LinearLayout),则此顺序更改可能会影响布局。在 android.os.Build.VERSION_CODES.KITKAT 之前,此方法应随后调用此父项的 requestLayout() 和 View.invalidate(),以强制父项使用新的子项顺序重新绘制。
482 `child` 要置于 z 顺序顶部的子项
483 */
484 fn bring_child_to_front(&self, child: &View);
485
486 /**
487 显示指定视图或其祖先的上下文菜单。在大多数情况下,子类不需要覆盖此。但是,如果将子类直接添加到窗口管理器(例如,ViewManager.addView(View, ViewGroup.LayoutParams)),则它应该覆盖此并显示上下文菜单。
488 返回:如果显示上下文菜单,则返回 true,否则返回 false
489 `original_view` 首次调用上下文菜单的源视图
490 */
491 fn show_context_menu_for_child(&self, original_view: &View) -> bool;
492
493 /**
494 当子项的可绘制状态发生改变时,将在父项上调用此方法。
495 `child` 可绘制状态发生改变的子项。
496 */
497 fn child_drawable_state_changed(&self, child: &View);
498
499 /**
500 当子级不希望此父级及其祖先使用 ViewGroup.onInterceptTouchEvent(MotionEvent) 拦截触摸事件时调用。此父级应将此调用传递给其父级。此父级必须在触摸期间遵守此请求(即,仅在此父级收到向上或取消后清除标志。
501 `disallow_intercept` 如果子级不希望父级拦截触摸事件,则为 True。
502 */
503 fn request_disallow_intercept_touch_event(&self, disallow_intercept: bool);
504
505 /**
506 当子视图现在具有或不再跟踪瞬态时调用。 “瞬态”是视图可能持有的任何状态,但不应反映在视图当前呈现的数据模型中。此状态仅影响视图本身向用户呈现的内容,例如正在进行的动画的当前状态或文本选择操作的状态。瞬态可用于向视图系统的其他组件提示特定视图正在跟踪复杂但封装的内容。例如,ListView 可能承认具有瞬态的列表项视图应保留在其位置或稳定项 ID 中,而不是将该视图视为可由后备适配器轻松替换。
507 这使得适配器实现更简单,而不需要跟踪正在进行的项目视图动画的状态,以便在意外回收和重新绑定附加项目视图时可以恢复它们。当子视图或其子树中的视图开始或结束内部瞬态跟踪时,将在父视图上调用此方法。
508 `child` 状态已改变的子视图
509 `has_transient_state` 如果此子视图具有瞬时状态,则为 true
510 */
511 fn child_has_transient_state_changed(&self, child: &View, has_transient_state: bool);
512
513 /**
514 要求执行新的 View.fitSystemWindows(Rect) 调度。
515 */
516 fn request_fit_system_windows(&self);
517
518 /**
519 获取给定 View 的父级,以实现可访问性。由于某些 View 未暴露给可访问性层,因此可访问性的父级不一定是 View 的直接父级,而是前任。
520 返回:父级,如果未找到,则返回 null。
521 */
522 fn get_parent_for_accessibility(&self) -> Option<Self::VP>;
523
524 /**
525 通知视图父级,其某个后代的可访问性状态已更改,并且子树的结构不同。
526 `child` 子树已更改的直接子级。
527 `source` 发生更改的后代视图。不能为 null。
528 `change_type` 发生的更改类型的位掩码。以下一个或多个:
529 AccessibilityEvent.CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION AccessibilityEvent.CONTENT_CHANGE_TYPE_STATE_DESCRIPTION AccessibilityEvent.CONTENT_CHANGE_TYPE_SUBTREE
530 AccessibilityEvent.CONTENT_CHANGE_TYPE_TEXT AccessibilityEvent.CONTENT_CHANGE_TYPE_UNDEFINED AccessibilityEvent.CONTENT_CHANGE_TYPE_DRAG_STARTED
531 AccessibilityEvent.CONTENT_CHANGE_TYPE_DRAG_CANCELLED AccessibilityEvent.CONTENT_CHANGE_TYPE_DRAG_DROPPED
532 */
533 fn notify_subtree_accessibility_state_changed(
534 &self,
535 child: &View,
536 source: &View,
537 change_type: i32,
538 );
539
540 /**
541 告知此视图父级是否可以解析布局方向。请参阅 View.setLayoutDirection(int)
542 返回:如果此视图父级可以解析布局方向,则返回 True。
543 */
544 fn can_resolve_layout_direction(&self) -> bool;
545
546 /**
547 告知此视图父级布局方向是否已解析。请参阅 View.setLayoutDirection(int)
548 返回:如果此视图父级布局方向已解析,则返回 True。
549 */
550 fn is_layout_direction_resolved(&self) -> bool;
551
552 /**
553 返回此视图的父布局方向。请参阅 View.getLayoutDirection()
554 返回:如果布局方向为 RTL,则返回 View.LAYOUT_DIRECTION_RTL;如果布局方向不是 RTL,则返回 View.LAYOUT_DIRECTION_LTR。
555 */
556 fn get_layout_direction(&self) -> i32;
557
558 /**
559 告知此视图父级是否可以解析文本方向。请参阅 View.setTextDirection(int)
560 返回:如果此视图父级可以解析文本方向,则返回 True。
561 */
562 fn can_resolve_text_direction(&self) -> bool;
563
564 /**
565 告知此视图父文本方向是否已解析。请参阅 View.setTextDirection(int)
566 返回:如果此视图父文本方向已解析,则返回 true。
567 */
568 fn is_text_direction_resolved(&self) -> bool;
569
570 /**
571 返回此视图父文本方向。参见 View.getTextDirection()
572 返回:已解析的文本方向。返回以下之一:
573 View.TEXT_DIRECTION_FIRST_STRONG View.TEXT_DIRECTION_ANY_RTL、View.TEXT_DIRECTION_LTR、View.TEXT_DIRECTION_RTL、View.TEXT_DIRECTION_LOCALE
574 */
575 fn get_text_direction(&self) -> i32;
576
577 /**
578 告知此视图父级是否可以解决文本对齐问题。请参阅 View.setTextAlignment(int)
579 返回:如果此视图父级可以解决文本对齐问题,则返回 True。
580 */
581 fn can_resolve_text_alignment(&self) -> bool;
582
583 /**
584 告知此视图父级是否可以解决文本对齐问题。请参阅 View.setTextAlignment(int)
585 返回:如果此视图父级可以解决文本对齐问题,则返回 True。
586 */
587 fn is_text_alignment_resolved(&self) -> bool;
588
589 /**
590 对启动嵌套滚动操作的子视图做出反应,在适当的情况下声明嵌套滚动操作。此方法将在子视图调用 View.startNestedScroll(int) 时调用。视图层次结构中的每个父视图都将有机会通过返回 true 来响应和声明嵌套滚动操作。
591 此方法可能被 ViewParent 实现覆盖,以指示视图何时愿意支持即将开始的嵌套滚动操作。如果它返回 true,则此 ViewParent 将成为目标视图的嵌套滚动父视图,直至滚动操作完成。当嵌套滚动完成时,此 ViewParent 将收到对 onStopNestedScroll(View) 的调用。
592 如果此 ViewParent 接受嵌套滚动操作,则返回 true
593 `child` 包含目标的此 ViewParent 的直接子视图
594 `target` 发起嵌套滚动的视图
595 `nested_scroll_axes` 由 View.SCROLL_AXIS_HORIZONTAL、View.SCROLL_AXIS_VERTICAL 或两者组成的标志
596 */
597 fn on_start_nested_scroll(&self, child: &View, target: &View, nested_scroll_axes: i32) -> bool;
598
599 /**
600 对成功声明嵌套滚动操作做出反应。此方法将在 onStartNestedScroll 返回 true 后调用。它为视图及其超类提供了对嵌套滚动执行初始配置的机会。此方法的实现应始终调用其超类对此方法的实现(如果存在)。
601 `child` 此 ViewParent 的直接子级,包含 target
602 `target` 启动嵌套滚动的视图
603 `nested_scroll_axes` 由 View.SCROLL_AXIS_HORIZONTAL、View.SCROLL_AXIS_VERTICAL 或两者组成的标志
604 */
605 fn on_nested_scroll_accepted(&self, child: &View, target: &View, nested_scroll_axes: i32);
606
607 /**
608 对嵌套滚动操作结束做出反应。在嵌套滚动操作后执行清理。当嵌套滚动停止时,将调用此方法,例如当嵌套触摸滚动以 MotionEvent.ACTION_UP 或 MotionEvent.ACTION_CANCEL 事件结束时。此方法的实现应始终调用其超类对此方法的实现(如果存在)。
609 `target` 启动嵌套滚动的视图
610 */
611 fn on_stop_nested_scroll(&self, target: &View);
612
613 /**
614 对正在进行的嵌套滚动做出反应。当 ViewParent 的当前嵌套滚动子视图分派嵌套滚动事件时,将调用此方法。要接收对此方法的调用,ViewParent 必须先前已为 onStartNestedScroll(View, View, int) 调用返回 true。
615 滚动距离的已消耗部分和未消耗部分均报告给 ViewParent。例如,实现可以选择使用已消耗部分来匹配或追踪多个子元素的滚动位置。未消耗部分可用于允许连续拖动多个滚动或可拖动元素,例如滚动垂直抽屉内的列表,一旦到达内部滚动内容的边缘,抽屉便开始拖动。
616 `target` 控制嵌套滚动的后代视图
617 `dx_consumed` 目标已消耗的水平滚动距离(以像素为单位)
618 `dy_consumed` 目标已消耗的垂直滚动距离(以像素为单位)
619 `dx_unconsumed` 目标未消耗的水平滚动距离(以像素为单位)
620 `dy_unconsumed` 目标未消耗的垂直滚动距离(以像素为单位)
621 */
622 fn on_nested_scroll(
623 &self,
624 target: &View,
625 dx_consumed: i32,
626 dy_consumed: i32,
627 dx_unconsumed: i32,
628 dy_unconsumed: i32,
629 );
630
631 /**
632 从嵌套滚动请求一次抛出。此方法表示嵌套滚动子视图已检测到适合抛出的条件。通常,这意味着触摸滚动已在滚动方向上以达到或超过可滚动轴上的最小抛出速度的速度结束。
633 如果嵌套滚动子视图通常会抛出但位于其自身内容的边缘,则可以使用此方法将抛出委托给其嵌套滚动父视图。父视图可以选择使用抛出或观察子视图的抛出。
634 返回:如果此父视图消耗了抛出或以其他方式对抛出做出反应,则为 true
635 `target` 发起嵌套滚动的视图。
636 `velocity_x` 水平速度(以像素/秒为单位)。
637 `velocity_y` 垂直速度(以像素/秒为单位)。
638 `consumed` 如果子视图消耗了抛出,则为 true,否则为 false。
639 */
640 fn on_nested_fling(
641 &self,
642 target: &View,
643 velocity_x: f32,
644 velocity_y: f32,
645 consumed: bool,
646 ) -> bool;
647
648 /**
649 在目标视图使用嵌套的快速滑动之前对其做出反应。此方法表示嵌套滚动子视图已检测到沿每个轴具有给定速度的快速滑动。通常,这意味着触摸滚动已在滚动方向上以达到或超过沿可滚动轴的最小快速滑动速度的速度结束。
650 如果嵌套滚动父视图正在将运动作为预滚动的一部分使用,则它可能也适合使用预快速滑动以完成相同的运动。通过从此方法返回 true,父视图表示子视图也不应该快速滑动其自己的内部内容。
651 返回:如果此父视图在目标视图之前使用了快速滑动,则返回 true
652 `target` 发起嵌套滚动的视图。
653 `velocity_x` 水平速度(以像素/秒为单位)。
654 `velocity_y` 垂直速度(以像素/秒为单位)。
655 */
656 fn on_nested_pre_fling(&self, target: &View, velocity_x: f32, velocity_y: f32) -> bool;
657
658 /**
659 在目标处理目标后代视图委托的可访问性操作之前,对它做出反应。如果目标希望让其父链中的视图有机会在正常处理发生之前对事件做出反应,则目标后代视图可以调用此方法。
660 最常见的是滚动事件,例如 android.view.accessibility.AccessibilityNodeInfo.ACTION_SCROLL_FORWARD。支持充当嵌套滚动父级的 ViewParent 应覆盖此方法并采取相应行动,以通过可访问性系统实现滚动。
661 返回:true,如果此 ViewParent 使用了此操作
662 `target` 调度此操作的目标视图。
663 `action` 正在执行的操作;请参阅 android.view.accessibility.AccessibilityNodeInfo。
664 `arguments` 可选的操作参数。
665 */
666 fn on_nested_pre_perform_accessibility_action(
667 &self,
668 target: &View,
669 action: i32,
670 arguments: Option<Bundle>,
671 ) -> bool;
672}
673
674/// 当视图被点击时调用的回调的接口定义。
675#[allow(non_camel_case_types)]
676#[java_interface(name = "android/view/View$OnClickListener")]
677pub trait View_OnClickListener {
678 /**
679 当单击某个视图时调用。
680 `v` 被单击的视图。
681 */
682 fn on_click(&self, v: View);
683}
684
685#[doc(hidden)]
686#[allow(non_camel_case_types)]
687#[java_class(name = "android/view/View$OnClickListenerImpl")]
688pub struct View_OnClickListenerImpl(Box<dyn Fn(View) + Send + Sync>);
689
690impl View_OnClickListenerImpl {
691 pub fn from_fn(func: impl Fn(/* v */ View) + Send + Sync + 'static) -> Result<Arc<Self>> {
692 Self::new(View_OnClickListenerImplDefault(Box::new(func)))
693 }
694}
695
696impl Default for View_OnClickListenerImplDefault {
697 fn default() -> Self {
698 Self(Box::new(|v| unimplemented!("{:?}", v)))
699 }
700}
701
702#[java_implement]
703impl View_OnClickListener for View_OnClickListenerImpl {
704 fn on_click(&self, v: View) {
705 self.0(v)
706 }
707}
708
709/**
710接口允许您向 Activity 添加和删除子视图。要获取此类的实例,请调用 Context.getSystemService()。
711*/
712#[java_interface(name = "android/view/ViewManager")]
713pub trait ViewManager: JType {
714 /**
715 将传递的 LayoutParams 分配给传递的 View,并将该视图添加到窗口。对于某些编程错误,例如在未移除第一个视图的情况下向窗口添加第二个视图,将抛出 WindowManager.BadTokenException。
716 如果窗口位于辅助显示器上并且找不到指定的显示器,则抛出 WindowManager.InvalidDisplayException(请参阅 android.app.Presentation)。
717 `view` 要添加到此窗口的视图。
718 `params` 要分配给视图的 LayoutParams。
719 */
720 fn add_view(&self, view: &View, params: &ViewGroup_LayoutParams) -> Result<()>;
721
722 #[doc(hidden)]
723 fn update_view_layout(&self, view: &View, params: &ViewGroup_LayoutParams);
724
725 #[doc(hidden)]
726 fn remove_view(&self, view: &View);
727}
728
729/**
730应用用于与窗口管理器通信的接口。每个窗口管理器实例都绑定到一个 Display。要获取与显示器关联的 WindowManager,请调用 Context.createWindowContext(Display, int, Bundle) 以获取显示器的 UI 上下文,然后在 UI 上下文上调用 Context.getSystemService(String) 或 Context.getSystemService(Class)。
731在特定显示器上显示窗口的最简单方法是创建一个 Presentation,它会自动获取显示器的 WindowManager 和上下文。
732*/
733#[java_interface(name = "android/view/WindowManager")]
734pub trait WindowManager: ViewManager {
735 #[doc(hidden)]
736 const PARCEL_KEY_SHORTCUTS_ARRAY: &'static str = "shortcuts_array";
737
738 /**
739 removeView 的特殊变体,在返回之前立即调用给定视图层次结构的 View.onDetachedFromWindow() 方法。这不适用于普通应用程序;正确使用它需要非常小心。
740 `view` 要删除的视图。
741 */
742 fn remove_view_immediate(&self, view: &View);
743
744 /**
745 返回此WindowManager实例将创建新窗口的显示器。尽管有此方法的名称,但返回的显示器不一定是系统的主要显示器(请参见Display.DEFAULT_DISPLAY)。
746 返回的显示可能是此窗口管理器实例正在管理的辅助显示。将其视为此WindowManager实例默认使用的显示。要在其他显示器上创建窗口,您需要为该显示器获得一个WindowManager。 (有关更多信息,请参见WindowManager类文档。)
747 返回:此窗口管理器正在管理的显示器。
748 */
749 #[deprecated(note = "改用 Context.getDisplay()。")]
750 #[java_method]
751 fn get_default_display(&self) -> Display {}
752}
753
754#[doc(hidden)]
755#[java_class(name = "android/view/WindowManagerImpl")]
756pub struct WindowManagerImpl;
757
758impl ViewManager for WindowManagerImpl {
759 #[java_method]
760 fn add_view(&self, view: &View, params: &ViewGroup_LayoutParams) -> Result<()> {}
761
762 #[java_method]
763 fn update_view_layout(&self, view: &View, params: &ViewGroup_LayoutParams) {}
764
765 #[java_method]
766 fn remove_view(&self, view: &View) {}
767}
768
769impl WindowManager for WindowManagerImpl {
770 #[java_method]
771 fn remove_view_immediate(&self, view: &View) {}
772}
773
774/**
775ViewGroup 是一种特殊视图,可以包含其他视图(称为子视图)。视图组是布局和视图容器的基类。
776此类还定义了 ViewGroup.LayoutParams 类,该类用作布局参数的基类。另请参阅 ViewGroup.LayoutParams 以了解布局属性。
777
778开发者指南
779有关创建用户界面布局的更多信息,请阅读 XML 布局开发者指南。以下是自定义 ViewGroup 的完整实现,它实现了简单的 android.widget.FrameLayout,并能够在左右边缘堆叠子视图。
780@sample development/samples/ApiDemos/src/com/example/android/apis/view/CustomLayout.java 完整版
781如果您正在实现示例中所示的 XML 布局属性,则这是它们在 res/values/attrs.xml 中的对应定义:
782@sample development/samples/ApiDemos/res/values/attrs.xml CustomLayout
783最后,布局管理器可以在 XML 布局中使用,如下所示:
784@sample development/samples/ApiDemos/res/layout/custom_layout.xml 完整版
785*/
786#[java_class(name = "android/view/ViewGroup", extends=View)]
787pub struct ViewGroup;
788
789impl ViewGroup {
790 /**
791 添加子视图。如果子视图上尚未设置布局参数,则此 ViewGroup 的默认参数将设置在该子视图上。
792 注意:不要从 draw(Canvas)、onDraw(Canvas)、dispatchDraw(Canvas) 或任何相关方法调用此方法。
793 `child` 要添加的子视图
794 */
795 #[java_method]
796 pub fn add_view(&self, child: &View) {}
797
798 /**
799 调用此方法可从 ViewGroup 中删除所有子视图。
800 注意:不要从 draw(Canvas)、onDraw(Canvas)、dispatchDraw(Canvas) 或任何相关方法调用此方法。
801 */
802 #[java_method]
803 pub fn remove_all_views(&self) {}
804
805 /**
806 当 ViewGroup 子类必须先知道其在屏幕上的大小,然后才能计算要渲染的子视图数量时,此方法会由 ViewGroup 子类调用,以从自身移除子视图。例如 Gallery 或 ListView,它们可能“有”50 个子视图,但实际上只渲染当前可容纳在屏幕上的对象内的子视图数量。除非您正在扩展 ViewGroup 并了解视图测量和布局管道,否则请不要调用此方法。
807 注意:不要从 draw(Canvas)、onDraw(Canvas)、dispatchDraw(Canvas) 或任何相关方法调用此方法。
808 */
809 pub fn remove_all_views_in_layout(&self) {}
810}
811
812impl ViewManager for ViewGroup {
813 #[java_method]
814 fn add_view(&self, view: &View, params: &ViewGroup_LayoutParams) -> Result<()> {}
815
816 #[java_method]
817 fn update_view_layout(&self, view: &View, params: &ViewGroup_LayoutParams) {}
818
819 #[java_method]
820 fn remove_view(&self, view: &View) {}
821}
822
823impl ViewParent for ViewGroup {
824 type VP = Self;
825
826 #[java_method]
827 fn request_layout(&self) {}
828
829 #[java_method]
830 fn is_layout_requested(&self) -> bool {}
831
832 #[java_method]
833 fn request_transparent_region(&self, child: &View) {}
834
835 #[java_method(type_bound=(Self::VP, ViewParent))]
836 fn get_parent(&self) -> Option<Self::VP> {}
837
838 #[java_method]
839 fn request_child_focus(&self, child: &View, focused: &View) {}
840
841 #[java_method]
842 fn recompute_view_attributes(&self, child: &View) {}
843
844 #[java_method]
845 fn clear_child_focus(&self, child: &View) {}
846
847 #[java_method]
848 fn focus_search(&self, v: &View, direction: i32) -> View {}
849
850 #[java_method]
851 fn bring_child_to_front(&self, child: &View) {}
852
853 #[java_method]
854 fn show_context_menu_for_child(&self, original_view: &View) -> bool {}
855
856 #[java_method]
857 fn child_drawable_state_changed(&self, child: &View) {}
858
859 #[java_method]
860 fn request_disallow_intercept_touch_event(&self, disallow_intercept: bool) {}
861
862 #[java_method]
863 fn child_has_transient_state_changed(&self, child: &View, has_transient_state: bool) {}
864
865 #[java_method]
866 fn request_fit_system_windows(&self) {}
867
868 #[java_method(type_bound=(Self::VP, ViewParent))]
869 fn get_parent_for_accessibility(&self) -> Option<Self::VP> {}
870
871 #[java_method]
872 fn notify_subtree_accessibility_state_changed(
873 &self,
874 child: &View,
875 source: &View,
876 change_type: i32,
877 ) {
878 }
879
880 #[java_method]
881 fn can_resolve_layout_direction(&self) -> bool {}
882
883 #[java_method]
884 fn is_layout_direction_resolved(&self) -> bool {}
885
886 #[java_method]
887 fn get_layout_direction(&self) -> i32 {}
888
889 #[java_method]
890 fn can_resolve_text_direction(&self) -> bool {}
891
892 #[java_method]
893 fn is_text_direction_resolved(&self) -> bool {}
894
895 #[java_method]
896 fn get_text_direction(&self) -> i32 {}
897
898 #[java_method]
899 fn can_resolve_text_alignment(&self) -> bool {}
900
901 #[java_method]
902 fn is_text_alignment_resolved(&self) -> bool {}
903
904 #[java_method]
905 fn on_start_nested_scroll(&self, child: &View, target: &View, nested_scroll_axes: i32) -> bool {
906 }
907
908 #[java_method]
909 fn on_nested_scroll_accepted(&self, child: &View, target: &View, nested_scroll_axes: i32) {}
910
911 #[java_method]
912 fn on_stop_nested_scroll(&self, target: &View) {}
913
914 #[java_method]
915 fn on_nested_scroll(
916 &self,
917 target: &View,
918 dx_consumed: i32,
919 dy_consumed: i32,
920 dx_unconsumed: i32,
921 dy_unconsumed: i32,
922 ) {
923 }
924
925 #[java_method]
926 fn on_nested_fling(
927 &self,
928 target: &View,
929 velocity_x: f32,
930 velocity_y: f32,
931 consumed: bool,
932 ) -> bool {
933 }
934
935 #[java_method]
936 fn on_nested_pre_fling(&self, target: &View, velocity_x: f32, velocity_y: f32) -> bool {}
937
938 #[java_method]
939 fn on_nested_pre_perform_accessibility_action(
940 &self,
941 target: &View,
942 action: i32,
943 arguments: Option<Bundle>,
944 ) -> bool {
945 }
946}
947
948/**
949视图使用 LayoutParams 来告诉其父级它们希望如何布局。请参阅 ViewGroup 布局属性,了解此类支持的所有子视图属性的列表。
950基本 LayoutParams 类仅描述视图希望的宽度和高度。对于每个维度,它可以指定以下之一:
951FILL_PARENT(在 API 级别 8 及更高版本中重命名为 MATCH_PARENT),这意味着视图希望与其父级一样大(减去填充)
952WRAP_CONTENT,这意味着视图希望足够大以包含其内容(加上填充)
953
954一个确切的数字
955对于不同的 ViewGroup 子类,有 LayoutParams 的子类。例如,AbsoluteLayout 有自己的 LayoutParams 子类,它添加了 X 和 Y 值。
956
957开发人员指南
958有关创建用户界面布局的更多信息,请阅读 XML 布局开发人员指南。
959*/
960#[allow(non_camel_case_types)]
961#[java_class(name = "android/view/ViewGroup$LayoutParams")]
962pub struct ViewGroup_LayoutParams;
963
964impl ViewGroup_LayoutParams {
965 /// 视图请求的高度或宽度的特殊值。FILL_PARENT 表示视图希望与其父级一样大,减去父级的填充(如果有)。
966 #[deprecated(note = "从 API 级别 8 开始,此值已弃用,并由 MATCH_PARENT 取代。")]
967 pub const FILL_PARENT: i32 = -1;
968
969 /// 视图请求的高度或宽度的特殊值。MATCH_PARENT 表示视图希望与其父级一样大,减去父级的填充(如果有)。在 API 级别 8 中引入。
970 pub const MATCH_PARENT: i32 = -1;
971
972 /// 视图请求的高度或宽度的特殊值。WRAP_CONTENT 表示视图希望足够大以容纳其自己的内部内容,同时考虑其自己的填充。
973 pub const WRAP_CONTENT: i32 = -2;
974
975 /// 有关视图所需宽度的信息。可以是常量 FILL_PARENT(在 API 级别 8 中由 MATCH_PARENT 取代)或 WRAP_CONTENT 之一,也可以是确切的大小。
976 #[java_field]
977 pub fn get_width(&self) -> i32 {}
978
979 /// 有关视图所需宽度的信息。可以是常量 FILL_PARENT(在 API 级别 8 中由 MATCH_PARENT 取代)或 WRAP_CONTENT 之一,也可以是确切的大小。
980 #[java_field]
981 pub fn set_width(&self, value: i32) {}
982
983 /// 有关视图所需高度的信息。可以是常量 FILL_PARENT(在 API 级别 8 中由 MATCH_PARENT 取代)或 WRAP_CONTENT 之一,也可以是确切的大小。
984 #[java_field]
985 pub fn get_height(&self) -> i32 {}
986
987 /// 有关视图所需高度的信息。可以是常量 FILL_PARENT(在 API 级别 8 中由 MATCH_PARENT 取代)或 WRAP_CONTENT 之一,也可以是确切的大小。
988 #[java_field]
989 pub fn set_height(&self, value: i32) {}
990
991 /**
992 创建一组具有指定宽度和高度的新布局参数。
993 `width` 宽度,可以是 WRAP_CONTENT、FILL_PARENT(在 API 级别 8 中由 MATCH_PARENT 替换),也可以是固定大小(以像素为单位)
994 `height` 高度,可以是 WRAP_CONTENT、FILL_PARENT(在 API 级别 8 中由 MATCH_PARENT 替换),也可以是固定大小(以像素为单位)
995 */
996 #[java_constructor]
997 pub fn new(width: i32, height: i32) -> Self {}
998}
999
1000/**
1001支持边距的布局的每个子视图布局信息。请参阅 ViewGroup 边距布局属性,查看此类支持的所有子视图属性的列表。
1002*/
1003#[allow(non_camel_case_types)]
1004#[java_class(name = "android/view/ViewGroup$MarginLayoutParams", extends=ViewGroup_LayoutParams)]
1005pub struct ViewGroup_MarginLayoutParams;
1006
1007impl ViewGroup_MarginLayoutParams {
1008 /// 默认的开始和结束边距。
1009 pub const DEFAULT_MARGIN_RELATIVE: u32 = Integer::MIN_VALUE;
1010
1011 /// 子项的左边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1012 #[java_field]
1013 pub fn get_left_margin(&self) -> i32 {}
1014
1015 /// 子项的左边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1016 #[java_field]
1017 pub fn set_left_margin(&self, value: i32) {}
1018
1019 /// 子项的上边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1020 #[java_field]
1021 pub fn get_top_margin(&self) -> i32 {}
1022
1023 /// 子项的上边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1024 #[java_field]
1025 pub fn set_top_margin(&self, value: i32) {}
1026
1027 /// 子项的右边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1028 #[java_field]
1029 pub fn get_right_margin(&self) -> i32 {}
1030
1031 /// 子项的右边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1032 #[java_field]
1033 pub fn set_right_margin(&self, value: i32) {}
1034
1035 /// 子项的底部边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1036 #[java_field]
1037 pub fn get_bottom_margin(&self) -> i32 {}
1038
1039 /// 子项的底部边距(以像素为单位)。边距值应为正数。为此字段重新分配新值后,调用 setLayoutParams(ViewGroup. LayoutParams)。
1040 #[java_field]
1041 pub fn set_bottom_margin(&self, value: i32) {}
1042
1043 #[doc(hidden)]
1044 #[java_constructor]
1045 pub fn new(width: i32, height: i32) -> Self {}
1046
1047 #[doc(hidden)]
1048 #[java_constructor]
1049 pub fn from_layout_params(source: &ViewGroup_LayoutParams) -> Self {}
1050}
1051
1052#[doc(hidden)]
1053#[allow(non_camel_case_types)]
1054#[java_class(name = "android/view/WindowManager$LayoutParams", extends=ViewGroup_LayoutParams)]
1055pub struct WindowManager_LayoutParams;
1056
1057impl WindowManager_LayoutParams {
1058 /// 代表正常应用程序窗口的窗口类型的启动。
1059 pub const FIRST_APPLICATION_WINDOW: i32 = 1;
1060
1061 /// 窗口类型:作为整个应用程序的“基础”窗口的应用程序窗口;所有其他应用程序窗口将显示在其上方。在多用户系统中,仅显示在拥有该应用程序的用户窗口上。
1062 pub const TYPE_BASE_APPLICATION: i32 = 1;
1063
1064 /// 窗口类型:普通应用程序窗口。令牌必须是活动令牌,用于标识窗口所属用户。在多用户系统中,仅显示在所属用户的窗口上。
1065 pub const TYPE_APPLICATION: i32 = 2;
1066
1067 /// 窗口类型:应用程序启动时显示的特殊应用程序窗口。应用程序本身不使用它;系统使用它来显示某些内容,直到应用程序可以显示自己的窗口。在多用户系统中,显示在所有用户的窗口上。
1068 pub const TYPE_APPLICATION_STARTING: i32 = 3;
1069
1070 /// 窗口类型:TYPE_APPLICATION 的变体,确保窗口管理器将等待此窗口绘制完毕后再显示应用。在多用户系统中,仅显示在拥有该应用的用户窗口上。
1071 pub const TYPE_DRAWN_APPLICATION: i32 = 4;
1072
1073 /// 申请窗口类型的结束。
1074 pub const LAST_APPLICATION_WINDOW: i32 = 99;
1075
1076 /// 子窗口类型的开始。这些窗口的标记必须设置为它们所附加到的窗口。这些类型的窗口在 Z 顺序上紧挨着它们所附加到的窗口,并且它们的坐标空间相对于它们所附加到的窗口。
1077 pub const FIRST_SUB_WINDOW: i32 = 1000;
1078
1079 /// 窗口类型:位于应用程序窗口顶部的面板。这些窗口出现在其附属窗口的顶部。
1080 pub const TYPE_APPLICATION_PANEL: i32 = Self::FIRST_SUB_WINDOW;
1081
1082 /// 窗口类型:用于显示媒体(如视频)的窗口。这些窗口显示在其附属窗口的后面。
1083 pub const TYPE_APPLICATION_MEDIA: i32 = Self::FIRST_SUB_WINDOW + 1;
1084
1085 /// 窗口类型:应用程序窗口顶部的子面板。这些窗口显示在其附属窗口和任何 TYPE_APPLICATION_PANEL 面板的顶部。
1086 pub const TYPE_APPLICATION_SUB_PANEL: i32 = Self::FIRST_SUB_WINDOW + 2;
1087
1088 /// 窗口类型:类似于 TYPE_APPLICATION_PANEL,但窗口的布局与顶层窗口一样,而不是作为其容器的子窗口。
1089 pub const TYPE_APPLICATION_ATTACHED_DIALOG: i32 = Self::FIRST_SUB_WINDOW + 3;
1090
1091 /// 窗口类型:用于在媒体窗口顶部显示覆盖层的窗口。这些窗口显示在 TYPE_APPLICATION_MEDIA 和应用程序窗口之间。它们应该是半透明的,以便于使用。这是一个非常丑陋的 hack,因此:
1092 pub const TYPE_APPLICATION_MEDIA_OVERLAY: i32 = Self::FIRST_SUB_WINDOW + 4;
1093
1094 /// 窗口类型:位于应用程序窗口及其子面板窗口上方的子面板。这些窗口显示在其附属窗口和任何 TYPE_APPLICATION_SUB_PANEL 面板的上方。
1095 pub const TYPE_APPLICATION_ABOVE_SUB_PANEL: i32 = Self::FIRST_SUB_WINDOW + 5;
1096
1097 /// 子窗口类型的结束。
1098 pub const LAST_SUB_WINDOW: i32 = 1999;
1099
1100 /// 启动系统特定的窗口类型。这些窗口类型通常不是由应用程序创建的。
1101 pub const FIRST_SYSTEM_WINDOW: i32 = 2000;
1102
1103 /// 窗口类型:状态栏。只能有一个状态栏窗口;它位于屏幕顶部,所有其他窗口都向下移动,因此它们位于其下方。在多用户系统中显示在所有用户的窗口上。
1104 pub const TYPE_STATUS_BAR: i32 = Self::FIRST_SYSTEM_WINDOW;
1105
1106 /// 窗口类型:搜索栏。只能有一个搜索栏窗口;它位于屏幕顶部。在多用户系统中显示在所有用户的窗口上。
1107 pub const TYPE_SEARCH_BAR: i32 = Self::FIRST_SYSTEM_WINDOW + 1;
1108
1109 /// 窗口类型:电话。这些是非应用程序窗口,用于为用户提供与电话的交互(尤其是来电)。这些窗口通常位于所有应用程序之上,但在状态栏后面。在多用户系统中显示在所有用户的窗口上。
1110 #[deprecated(note = "适用于非系统应用。请改用 TYPE_APPLICATION_OVERLAY。")]
1111 pub const TYPE_PHONE: i32 = Self::FIRST_SYSTEM_WINDOW + 2;
1112
1113 /// 窗口类型:系统窗口,例如低电量警报。这些窗口始终位于应用程序窗口之上。在多用户系统中,仅显示在拥有用户的窗口上。
1114 #[deprecated(note = "适用于非系统应用。请改用 TYPE_APPLICATION_OVERLAY。")]
1115 pub const TYPE_SYSTEM_ALERT: i32 = Self::FIRST_SYSTEM_WINDOW + 3;
1116
1117 /// 窗口类型:键盘保护窗口。在多用户系统中显示在所有用户的窗口上。
1118 pub const TYPE_KEYGUARD: i32 = Self::FIRST_SYSTEM_WINDOW + 4;
1119
1120 /// 窗口类型:瞬态通知。在多用户系统中,仅显示在拥有用户的窗口上。
1121 #[deprecated(note = "适用于非系统应用。请改用 TYPE_APPLICATION_OVERLAY。")]
1122 pub const TYPE_TOAST: i32 = Self::FIRST_SYSTEM_WINDOW + 5;
1123
1124 /// 窗口类型:系统覆盖窗口,需要显示在所有其他窗口之上。这些窗口不得获取输入焦点,否则会干扰键盘保护。在多用户系统中,仅显示在拥有用户的窗口上。
1125 #[deprecated(note = "适用于非系统应用。请改用 TYPE_APPLICATION_OVERLAY。")]
1126 pub const TYPE_SYSTEM_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 6;
1127
1128 /// 窗口类型:优先手机 UI,即使键盘锁处于活动状态也需要显示。这些窗口不得获取输入焦点,否则会干扰键盘锁。在多用户系统中显示在所有用户的窗口上。
1129 #[deprecated(note = "适用于非系统应用。请改用 TYPE_APPLICATION_OVERLAY。")]
1130 pub const TYPE_PRIORITY_PHONE: i32 = Self::FIRST_SYSTEM_WINDOW + 7;
1131
1132 /// 窗口类型:在多用户系统中从状态栏滑出的面板显示在所有用户的窗口上。
1133 pub const TYPE_SYSTEM_DIALOG: i32 = Self::FIRST_SYSTEM_WINDOW + 8;
1134
1135 /// 窗口类型:键盘保护显示的对话框在多用户系统中显示在所有用户的窗口上。
1136 pub const TYPE_KEYGUARD_DIALOG: i32 = Self::FIRST_SYSTEM_WINDOW + 9;
1137
1138 /// 窗口类型:内部系统错误窗口,显示在所有可能出现的窗口之上。在多用户系统中,仅显示在所属用户的窗口上。
1139 #[deprecated(note = "适用于非系统应用。请改用 TYPE_APPLICATION_OVERLAY。")]
1140 pub const TYPE_SYSTEM_ERROR: i32 = Self::FIRST_SYSTEM_WINDOW + 10;
1141
1142 /// 窗口类型:内部输入法窗口,显示在正常 UI 上方。可以调整应用程序窗口的大小或平移,以便在显示此窗口时保持输入焦点可见。在多用户系统中,仅显示在拥有用户的窗口上。
1143 pub const TYPE_INPUT_METHOD: i32 = Self::FIRST_SYSTEM_WINDOW + 11;
1144
1145 /// 窗口类型:内部输入法对话窗口,显示在当前输入法窗口上方。在多用户系统中,仅显示在所属用户的窗口上。
1146 pub const TYPE_INPUT_METHOD_DIALOG: i32 = Self::FIRST_SYSTEM_WINDOW + 12;
1147
1148 /// 窗口类型:壁纸窗口,放置在任何想要位于壁纸之上的窗口后面。在多用户系统中,仅显示在拥有该壁纸的用户窗口上。
1149 pub const TYPE_WALLPAPER: i32 = Self::FIRST_SYSTEM_WINDOW + 13;
1150
1151 /// 窗口类型:在多用户系统中从状态栏滑出的面板显示在所有用户的窗口上。
1152 pub const TYPE_STATUS_BAR_PANEL: i32 = Self::FIRST_SYSTEM_WINDOW + 14;
1153
1154 /**
1155 窗口类型:安全系统覆盖窗口,需要显示在所有其他窗口之上。这些窗口不得获取输入焦点,否则会干扰键盘保护。
1156 这与 TYPE_SYSTEM_OVERLAY 完全相同,不同之处在于只有系统本身才被允许创建这些覆盖层。应用程序无法获得创建安全系统覆盖层的权限。
1157 在多用户系统中仅显示在所属用户的窗口上。
1158 */
1159 pub const TYPE_SECURE_SYSTEM_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 15;
1160
1161 /// 窗口类型:拖放式伪窗口。最多只有一个拖放层,并放置在所有其他窗口之上。在多用户系统中,仅显示在拥有该窗口的用户窗口上。
1162 pub const TYPE_DRAG: i32 = Self::FIRST_SYSTEM_WINDOW + 16;
1163
1164 /// 窗口类型:在多用户系统中,从状态栏滑出的面板显示在所有用户的窗口上。这些窗口显示在状态栏和任何 TYPE_STATUS_BAR_PANEL 窗口的顶部。
1165 pub const TYPE_STATUS_BAR_SUB_PANEL: i32 = Self::FIRST_SYSTEM_WINDOW + 17;
1166
1167 /// 窗口类型:(鼠标)指针在多用户系统中显示在所有用户的窗口上。
1168 pub const TYPE_POINTER: i32 = Self::FIRST_SYSTEM_WINDOW + 18;
1169
1170 /// 窗口类型:导航栏(与状态栏不同)在多用户系统中显示在所有用户的窗口上。
1171 pub const TYPE_NAVIGATION_BAR: i32 = Self::FIRST_SYSTEM_WINDOW + 19;
1172
1173 /// 窗口类型:用户更改系统音量时显示的音量级别覆盖/对话框。在多用户系统中,显示在所有用户的窗口上。
1174 pub const TYPE_VOLUME_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 20;
1175
1176 /// 窗口类型:启动进度对话框,位于所有内容之上。在多用户系统中显示在所有用户的窗口上。
1177 pub const TYPE_BOOT_PROGRESS: i32 = Self::FIRST_SYSTEM_WINDOW + 21;
1178
1179 /// 当系统 UI 栏隐藏时,窗口类型会消耗输入事件。在多用户系统中,显示在所有用户的窗口上。
1180 pub const TYPE_INPUT_CONSUMER: i32 = Self::FIRST_SYSTEM_WINDOW + 22;
1181
1182 /// 窗口类型:导航栏面板(当导航栏与状态栏不同时)在多用户系统中显示在所有用户的窗口上。
1183 pub const TYPE_NAVIGATION_BAR_PANEL: i32 = Self::FIRST_SYSTEM_WINDOW + 24;
1184
1185 /// 窗口类型:显示覆盖窗口。用于模拟辅助显示设备。在多用户系统中显示在所有用户的窗口上。
1186 pub const TYPE_DISPLAY_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 26;
1187
1188 /// 窗口类型:放大覆盖窗口。用于在启用辅助放大功能时突出显示放大的部分。在多用户系统中显示在所有用户的窗口上。
1189 pub const TYPE_MAGNIFICATION_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 27;
1190
1191 /// 窗口类型:私人虚拟显示器上方的演示窗口。
1192 pub const TYPE_PRIVATE_PRESENTATION: i32 = Self::FIRST_SYSTEM_WINDOW + 30;
1193
1194 /// 窗口类型:语音交互层的窗口。
1195 pub const TYPE_VOICE_INTERACTION: i32 = Self::FIRST_SYSTEM_WINDOW + 31;
1196
1197 //noinspection SpellCheckingInspection
1198 /// 窗口类型:仅由连接的 android.accessibilityservice.AccessibilityService 覆盖的窗口,用于拦截用户交互,而不会更改无障碍服务可以自检的窗口。具体而言,无障碍服务只能自检视力正常的用户可以与之交互的窗口,也就是说,他们可以触摸这些窗口或在这些窗口中键入内容。例如,如果有一个可触摸的全屏无障碍覆盖,那么它下面的窗口即使被可触摸窗口覆盖,也将是无障碍服务可自检的。
1199 pub const TYPE_ACCESSIBILITY_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 32;
1200
1201 /// 窗口类型:语音交互层的起始窗口。
1202 pub const TYPE_VOICE_INTERACTION_STARTING: i32 = Self::FIRST_SYSTEM_WINDOW + 33;
1203
1204 /// 用于显示用于调整停靠堆栈大小的句柄的窗口。此窗口归系统进程所有。
1205 pub const TYPE_DOCK_DIVIDER: i32 = Self::FIRST_SYSTEM_WINDOW + 34;
1206
1207 /// 窗口类型:类似于 TYPE_APPLICATION_ATTACHED_DIALOG,但由快速设置图块使用。
1208 pub const TYPE_QS_DIALOG: i32 = Self::FIRST_SYSTEM_WINDOW + 35;
1209
1210 /// 窗口类型:直接显示在键盘保护上方。此层保留用于屏幕截图动画、区域选择和 UI。在多用户系统中,仅显示在拥有用户的窗口上。
1211 pub const TYPE_SCREENSHOT: i32 = Self::FIRST_SYSTEM_WINDOW + 36;
1212
1213 /// 窗口类型:在外部显示器上演示的窗口。
1214 pub const TYPE_PRESENTATION: i32 = Self::FIRST_SYSTEM_WINDOW + 37;
1215
1216 /// 窗口类型:应用叠加窗口显示在所有活动窗口(类型介于 FIRST_APPLICATION_WINDOW 和 LAST_APPLICATION_WINDOW 之间)上方,但位于状态栏或 IME 等关键系统窗口下方。系统可能会随时更改这些窗口的位置、大小或可见性,以减少用户的视觉混乱并管理资源。需要 android.Manifest.permission#SYSTEM_ALERT_WINDOW 权限。系统将调整具有此窗口类型的进程的重要性,以降低低内存终止程序终止它们的可能性。在多用户系统中,仅显示在拥有用户的屏幕上。
1217 pub const TYPE_APPLICATION_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 38;
1218
1219 /// 窗口类型:用于在其他窗口上方添加辅助功能窗口放大功能的窗口。这会将窗口置于覆盖窗口中。
1220 pub const TYPE_ACCESSIBILITY_MAGNIFICATION_OVERLAY: i32 = Self::FIRST_SYSTEM_WINDOW + 39;
1221
1222 /// 窗口类型:通知栏和键盘保护。只能有一个状态栏窗口;它位于屏幕顶部,所有其他窗口都向下移动,位于其下方。在多用户系统中,显示在所有用户的窗口上。
1223 pub const TYPE_NOTIFICATION_SHADE: i32 = Self::FIRST_SYSTEM_WINDOW + 40;
1224
1225 /// 窗口类型:用于在屏幕的非常规部分(即屏幕的左侧或底部)显示状态栏。在多用户系统中显示在所有用户的窗口上。
1226 pub const TYPE_STATUS_BAR_ADDITIONAL: i32 = Self::FIRST_SYSTEM_WINDOW + 41;
1227
1228 /// 系统窗口类型的结束。
1229 pub const LAST_SYSTEM_WINDOW: i32 = 2999;
1230
1231 /// 当没有合适的类型时在内部使用。
1232 pub const INVALID_WINDOW_TYPE: i32 = -1;
1233
1234 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
1235 pub const MEMORY_TYPE_NORMAL: i32 = 0;
1236
1237 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
1238 pub const MEMORY_TYPE_HARDWARE: i32 = 1;
1239
1240 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
1241 pub const MEMORY_TYPE_GPU: i32 = 2;
1242
1243 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
1244 pub const MEMORY_TYPE_PUSH_BUFFERS: i32 = 3;
1245
1246 /// 窗口标志:只要此窗口对用户可见,就允许在屏幕打开时激活锁定屏幕。这可以单独使用,也可以与 FLAG_KEEP_SCREEN_ON 和/或 FLAG_SHOW_WHEN_LOCKED 结合使用
1247 pub const FLAG_ALLOW_LOCK_WHILE_SCREEN_ON: u32 = 0x00000001;
1248
1249 /// 窗口标志:此窗口后面的所有内容都将变暗。使用 dimAmount 来控制暗淡程度。
1250 pub const FLAG_DIM_BEHIND: u32 = 0x00000002;
1251
1252 /// 窗口标志:为该窗口启用模糊功能。
1253 pub const FLAG_BLUR_BEHIND: u32 = 0x00000004;
1254
1255 /**
1256 窗口标志:此窗口永远不会获得按键输入焦点,因此用户无法向其发送按键或其他按钮事件。这些事件将转至其后面的任何可获得焦点的窗口。此标志还将启用 FLAG_NOT_TOUCH_MODAL,无论是否明确设置。
1257 设置此标志还意味着窗口将不需要与软输入法交互,因此它将按 Z 顺序排列并独立于任何活动输入法定位(通常这意味着它在输入法之上按 Z 顺序排列,因此它可以使用全屏显示其内容并在需要时覆盖输入法。您可以使用 FLAG_ALT_FOCUSABLE_IM 来修改此行为。
1258 */
1259 pub const FLAG_NOT_FOCUSABLE: u32 = 0x00000008;
1260
1261 /**
1262 窗口标志:此窗口永远不能接收触摸事件。
1263 此标志的目的是将触摸留给该窗口下方的某个窗口来处理(按 Z 顺序)。
1264 从Android Build.VERSION_CODES#S开始,出于安全原因,触摸事件通过包含此标志的窗口(即。在该窗口的边界内)将仅在以下一项(或多项)为真的情况下被递送到该触摸消费窗口:
1265 相同的UID:该窗口属于拥有该触摸消费窗口的同一UID。
1266 受信任的窗口:此窗口受信任。可信窗口包括(但不限于)辅助窗口(TYPE_ACCESSIBILITY_OVERLAY)、输入法(TYPE_INPUT_METHOD)和辅助窗口(TYPE_VOICE_INTERACTION)。类型为_APPLICATION_OVERLAY的窗口不受信任,请参见下文。
1267 不可见窗口:该窗口是视图#消失或视图#不可见。
1268 全透明窗口:此窗口的LayoutParams#Alpha等于0。
1269 一个具有足够透明度的SAW窗口:该窗口的类型为_APPLICATION_OVERLAY,其LayoutParams#Alpha小于或等于最大遮挡不透明度(见下文),并且它是触摸路径中该UID的唯一类型为_APPLICATION_OVERLAY的窗口。
1270 具有足够透明度的多个SAW窗口:从该UID开始的触摸路径中的多个重叠的TYPE_APPLICATION_OVERLAY窗口具有低于或等于最大遮挡不透明度的组合遮挡不透明度。有关如何计算该值的信息,请参见下面的组合遮挡不透明度一节。
1271 如果这些情况都不成立,则不会传递触摸,并且会将一条消息记录到LogCAT。
1272 最大遮挡不透明度此值为 0.8。如果应用希望从系统收集此值(而不是对其进行硬编码),则可能需要使用 android.hardware.input.InputManager#getMaximumObscuringOpacityForTouch()。
1273 组合遮挡不透明度
1274 一组窗口的组合遮挡不透明度是通过使用结合和交换运算将该集合中所有窗口的不透明度值组合而获得的,定义为:opacity({A,B}) = 1 - (1 - opacity(A))*(1 - opacity(B)),其中 ` `) = 1 - (1 - opacity(W1)) * ... * (1 - opacity(Wn))
1275 */
1276 pub const FLAG_NOT_TOUCHABLE: u32 = 0x00000010;
1277
1278 /// 窗口标志:即使此窗口可聚焦(其 FLAG_NOT_FOCUSABLE 未设置),也允许将窗口外的任何指针事件发送到其后面的窗口。否则它将自己消耗所有指针事件,无论它们是否在窗口内。
1279 pub const FLAG_NOT_TOUCH_MODAL: u32 = 0x00000020;
1280
1281 /// 窗口标志:设置后,如果按下触摸屏时设备处于休眠状态,您将收到此首次触摸事件。通常,首次触摸事件会被系统消耗,因为用户看不到他们按下的是什么。
1282 #[deprecated(note = "该标志无效。")]
1283 pub const FLAG_TOUCHABLE_WHEN_WAKING: u32 = 0x00000040;
1284
1285 /// 窗口标志:只要此窗口对用户可见,就保持设备屏幕开启且明亮。
1286 pub const FLAG_KEEP_SCREEN_ON: u32 = 0x00000080;
1287
1288 /**
1289 附加窗口的窗口标志:将窗口放置在整个屏幕内,忽略来自父窗口的任何限制。
1290 注意:在具有displayCutout的显示器上,可以将窗口放置,以便在必要时根据LayoutInDisplayCutOutMode避免显示屏区域。
1291 */
1292 pub const FLAG_LAYOUT_IN_SCREEN: u32 = 0x00000100;
1293
1294 /// 窗口标志:允许窗口延伸到屏幕之外。
1295 pub const FLAG_LAYOUT_NO_LIMITS: u32 = 0x00000200;
1296
1297 /**
1298 窗口标志:显示此窗口时隐藏所有屏幕装饰(例如状态栏)。这允许窗口为自己使用整个显示空间 - 当设置了此标志的应用窗口位于顶层时,状态栏将被隐藏。全屏窗口将忽略窗口的 softInputMode 字段的 SOFT_INPUT_ADJUST_RESIZE 值;窗口将保持全屏并且不会调整大小。
1299 您可以通过 android.R.attr#windowFullscreen 属性在您的主题中控制此标志;此属性会在标准全屏主题中自动为您设置,例如 android.R.style#Theme_NoTitleBar_Fullscreen、android.R.style#Theme_Black_NoTitleBar_Fullscreen、android.R.style#Theme_Light_NoTitleBar_Fullscreen、android.R.style#Theme_Holo_NoActionBar_Fullscreen、android.R.style#Theme_Holo_Light_NoActionBar_Fullscreen、android.R.style#Theme_DeviceDefault_NoActionBar_Fullscreen 和 android.R.style#Theme_DeviceDefault_Light_NoActionBar_Fullscreen。
1300 */
1301 #[deprecated(note = "将WindowInsetsController#hide(int)与Type#statusBars()一起使用。")]
1302 pub const FLAG_FULLSCREEN: u32 = 0x00000400;
1303
1304 /// 窗口标志:覆盖 FLAG_FULLSCREEN 并强制显示屏幕装饰(例如状态栏)。
1305 #[deprecated(note = "该值“意外”成为 API,不应被第三方应用程序使用。")]
1306 pub const FLAG_FORCE_NOT_FULLSCREEN: u32 = 0x00000800;
1307
1308 /// 窗口标志:将此窗口合成到屏幕时启用抖动。
1309 #[deprecated(note = "此标志不再使用。")]
1310 pub const FLAG_DITHER: u32 = 0x00001000;
1311
1312 /**
1313 窗口标志:将窗口内容视为安全,防止其出现在屏幕截图中或在非安全显示器上查看。
1314 有关安全表面和安全显示的更多详细信息,请参阅 android.view.Display#FLAG_SECURE。
1315 */
1316 pub const FLAG_SECURE: u32 = 0x00002000;
1317
1318 /// 窗口标志:一种特殊模式,其中布局参数用于在表面合成到屏幕时执行表面的缩放。
1319 pub const FLAG_SCALED: u32 = 0x00004000;
1320
1321 /// 窗口标志:用于用户将屏幕贴在脸上时经常使用的窗口,它将积极过滤事件流以防止在这种情况下意外按压(对于特定窗口可能不是所需的),当检测到这样的事件流时,应用程序将收到一个 CANCEL 运动事件来指示这一点,因此应用程序可以通过在手指释放之前不对事件采取任何操作来相应地处理此问题。
1322 pub const FLAG_IGNORE_CHEEK_PRESSES: u32 = 0x00008000;
1323
1324 /// 窗口标志:一个特殊选项,仅与 FLAG_LAYOUT_IN_SCREEN 结合使用。当请求在屏幕上布局时,您的窗口可能会出现在屏幕装饰(例如状态栏)的上方或后面。通过同时包含此标志,窗口管理器将报告所需的插入矩形,以确保您的内容不会被屏幕装饰覆盖。此标志通常由 Window 为您设置,如 Window#setFlags 中所述
1325 #[deprecated(note = "插图将始终传送到您的应用程序。")]
1326 pub const FLAG_LAYOUT_INSET_DECOR: u32 = 0x00010000;
1327
1328 /**
1329 窗口标志:设置后,反转窗口的输入法可聚焦性。
1330 设置此标志的效果取决于是否设置了 FLAG_NOT_FOCUSABLE:如果未设置 FLAG_NOT_FOCUSABLE,即当窗口可聚焦时,设置此标志将阻止此窗口成为输入法的目标。因此,它将无法与输入法交互,并将位于输入法之上(除非其上方有另一个输入法目标)。
1331 如果设置了 FLAG_NOT_FOCUSABLE,则设置此标志会要求窗口成为输入法目标,即使窗口无法聚焦。因此,它将位于输入法之下。注意:设置了 FLAG_NOT_FOCUSABLE 的窗口无法与输入法交互,无论此标志如何。
1332 */
1333 pub const FLAG_ALT_FOCUSABLE_IM: u32 = 0x00020000;
1334
1335 /// 窗口标志:如果您已设置 FLAG_NOT_TOUCH_MODAL,则可以设置此标志以接收单个特殊 MotionEvent,其动作为 MotionEvent#ACTION_OUTSIDE MotionEvent.ACTION_OUTSIDE,用于发生在窗口外的触摸。请注意,您不会收到完整的向下/移动/向上手势,只会收到第一个向下的位置作为 ACTION_OUTSIDE。
1336 pub const FLAG_WATCH_OUTSIDE_TOUCH: u32 = 0x00040000;
1337
1338 /// 窗口标志:特殊标志,允许在屏幕锁定时显示窗口。这将使应用程序窗口优先于键盘保护或任何其他锁定屏幕。可以与 FLAG_KEEP_SCREEN_ON 一起使用,在显示键盘保护窗口之前直接打开屏幕并显示窗口。可以与 FLAG_DISMISS_KEYGUARD 一起使用,以自动完全关闭非安全键盘保护。此标志仅适用于最顶部的全屏窗口。
1339 #[deprecated(
1340 note = "请使用 android.R.attr#showWhenLocked 或 android.app.Activity#setShowWhenLocked(boolean) 来防止意外的双重生命周期事件。"
1341 )]
1342 pub const FLAG_SHOW_WHEN_LOCKED: u32 = 0x00080000;
1343
1344 /**
1345 窗口标志:要求系统壁纸显示在窗口后面。窗口表面必须是半透明的,才能真正看到其后面的壁纸;此标志仅确保如果此窗口实际上有半透明区域,壁纸表面就会出现。
1346 您可以通过 android.R.attr#windowShowWallpaper 属性在您的主题中控制此标志;此属性会在标准壁纸主题中自动为您设置,例如 android.R.style#Theme_Wallpaper、android.R.style#Theme_Wallpaper_NoTitleBar、android.R.style#Theme_Wallpaper_NoTitleBar_Fullscreen、android.R.style#Theme_Holo_Wallpaper、android.R.style#Theme_Holo_Wallpaper_NoTitleBar、android.R.style#Theme_DeviceDefault_Wallpaper 和 android.R.style#Theme_DeviceDefault_Wallpaper_NoTitleBar。
1347 设置此标志后,发送到此窗口的所有触摸事件也会发送到壁纸,用于与动态壁纸交互。检查 LayoutParams#areWallpaperTouchEventsEnabled(),默认情况下设置为 ` `。在窗口上显示敏感信息时,如果您想禁用将触摸事件发送到壁纸,请使用 LayoutParams#setWallpaperTouchEventsEnabled(boolean)。
1348 */
1349 pub const FLAG_SHOW_WALLPAPER: u32 = 0x00100000;
1350
1351 /// 窗口标志:当设置为添加窗口或使窗口可见时,一旦窗口显示出来,系统就会触发电源管理器的用户活动(就像用户唤醒了设备一样)来打开屏幕。
1352 #[deprecated(
1353 note = "请使用 android.R.attr#turnScreenOn 或 android.app.Activity#setTurnScreenOn(boolean) 来防止意外的双重生命周期事件。"
1354 )]
1355 pub const FLAG_TURN_SCREEN_ON: u32 = 0x00200000;
1356
1357 /// 窗口标志:设置后,仅当窗口不是安全锁定的键盘保护时,才会关闭键盘保护。由于这种键盘保护不是出于安全考虑,因此当用户导航到另一个窗口时,它将永远不会重新出现(与 FLAG_SHOW_WHEN_LOCKED 相反,FLAG_SHOW_WHEN_LOCKED 只会暂时隐藏安全和非安全键盘保护,但确保当用户移动到不隐藏它们的另一个 UI 时它们会重新出现)。如果键盘保护当前处于活动状态且是安全的(需要解锁凭证),则用户仍需要确认它才能看到此窗口,除非也设置了 FLAG_SHOW_WHEN_LOCKED。
1358 #[deprecated(
1359 note = "改用 FLAG_SHOW_WHEN_LOCKED 或 KeyguardManager#requestDismissKeyguard。由于只要窗口上带有此标志的活动处于焦点状态,keyguard 就会一直被关闭,因此 keyguard 无法防止意外触摸屏幕,这是不希望的。"
1360 )]
1361 pub const FLAG_DISMISS_KEYGUARD: u32 = 0x00400000;
1362
1363 /// 窗口标志:设置后,窗口将接受超出其范围的触摸事件,并将其发送到也支持拆分触摸的其他窗口。如果未设置此标志,则第一个向下的指针将确定所有后续触摸将转到哪个窗口,直到所有指针都向上移动。如果设置了此标志,则每个向下的指针(不一定是第一个)将确定该指针的所有后续触摸将转到哪个窗口,直到该指针向上移动,从而允许将多个指针的触摸拆分到多个窗口。
1364 pub const FLAG_SPLIT_TOUCH: u32 = 0x00800000;
1365
1366 /**
1367 指示该窗口是否应加速硬件。请求硬件加速并不能保证它会发生。
1368 此标志只能通过编程控制以启用硬件加速。要通过编程为给定窗口启用硬件加速,请执行以下操作:
1369 Window w = activity.getWindow(); // 在 Activity 的 onCreate() 中
1370 例如
1371 w.setFlags(WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED, WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);
1372 重要的是要记住,必须在设置活动或对话框的内容视图之前设置此标志。
1373 在使用 android.R.attr#hardwareAccelerated 在清单中启用硬件加速后,此标志不能用于禁用硬件加速。如果您需要有选择地以编程方式禁用硬件加速(例如用于自动测试),请确保在清单中将其关闭,并在需要时使用上述方法在活动或对话框中启用它。
1374 如果活动或应用程序上的 android.R.attr#hardwareAccelerated android:hardwareAccelerated XML 属性设置为 true,则系统会自动设置此标志。
1375 */
1376 pub const FLAG_HARDWARE_ACCELERATED: u32 = 0x01000000;
1377
1378 //noinspection SpellCheckingInspection
1379 /**
1380 窗口标志:允许窗口内容延伸到屏幕的过扫描区域(如果有)。窗口仍应正确定位其内容以将过扫描区域考虑在内。
1381 可以通过android.R.attr#windowOverscan属性在您的主题中控制该标志;该属性是在标准过扫描主题中为您自动设置的,例如android.R.style#Theme_Holo_NoActionBar_Overscan、android.R.style#Theme_Holo_Light_NoActionBar_Overscan、android.R.style#Theme_DeviceDefault_NoActionBar_Overscan和android.R.style#Theme_DeviceDefault_Light_NoActionBar_Overscan。
1382 当为窗口启用此标志时,其正常内容可能会被显示屏的过扫描区域在一定程度上遮挡。为了确保用户可以看到该内容的关键部分,您可以使用 View#setFitsSystemWindows(boolean) View.setFitsSystemWindows(boolean) 在视图层次结构中设置应应用适当偏移的点。(这可以通过直接调用此函数、使用视图层次结构中的 android.R.attr#fitsSystemWindows 属性或实现您自己的 View#fitSystemWindows(android.graphics.Rect) View.fitSystemWindows(Rect) 方法来完成)。
1383 这种定位内容元素的机制与布局和 View#setSystemUiVisibility(int) View.setSystemUiVisibility(int) 的等效用法相同;这里有一个示例布局,它将在设置此过扫描标志的情况下正确定位其 UI 元素:
1384 development/samples/ApiDemos/res/layout/overscan_activity.xml 完整版
1385 */
1386 #[deprecated(note = "从Android 11开始,任何Android产品都不再设置过范围的区域。")]
1387 pub const FLAG_LAYOUT_IN_OVERSCAN: u32 = 0x02000000;
1388
1389 /**
1390 窗口标志:请求一个半透明的状态栏,并带有系统提供的最少的背景保护。
1391 您可以通过 android.R.attr#windowTranslucentStatus 属性在您的主题中控制此标志;此属性会在标准半透明装饰主题中自动为您设置,例如 android.R.style#Theme_Holo_NoActionBar_TranslucentDecor、android.R.style#Theme_Holo_Light_NoActionBar_TranslucentDecor、android.R.style#Theme_DeviceDefault_NoActionBar_TranslucentDecor 和 android.R.style#Theme_DeviceDefault_Light_NoActionBar_TranslucentDecor。
1392 当为窗口启用此标志时,它会自动设置系统 UI 可见性标志 View#SYSTEM_UI_FLAG_LAYOUT_STABLE 和 View#SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN。
1393 注意:对于支持 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE 的设备,可以忽略此标志。
1394 */
1395 #[deprecated(note = "改用半透明颜色的 Window#setStatusBarColor(int)。")]
1396 pub const FLAG_TRANSLUCENT_STATUS: u32 = 0x04000000;
1397
1398 /**
1399 窗口标志:请求一个半透明的导航栏,并带有系统提供的最少的背景保护。
1400 您可以通过 android.R.attr#windowTranslucentNavigation 属性在您的主题中控制此标志;此属性会在标准半透明装饰主题中自动为您设置,例如 android.R.style#Theme_Holo_NoActionBar_TranslucentDecor、android.R.style#Theme_Holo_Light_NoActionBar_TranslucentDecor、android.R.style#Theme_DeviceDefault_NoActionBar_TranslucentDecor 和 android.R.style#Theme_DeviceDefault_Light_NoActionBar_TranslucentDecor。
1401 当为窗口启用此标志时,它会自动设置系统 UI 可见性标志 View#SYSTEM_UI_FLAG_LAYOUT_STABLE 和 View#SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION。
1402 注意:对于支持 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE 的设备,汽车制造商可以禁用此标志。
1403 */
1404 #[deprecated(note = "改用半透明颜色的 Window#setNavigationBarColor(int)。")]
1405 pub const FLAG_TRANSLUCENT_NAVIGATION: u32 = 0x08000000;
1406
1407 /// 本地焦点模式窗口的标志。本地焦点模式窗口可以使用 Window#setLocalFocus(boolean, boolean) 独立于窗口管理器控制焦点。通常,此模式下的窗口不会从窗口管理器获取触摸/按键事件,而只能通过使用 Window#injectInputEvent(InputEvent) 的本地注入来获取事件。
1408 pub const FLAG_LOCAL_FOCUS_MODE: u32 = 0x10000000;
1409
1410 /**
1411 窗口标志:允许触摸在手势过程中从一个窗口滑入相邻窗口,而不是在手势持续期间被捕获。
1412 此标志仅更改此窗口的触摸焦点行为。触摸可以滑出窗口但不一定滑回(除非具有触摸焦点的其他窗口允许)。
1413 */
1414 pub const FLAG_SLIPPERY: u32 = 0x20000000;
1415
1416 /// 窗口标志:当请求使用附加窗口进行布局时,附加窗口可能会与父窗口的屏幕装饰(例如导航栏)重叠。通过包含此标志,窗口管理器将在父窗口的装饰框架内布局附加窗口,使其不与屏幕装饰重叠。
1417 #[deprecated(note = "使用 setFitInsetsTypes(int) 来确定附加窗口是否与系统栏重叠。")]
1418 pub const FLAG_LAYOUT_ATTACHED_IN_DECOR: u32 = 0x40000000;
1419
1420 /// 标志,指示此窗口负责绘制系统栏的背景。如果设置,系统栏将以透明背景绘制,并且此窗口中的相应区域将用Window#getStatusBarColor()和Window#getNavationBarColor()中指定的颜色填充。
1421 pub const FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS: u32 = 0x80000000;
1422
1423 /// 在系统进程中,我们全局不使用硬件加速,因为那里有许多线程在处理 UI,它们之间会发生冲突。如果 UI 的某些部分确实需要使用硬件加速,可以设置此标志来强制使用。这基本上是针对锁屏的。如果其他人也使用它,那么你可能错了。
1424 pub const PRIVATE_FLAG_FORCE_HARDWARE_ACCELERATED: i32 = 1 << 1;
1425
1426 /// 默认情况下,壁纸在滚动时会发送新的偏移量。如果壁纸没有执行任何有用的操作(它们不会影响壁纸滚动操作),则可以通过调用 android.service.wallpaper.WallpaperService.Engine#setOffsetNotificationsEnabled(boolean) 选择跳过这些通知。
1427 pub const PRIVATE_FLAG_WANTS_OFFSET_NOTIFICATIONS: i32 = 1 << 2;
1428
1429 /// 当设置 LayoutParams#TYPE_APPLICATION_OVERLAY 时,窗口将保持可见,即使为另一个可见窗口设置了 LayoutParams#SYSTEM_FLAG_HIDE_NON_SYSTEM_OVERLAY_WINDOWS。
1430 pub const PRIVATE_FLAG_SYSTEM_APPLICATION_OVERLAY: i32 = 1 << 3;
1431
1432 /// 在多用户系统中,如果设置了此标志并且所有者是系统进程,则此窗口将显示在所有用户屏幕上。这将覆盖通常仅显示在所有者用户的屏幕上的窗口类型的默认行为。请参阅每种窗口类型以确定其默认行为。
1433 pub const SYSTEM_FLAG_SHOW_FOR_ALL_USERS: i32 = 1 << 4;
1434
1435 /// 标记以允许此窗口具有不受限制的手势排除。
1436 pub const PRIVATE_FLAG_UNRESTRICTED_GESTURE_EXCLUSION: i32 = 1 << 5;
1437
1438 /// 永远不要为窗口的位置变化制作动画。
1439 pub const PRIVATE_FLAG_NO_MOVE_ANIMATION: i32 = 1 << 6;
1440
1441 /// 窗口标志:特殊标志,用于限制窗口大小为原始大小([320x480] x 密度)。用于为在兼容模式下运行的应用程序创建窗口。
1442 pub const PRIVATE_FLAG_COMPATIBLE_WINDOW: i32 = 1 << 7;
1443
1444 /// 窗口标志:用于系统对话框的特殊选项。设置此标志后,窗口在创建时将无条件地要求焦点。
1445 pub const PRIVATE_FLAG_SYSTEM_ERROR: i32 = 1 << 8;
1446
1447 /// 标记以指示仅在必要时才测量窗口的视图层次结构。如果窗口大小可以通过 LayoutParams 获知,我们可以使用该大小来重新布局窗口,并且我们不必在布局视图之前测量视图层次结构。这减少了执行测量的机会。
1448 pub const PRIVATE_FLAG_OPTIMIZE_MEASURE: i32 = 1 << 9;
1449
1450 /// 阻止当前窗口后面的壁纸接收触摸事件的标志。
1451 pub const PRIVATE_FLAG_DISABLE_WALLPAPER_TOUCH_EVENTS: i32 = 1 << 10;
1452
1453 /// 强制状态栏窗口始终可见的标志。如果在设置此标志时状态栏处于隐藏状态,则将再次显示。这只能通过 LayoutParams#TYPE_STATUS_BAR 设置。
1454 pub const PRIVATE_FLAG_FORCE_SHOW_STATUS_BAR: i32 = 1 << 11;
1455
1456 /// 标记表示窗口框架应为添加显示切口框架的请求框架。仅当给定的特定尺寸小于父框架且窗口覆盖显示切口时才适用。扩展框架不会大于父框架。
1457 pub const PRIVATE_FLAG_LAYOUT_SIZE_EXTENDED_BY_CUTOUT: i32 = 1 << 12;
1458
1459 /// 此标记将使窗口忽略应用程序可见性,而是完全依赖装饰视图可见性来确定窗口可见性。最近使用此功能在启动应用程序后继续绘制。
1460 pub const PRIVATE_FLAG_FORCE_DECOR_VIEW_VISIBILITY: i32 = 1 << 13;
1461
1462 /// 标志表明无论当前的窗口模式配置如何,该子窗口都应始终布局在父框架中。
1463 pub const PRIVATE_FLAG_LAYOUT_CHILD_WINDOW_IN_PARENT_FRAME: i32 = 1 << 14;
1464
1465 /// 标志表明此窗口始终绘制状态栏背景,无论其他标志是什么。
1466 pub const PRIVATE_FLAG_FORCE_DRAW_BAR_BACKGROUNDS: i32 = 1 << 15;
1467
1468 /// 标记用于指示如果设备支持,此窗口需要持续性能模式。
1469 pub const PRIVATE_FLAG_SUSTAINED_PERFORMANCE_MODE: i32 = 1 << 16;
1470
1471 /// 标志,用于指示当此窗口可见时,应用程序进程添加的属于TYPE_TOAST类型的任何窗口或需要android.app.AppOpsManager#OP_SYSTEM_ALERT_WINDOW权限的窗口都应被隐藏。
1472 pub const SYSTEM_FLAG_HIDE_NON_SYSTEM_OVERLAY_WINDOWS: i32 = 1 << 19;
1473
1474 /// 表示此窗口是某些设备上存在的圆角覆盖,这意味着它将被排除在外:屏幕截图、屏幕放大和镜像。
1475 pub const PRIVATE_FLAG_IS_ROUNDED_CORNERS_OVERLAY: i32 = 1 << 20;
1476
1477 //noinspection SpellCheckingInspection
1478 /**
1479 标记指示在未缩放的屏幕坐标上计算可放大区域时将排除此窗口,这可以避免放大边界上的剪切。它应该用于不可放大的叠加层。
1480 注意与 PRIVATE_FLAG_NOT_MAGNIFIABLE 不同,此标志不影响放大功能。如果您希望窗口不可放大且不导致剪切,则需要将两者结合起来。
1481 */
1482 pub const PRIVATE_FLAG_EXCLUDE_FROM_SCREEN_MAGNIFICATION: i32 = 1 << 21;
1483
1484 //noinspection SpellCheckingInspection
1485 /**
1486 标记以防止窗口被辅助功能放大镜放大。
1487 TODO(b/190623172): 这只是暂时的解决办法,需要寻找其他方法。
1488 */
1489 pub const PRIVATE_FLAG_NOT_MAGNIFIABLE: i32 = 1 << 22;
1490
1491 /// 标记表示状态栏窗口处于强制显示导航栏的状态,除非导航栏窗口明确设置为 View#GONE。仅当通过 LayoutParams#TYPE_STATUS_BAR 设置时才会生效。
1492 pub const PRIVATE_FLAG_STATUS_FORCE_SHOW_NAVIGATION: i32 = 1 << 23;
1493
1494 /// 标志表明窗口与颜色空间无关,并且颜色可以解释为任何颜色空间。
1495 pub const PRIVATE_FLAG_COLOR_SPACE_AGNOSTIC: i32 = 1 << 24;
1496
1497 /// 标记请求创建 BLAST(缓冲区作为 LayerState)层。如果未指定,客户端将收到 BufferQueue 层。
1498 pub const PRIVATE_FLAG_USE_BLAST: i32 = 1 << 25;
1499
1500 /// 标志表示窗口正在控制系统栏的外观。因此我们不需要通过读取其系统 UI 标志来调整它以实现兼容性。
1501 pub const PRIVATE_FLAG_APPEARANCE_CONTROLLED: i32 = 1 << 26;
1502
1503 /// 标志表示窗口正在控制系统栏的行为。因此我们不需要通过读取其窗口标志或系统 UI 标志来调整它以实现兼容性。
1504 pub const PRIVATE_FLAG_BEHAVIOR_CONTROLLED: i32 = 1 << 27;
1505
1506 /// 标记表示窗口正在自行控制如何适应窗口插入。因此我们无需调整其属性来适应窗口插入。
1507 pub const PRIVATE_FLAG_FIT_INSETS_CONTROLLED: i32 = 1 << 28;
1508
1509 /// 标记以表明该窗口是受信任的覆盖。
1510 pub const PRIVATE_FLAG_TRUSTED_OVERLAY: i32 = 1 << 29;
1511
1512 /// 标志表明窗口的父框架应该由 IME 插入。
1513 pub const PRIVATE_FLAG_INSET_PARENT_FRAME_BY_IME: i32 = 1 << 30;
1514
1515 /**
1516 标记表示我们想要拦截和处理所有用户的全局拖放。此标记允许窗口即使不可见也考虑拖放事件,并将接收系统中所有活动用户的拖放。
1517 使用此标志向窗口提供附加数据,包括 ClipData(包含具有 DragEvent#ACTION_DRAG_STARTED 事件的所有项目)和具有 DragEvent#ACTION_DROP 事件的实际拖动表面。如果窗口消耗了拖放,则拖动表面的清理(作为 DragEvent#ACTION_DROP 的一部分提供)将由窗口承担。
1518 */
1519 pub const PRIVATE_FLAG_INTERCEPT_GLOBAL_DRAG_AND_DROP: i32 = 1 << 31;
1520
1521 /// 确定此窗口的软输入区域所需的可见性状态的位的 softInputMode 掩码。
1522 pub const SOFT_INPUT_MASK_STATE: i32 = 0x0f;
1523
1524 /// softInputMode 的可见性状态:未指定状态。当窗口获得焦点时,系统可能会显示或隐藏软件键盘,以获得更好的用户体验。
1525 pub const SOFT_INPUT_STATE_UNSPECIFIED: i32 = 0;
1526
1527 /// softInputMode 的可见性状态:请不要改变软输入区域的状态。
1528 pub const SOFT_INPUT_STATE_UNCHANGED: i32 = 1;
1529
1530 /// SoftInputMode的可见性状态:通常合适时(用户向前导航到您的窗口时),请隐藏任何软输入区域)。
1531 pub const SOFT_INPUT_STATE_HIDDEN: i32 = 2;
1532
1533 /// softInputMode 的可见性状态:当此窗口获得焦点时,请始终隐藏任何软输入区域。
1534 pub const SOFT_INPUT_STATE_ALWAYS_HIDDEN: i32 = 3;
1535
1536 /**
1537 softInputMode 的可见性状态:请在正常适当的时候显示软输入区域(当用户向前导航到您的窗口时)。
1538 对于以 android.os.Build.VERSION_CODES#P 及更高版本为目标的应用程序,除非存在一个焦点视图,并且在窗口聚焦时从 View#onCheckIsTextEditor() 返回“ ” ,否则此标志将被忽略。
1539 */
1540 pub const SOFT_INPUT_STATE_VISIBLE: i32 = 4;
1541
1542 /**
1543 SoftInputMode的可见性状态:当此窗口接收输入焦点时,请始终使软输入区域可见。
1544 对于以 android.os.Build.VERSION_CODES#P 及更高版本为目标的应用程序,除非存在一个焦点视图,并且在窗口聚焦时从 View#onCheckIsTextEditor() 返回“ ” ,否则此标志将被忽略。
1545 */
1546 pub const SOFT_INPUT_STATE_ALWAYS_VISIBLE: i32 = 5;
1547
1548 /// 软输入模式 (softInputMode) 的掩码,用于确定应如何调整窗口以适应软输入窗口。
1549 pub const SOFT_INPUT_MASK_ADJUST: i32 = 0xf0;
1550
1551 /// softInputMode 的调整选项:未指定。系统将根据窗口的内容尝试选择其中一个。
1552 pub const SOFT_INPUT_ADJUST_UNSPECIFIED: i32 = 0x00;
1553
1554 /// softInputMode 的调整选项:设置为允许在显示输入法时调整窗口大小,以便输入法不会覆盖其内容。这不能与 SOFT_INPUT_ADJUST_PAN 结合使用;如果两者都未设置,则系统将尝试根据窗口的内容选择其中一个。如果窗口的布局参数标志包括 FLAG_FULLSCREEN,则将忽略 softInputMode 的此值;窗口不会调整大小,但会保持全屏显示。
1555 #[deprecated(
1556 note = "使用 ` ` 调用 Window#setDecorFitsSystemWindows(boolean) 并在根内容视图上安装一个适合 Type#ime() 类型插入的 OnApplyWindowInsetsListener。"
1557 )]
1558 pub const SOFT_INPUT_ADJUST_RESIZE: i32 = 0x10;
1559
1560 /// softInputMode 的调整选项:设置为在显示输入法时让窗口平移,这样它就不需要处理调整大小,而只需由框架平移以确保当前输入焦点可见。这不能与 SOFT_INPUT_ADJUST_RESIZE 结合使用;如果两者都未设置,则系统将尝试根据窗口的内容选择其中一个。
1561 pub const SOFT_INPUT_ADJUST_PAN: i32 = 0x20;
1562
1563 /// softInputMode 的调整选项:设置为不根据显示的输入法调整窗口。窗口不会调整大小,也不会平移以使其焦点可见。
1564 pub const SOFT_INPUT_ADJUST_NOTHING: i32 = 0x30;
1565
1566 /// for softInputMode:设置用户将向前导航到窗口时。 通常,该系统会自动为您设置,尽管您可能需要在自己显示窗口时在某些情况下设置它。 显示窗口后,该标志将始终自动清除。
1567 pub const SOFT_INPUT_IS_FORWARD_NAVIGATION: i32 = 0x100;
1568
1569 /// screenBrightness 和 buttonBrightness 的默认值表示此窗口的亮度值不会被覆盖,而应该使用正常的亮度策略。
1570 pub const BRIGHTNESS_OVERRIDE_NONE: f32 = -1.0;
1571
1572 /// screenBrightness 和 buttonBrightness 的值表示当此窗口位于前面时,屏幕或按钮背光亮度应设置为最低值。
1573 pub const BRIGHTNESS_OVERRIDE_OFF: f32 = 0.0;
1574
1575 /// screenBrightness 和 buttonBrightness 的值表示当此窗口位于前面时,屏幕或按钮背光亮度应设置为最高值。
1576 pub const BRIGHTNESS_OVERRIDE_FULL: f32 = 1.0;
1577
1578 /// 未指定 rotationAnimation 的值,表示缺乏偏好。
1579 pub const ROTATION_ANIMATION_UNSPECIFIED: i32 = -1;
1580
1581 /// rotationAnimation 的值指定此窗口在旋转后将在视觉上旋转进或旋转出。
1582 pub const ROTATION_ANIMATION_ROTATE: i32 = 0;
1583
1584 //noinspection SpellCheckingInspection
1585 /// rotationAnimation 的值指定此窗口在旋转后淡入或淡出。
1586 pub const ROTATION_ANIMATION_CROSSFADE: i32 = 1;
1587
1588 //noinspection SpellCheckingInspection
1589 /// rotationAnimation 的值指定此窗口在旋转后将立即消失或出现。
1590 pub const ROTATION_ANIMATION_JUMPCUT: i32 = 2;
1591
1592 //noinspection SpellCheckingInspection
1593 /// rotationAnimation 的值用于指定无缝旋转模式。其工作原理与 JUMPCUT 类似,但如果无法在不暂停屏幕的情况下应用旋转,则会回退到 CROSSFADE。例如,这对于相机应用来说是理想的选择,这些应用不希望取景器内容旋转或淡入淡出(而是无缝),但在无法应用无缝旋转的应用转换场景中也不希望出现 ROTATION_ANIMATION_JUMPCUT。
1594 pub const ROTATION_ANIMATION_SEAMLESS: i32 = 3;
1595
1596 /// 指示此窗口是否希望HDR转换被禁用。
1597 pub const DISPLAY_FLAG_DISABLE_HDR_CONVERSION: i32 = 1 << 0;
1598
1599 /**
1600 仅当 DisplayCutout 完全包含在系统栏内或 DisplayCutout 深度不超过 16 dp 时,窗口才可以延伸到 DisplayCutout 区域,但这取决于 OEM 的选择。否则,窗口的布局不会与 DisplayCutout 区域重叠。
1601 实际上,这意味着如果窗口未设置 FLAG_FULLSCREEN 或 View#SYSTEM_UI_FLAG_FULLSCREEN,则如果切口位于顶部边缘,则它可以延伸到纵向切口区域。对于 View#SYSTEM_UI_FLAG_HIDE_NAVIGATION 和屏幕底部的切口,情况也是如此。否则(即全屏或横向),它会被布置成不与切口区域重叠。
1602 通常采取的不与状态栏和导航栏重叠的预防措施足以确保没有重要内容与 DisplayCutout 重叠。
1603 注意:当 DisplayCutout 与系统栏位于不同侧时,OEM 可以选择让窗口始终延伸到 DisplayCutout 区域,无论是否设置了凹口标志,前提是 DisplayCutout 与窗口的重叠部分最多为 16dp。在这种情况下,OEM 必须为用户提供选择加入/退出的选项。
1604 android:windowLayoutInDisplayCutoutMode
1605 */
1606 pub const LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT: i32 = 0;
1607
1608 /**
1609 窗口始终可以延伸到屏幕短边的 DisplayCutout 区域。
1610 窗口永远不会延伸到屏幕长边上的 DisplayCutout 区域,除非 DisplayCutout 的深度不超过 16 dp,但这取决于 OEM 的选择。
1611 注意:OEM 可以选择让窗口延伸到长边的 DisplayCutout 区域,但前提是凹口与窗口的重叠部分最多为 16dp。在这种情况下,OEM 必须为用户提供选择加入/退出的选项。
1612 窗口必须确保没有重要内容与DisplayCutout重叠。
1613 在此模式下,无论窗口是否隐藏了系统栏,窗口都会在纵向和横向显示屏短边的切口下延伸:
1614 角落中的切口被视为位于短边:
1615 另一方面,如果切口位于显示器的长边上,则会应用信箱,使得窗口不会延伸到任一长边的切口中:
1616 注意:Android 可能不允许内容视图在视图级别与系统栏重叠。要覆盖此行为并允许内容能够延伸到切口区域,请使用 ` ` 调用 Window#setDecorFitsSystemWindows(boolean)。
1617 android:windowLayoutInDisplayCutoutMode
1618 */
1619 pub const LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES: i32 = 1;
1620
1621 /**
1622 窗口永远不会与DisplayCutout区域重叠。
1623 这应该与暂时设置 View#SYSTEM_UI_FLAG_FULLSCREEN 或 View#SYSTEM_UI_FLAG_HIDE_NAVIGATION 的窗口一起使用,以避免在设置或清除相应标志时重新布局窗口。
1624 android:windowLayoutInDisplayCutoutMode
1625 */
1626 pub const LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER: i32 = 2;
1627
1628 /**
1629 窗口始终可以延伸到屏幕所有边缘的 DisplayCutout 区域。
1630 窗口必须确保没有重要内容与DisplayCutout重叠。
1631 在这种模式下,无论窗口是否隐藏了系统栏,窗口都会在纵向和横向显示屏的所有边缘的切口下延伸。
1632 注意:Android 可能不允许内容视图在视图级别与系统栏重叠。要覆盖此行为并允许内容能够延伸到切口区域,请使用 ` ` 调用 Window#setDecorFitsSystemWindows(boolean)。
1633 android:windowLayoutInDisplayCutoutMode
1634 */
1635 pub const LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS: i32 = 3;
1636
1637 /// 不为该窗口构建输入通道。因此该通道将无法接收输入。
1638 pub const INPUT_FEATURE_NO_INPUT_CHANNEL: i32 = 1 << 0;
1639
1640 /// 当此窗口获得焦点时,不会针对所有输入事件调用用户活动,因此应用程序必须自行执行此操作。仅应由键盘锁和手机应用程序使用。仅应由键盘锁和手机应用程序使用。
1641 pub const INPUT_FEATURE_DISABLE_USER_ACTIVITY: i32 = 1 << 1;
1642
1643 /// 输入侦测窗口。此窗口将接收其可触摸区域内的所有指针事件,但不会阻止事件按 Z 顺序发送到其下方的其他窗口。输入事件将分派到事件坐标处顶部非侦测窗口上方的所有侦测窗口。
1644 pub const INPUT_FEATURE_SPY: i32 = 1 << 2;
1645
1646 pub const LAYOUT_CHANGED: i32 = 1 << 0;
1647
1648 pub const TYPE_CHANGED: i32 = 1 << 1;
1649
1650 pub const FLAGS_CHANGED: i32 = 1 << 2;
1651
1652 pub const FORMAT_CHANGED: i32 = 1 << 3;
1653
1654 pub const ANIMATION_CHANGED: i32 = 1 << 4;
1655
1656 pub const DIM_AMOUNT_CHANGED: i32 = 1 << 5;
1657
1658 pub const TITLE_CHANGED: i32 = 1 << 6;
1659
1660 pub const ALPHA_CHANGED: i32 = 1 << 7;
1661
1662 pub const MEMORY_TYPE_CHANGED: i32 = 1 << 8;
1663
1664 pub const SOFT_INPUT_MODE_CHANGED: i32 = 1 << 9;
1665
1666 pub const SCREEN_ORIENTATION_CHANGED: i32 = 1 << 10;
1667
1668 pub const SCREEN_BRIGHTNESS_CHANGED: i32 = 1 << 11;
1669
1670 pub const ROTATION_ANIMATION_CHANGED: i32 = 1 << 12;
1671
1672 pub const BUTTON_BRIGHTNESS_CHANGED: i32 = 1 << 13;
1673
1674 pub const SYSTEM_UI_VISIBILITY_CHANGED: i32 = 1 << 14;
1675
1676 pub const SYSTEM_UI_LISTENER_CHANGED: i32 = 1 << 15;
1677
1678 pub const INPUT_FEATURES_CHANGED: i32 = 1 << 16;
1679
1680 pub const PRIVATE_FLAGS_CHANGED: i32 = 1 << 17;
1681
1682 pub const USER_ACTIVITY_TIMEOUT_CHANGED: i32 = 1 << 18;
1683
1684 pub const TRANSLUCENT_FLAGS_CHANGED: i32 = 1 << 19;
1685
1686 pub const SURFACE_INSETS_CHANGED: i32 = 1 << 20;
1687
1688 pub const PREFERRED_REFRESH_RATE_CHANGED: i32 = 1 << 21;
1689
1690 pub const DISPLAY_FLAGS_CHANGED: i32 = 1 << 22;
1691
1692 pub const PREFERRED_DISPLAY_MODE_ID: i32 = 1 << 23;
1693
1694 pub const ACCESSIBILITY_ANCHOR_CHANGED: i32 = 1 << 24;
1695
1696 pub const ACCESSIBILITY_TITLE_CHANGED: i32 = 1 << 25;
1697
1698 pub const COLOR_MODE_CHANGED: i32 = 1 << 26;
1699
1700 pub const INSET_FLAGS_CHANGED: i32 = 1 << 27;
1701
1702 pub const MINIMAL_POST_PROCESSING_PREFERENCE_CHANGED: i32 = 1 << 28;
1703
1704 pub const BLUR_BEHIND_RADIUS_CHANGED: i32 = 1 << 29;
1705
1706 pub const PREFERRED_MIN_DISPLAY_REFRESH_RATE: i32 = 1 << 30;
1707
1708 pub const PREFERRED_MAX_DISPLAY_REFRESH_RATE: i32 = 1 << 31;
1709
1710 /// 此窗口的 X 位置。使用默认重力时,它会被忽略。使用 Gravity.LEFT 或 Gravity.START 或 Gravity.RIGHT 或 Gravity.END 时,它会提供与给定边缘的偏移量。
1711 #[java_field]
1712 pub fn get_x(&self) -> i32 {}
1713
1714 /// 此窗口的 X 位置。使用默认重力时,它会被忽略。使用 Gravity.LEFT 或 Gravity.START 或 Gravity.RIGHT 或 Gravity.END 时,它会提供与给定边缘的偏移量。
1715 #[java_field]
1716 pub fn set_x(&self, value: i32) {}
1717
1718 /// 此窗口的 Y 位置。使用默认重力时,它会被忽略。使用 Gravity.TOP 或 Gravity.BOTTOM 时,它会提供与给定边缘的偏移量。
1719 #[java_field]
1720 pub fn get_y(&self) -> i32 {}
1721
1722 /// 此窗口的 Y 位置。使用默认重力时,它会被忽略。使用 Gravity.TOP 或 Gravity.BOTTOM 时,它会提供与给定边缘的偏移量。
1723 #[java_field]
1724 pub fn set_y(&self, value: i32) {}
1725
1726 /// 指示将为与这些 LayoutParams 关联的视图水平分配多少额外空间。如果视图不应拉伸,请指定 0。否则,额外的像素将在权重大于 0 的所有视图之间按比例分配。
1727 #[java_field]
1728 pub fn get_horizontal_weight(&self) -> f32 {}
1729
1730 /// 指示将为与这些 LayoutParams 关联的视图水平分配多少额外空间。如果视图不应拉伸,请指定 0。否则,额外的像素将在权重大于 0 的所有视图之间按比例分配。
1731 #[java_field]
1732 pub fn set_horizontal_weight(&self, value: f32) {}
1733
1734 /// 指示将为与这些 LayoutParams 关联的视图垂直分配多少额外空间。如果视图不应拉伸,请指定 0。否则,额外的像素将在权重大于 0 的所有视图之间按比例分配。
1735 #[java_field]
1736 pub fn get_vertical_weight(&self) -> f32 {}
1737
1738 /// 指示将为与这些 LayoutParams 关联的视图垂直分配多少额外空间。如果视图不应拉伸,请指定 0。否则,额外的像素将在权重大于 0 的所有视图之间按比例分配。
1739 #[java_field]
1740 pub fn set_vertical_weight(&self, value: f32) {}
1741
1742 /// 窗口的一般类型。窗口类型主要有三类:
1743 /// 应用程序窗口(范围从 FIRST_APPLICATION_WINDOW 到 LAST_APPLICATION_WINDOW)是普通的顶层应用程序窗口。对于这些类型的窗口,必须将令牌设置为它们所属活动的令牌(如果令牌为空,通常会为您完成此操作)。
1744 /// 子窗口(范围从 FIRST_SUB_WINDOW 到 LAST_SUB_WINDOW)与另一个顶层窗口相关联。对于这些类型的窗口,令牌必须是它所附加到的窗口的令牌。
1745 /// 系统窗口(范围从 FIRST_SYSTEM_WINDOW 到 LAST_SYSTEM_WINDOW)是供系统用于特定目的的特殊类型的窗口。它们通常不应由应用程序使用,并且使用它们需要特殊权限。
1746 #[java_field]
1747 pub fn get_type(&self) -> i32 {}
1748
1749 /// 窗口的一般类型。窗口类型主要有三类:
1750 /// 应用程序窗口(范围从 FIRST_APPLICATION_WINDOW 到 LAST_APPLICATION_WINDOW)是普通的顶层应用程序窗口。对于这些类型的窗口,必须将令牌设置为它们所属活动的令牌(如果令牌为空,通常会为您完成此操作)。
1751 /// 子窗口(范围从 FIRST_SUB_WINDOW 到 LAST_SUB_WINDOW)与另一个顶层窗口相关联。对于这些类型的窗口,令牌必须是它所附加到的窗口的令牌。
1752 /// 系统窗口(范围从 FIRST_SYSTEM_WINDOW 到 LAST_SYSTEM_WINDOW)是供系统用于特定目的的特殊类型的窗口。它们通常不应由应用程序使用,并且使用它们需要特殊权限。
1753 #[java_field]
1754 pub fn set_type(&self, value: i32) {}
1755
1756 /**
1757 如果窗口类型是警报窗口,则返回 true。
1758 `type` 窗口类型。如果窗口类型是警报窗口,则返回 true。
1759 */
1760 #[java_method]
1761 pub fn is_system_alert_window_type(r#type: i32) {}
1762
1763 #[deprecated(note = "这被忽略了")]
1764 #[java_field]
1765 pub fn get_memory_type(&self) -> i32 {}
1766
1767 #[deprecated(note = "这被忽略了")]
1768 #[java_field]
1769 pub fn set_memory_type(&self, value: i32) {}
1770
1771 /// 各种行为选项/标志。默认为无。
1772 #[java_field]
1773 pub fn get_flags(&self) -> u32 {}
1774
1775 /// 各种行为选项/标志。默认为无。
1776 #[java_field]
1777 pub fn set_flags(&self, value: u32) {}
1778
1779 /// 控制平台私有的标志。
1780 #[java_field]
1781 pub fn get_private_flags(&self) -> i32 {}
1782
1783 /// 控制平台私有的标志。
1784 #[java_field]
1785 pub fn set_private_flags(&self, value: i32) {}
1786
1787 /**
1788 给定一组特定的窗口管理器标志,确定此类窗口在获得焦点时是否可以成为输入法的目标。具体来说,这会检查 FLAG_NOT_FOCUSABLE 和 FLAG_ALT_FOCUSABLE_IM 标志,如果两者的组合对应于可以使用输入法的窗口,则返回 true。
1789 返回:如果具有给定标志的窗口能够使用输入法,则返回 true,否则返回 false。
1790 `flags` 当前窗口管理器标志。
1791 */
1792 #[java_method]
1793 pub fn may_use_input_method(flags: i32) -> bool {}
1794
1795 /// 任何软输入区域所需的操作模式。可以是以下任意组合:
1796 /// 可见性状态之一 SOFT_INPUT_STATE_UNSPECIFIED、SOFT_INPUT_STATE_UNCHANGED、SOFT_INPUT_STATE_HIDDEN、SOFT_INPUT_STATE_ALWAYS_HIDDEN、SOFT_INPUT_STATE_VISIBLE 或 SOFT_INPUT_STATE_ALWAYS_VISIBLE。
1797 /// 调整选项之一 SOFT_INPUT_ADJUST_UNSPECIFIED、SOFT_INPUT_ADJUST_RESIZE、SOFT_INPUT_ADJUST_PAN 或 SOFT_INPUT_ADJUST_NOTHING。
1798 /// 此标志可以在您的主题中通过 android.R.attr.windowSoftInputMode 属性进行控制。
1799 #[java_field]
1800 pub fn get_soft_input_mode(&self) -> i32 {}
1801
1802 /// 任何软输入区域所需的操作模式。可以是以下任意组合:
1803 /// 可见性状态之一 SOFT_INPUT_STATE_UNSPECIFIED、SOFT_INPUT_STATE_UNCHANGED、SOFT_INPUT_STATE_HIDDEN、SOFT_INPUT_STATE_ALWAYS_HIDDEN、SOFT_INPUT_STATE_VISIBLE 或 SOFT_INPUT_STATE_ALWAYS_VISIBLE。
1804 /// 调整选项之一 SOFT_INPUT_ADJUST_UNSPECIFIED、SOFT_INPUT_ADJUST_RESIZE、SOFT_INPUT_ADJUST_PAN 或 SOFT_INPUT_ADJUST_NOTHING。
1805 /// 此标志可以在您的主题中通过 android.R.attr.windowSoftInputMode 属性进行控制。
1806 #[java_field]
1807 pub fn set_soft_input_mode(&self, value: i32) {}
1808
1809 /// 根据 Gravity 在屏幕内放置窗口。Gravity.apply 和 Gravity.applyDisplay 都在窗口布局期间使用,此值指定为所需重力。例如,您可以在此处指定 Gravity.DISPLAY_CLIP_HORIZONTAL 和 Gravity.DISPLAY_CLIP_VERTICAL 来控制 Gravity.applyDisplay 的行为。
1810 #[java_field]
1811 pub fn get_gravity(&self) -> i32 {}
1812
1813 /// 根据 Gravity 在屏幕内放置窗口。Gravity.apply 和 Gravity.applyDisplay 都在窗口布局期间使用,此值指定为所需重力。例如,您可以在此处指定 Gravity.DISPLAY_CLIP_HORIZONTAL 和 Gravity.DISPLAY_CLIP_VERTICAL 来控制 Gravity.applyDisplay 的行为。
1814 #[java_field]
1815 pub fn set_gravity(&self, value: i32) {}
1816
1817 /// 容器和小部件之间的水平边距,以容器宽度的百分比表示。请参阅 Gravity.apply 以了解如何使用。此字段与 x 一起添加以提供 xAdj 参数。
1818 #[java_field]
1819 pub fn get_horizontal_margin(&self) -> f32 {}
1820
1821 /// 容器和小部件之间的水平边距,以容器宽度的百分比表示。请参阅 Gravity.apply 以了解如何使用。此字段与 x 一起添加以提供 xAdj 参数。
1822 #[java_field]
1823 pub fn set_horizontal_margin(&self, value: f32) {}
1824
1825 /// 容器和小部件之间的垂直边距,以容器高度的百分比表示。请参阅 Gravity.apply 以了解如何使用。此字段与 y 一起添加以提供 yAdj 参数。
1826 #[java_field]
1827 pub fn get_vertical_margin(&self) -> f32 {}
1828
1829 /// 容器和小部件之间的垂直边距,以容器高度的百分比表示。请参阅 Gravity.apply 以了解如何使用。此字段与 y 一起添加以提供 yAdj 参数。
1830 #[java_field]
1831 pub fn set_vertical_margin(&self, value: f32) {}
1832
1833 /// 是否已手动设置表面插入图。设置为 false 时,视图根将自动确定适当的表面插入图。
1834 #[java_field]
1835 pub fn get_has_manual_surface_insets(&self) -> bool {}
1836
1837 /// 是否已手动设置表面插入图。设置为 false 时,视图根将自动确定适当的表面插入图。
1838 #[java_field]
1839 pub fn set_has_manual_surface_insets(&self, value: bool) {}
1840
1841 /// 向窗口报告插入内容时是否应使用全局插入内容状态。设置为 true 时,所有插入内容都将报告给窗口,而不管 z 顺序如何。否则,仅报告给定窗口上方的插入内容。
1842 #[java_field]
1843 pub fn get_receive_insets_ignoring_z_order(&self) -> bool {}
1844
1845 /// 向窗口报告插入内容时是否应使用全局插入内容状态。设置为 true 时,所有插入内容都将报告给窗口,而不管 z 顺序如何。否则,仅报告给定窗口上方的插入内容。
1846 #[java_field]
1847 pub fn set_receive_insets_ignoring_z_order(&self, value: bool) {}
1848
1849 /// 是否应使用先前的表面插入图,而不是当前设置的表面插入图。设置为 true 时,视图根将忽略此对象中的表面插入图并使用其当前拥有的表面插入图。
1850 #[java_field]
1851 pub fn get_preserve_previous_surface_insets(&self) -> bool {}
1852
1853 /// 是否应使用先前的表面插入图,而不是当前设置的表面插入图。设置为 true 时,视图根将忽略此对象中的表面插入图并使用其当前拥有的表面插入图。
1854 #[java_field]
1855 pub fn set_preserve_previous_surface_insets(&self, value: bool) {}
1856
1857 /// 所需的位图格式。可能是 PixelFormat 中的常量之一。格式的选择可能会被 setColorMode(int) 覆盖。默认为 OPAQUE。
1858 #[java_field]
1859 pub fn get_format(&self) -> i32 {}
1860
1861 /// 所需的位图格式。可能是 PixelFormat 中的常量之一。格式的选择可能会被 setColorMode(int) 覆盖。默认为 OPAQUE。
1862 #[java_field]
1863 pub fn set_format(&self, value: i32) {}
1864
1865 /// 定义此窗口要使用的动画的样式资源。这必须是系统资源;它不能是应用程序资源,因为窗口管理器无权访问应用程序。
1866 #[java_field]
1867 pub fn get_window_animations(&self) -> i32 {}
1868
1869 /// 定义此窗口要使用的动画的样式资源。这必须是系统资源;它不能是应用程序资源,因为窗口管理器无权访问应用程序。
1870 #[java_field]
1871 pub fn set_window_animations(&self, value: i32) {}
1872
1873 /// 应用于整个窗口的 alpha 值。alpha 值为 1.0 表示完全不透明,alpha 值为 0.0 表示完全透明
1874 #[java_field]
1875 pub fn get_alpha(&self) -> f32 {}
1876
1877 /// 应用于整个窗口的 alpha 值。alpha 值为 1.0 表示完全不透明,alpha 值为 0.0 表示完全透明
1878 #[java_field]
1879 pub fn set_alpha(&self, value: f32) {}
1880
1881 /// 当设置 FLAG_DIM_BEHIND 时,这是要应用的调光量。范围从 1.0(完全不透明)到 0.0(无调光)。
1882 #[java_field]
1883 pub fn get_dim_amount(&self) -> f32 {}
1884
1885 /// 当设置 FLAG_DIM_BEHIND 时,这是要应用的调光量。范围从 1.0(完全不透明)到 0.0(无调光)。
1886 #[java_field]
1887 pub fn set_dim_amount(&self, value: f32) {}
1888
1889 /// 这可用于覆盖用户偏好的屏幕亮度。小于 0 的值(默认值)表示使用偏好的屏幕亮度。0 到 1 可将亮度从暗调整到全亮。
1890 #[java_field]
1891 pub fn get_screen_brightness(&self) -> f32 {}
1892
1893 /// 这可用于覆盖用户偏好的屏幕亮度。小于 0 的值(默认值)表示使用偏好的屏幕亮度。0 到 1 可将亮度从暗调整到全亮。
1894 #[java_field]
1895 pub fn set_screen_brightness(&self, value: f32) {}
1896
1897 /// 这可用于覆盖按钮和键盘背光的标准行为。小于 0 的值(默认值)表示使用标准背光行为。0 到 1 可将亮度从暗调整到全亮。
1898 #[java_field]
1899 pub fn get_button_brightness(&self) -> f32 {}
1900
1901 /// 这可用于覆盖按钮和键盘背光的标准行为。小于 0 的值(默认值)表示使用标准背光行为。0 到 1 可将亮度从暗调整到全亮。
1902 #[java_field]
1903 pub fn set_button_brightness(&self, value: f32) {}
1904
1905 /// 定义设备旋转时此窗口使用的退出和进入动画。这仅在进入和离开的最顶层不透明窗口设置了 #FLAG_FULLSCREEN 位且未被 其他窗口覆盖 时才会产生影响。所有其他情况都默认为 ROTATION_ANIMATION_ROTATE 行为。
1906 #[java_field]
1907 pub fn get_rotation_animation(&self) -> i32 {}
1908
1909 /// 定义设备旋转时此窗口使用的退出和进入动画。这仅在进入和离开的最顶层不透明窗口设置了 #FLAG_FULLSCREEN 位且未被 其他窗口覆盖 时才会产生影响。所有其他情况都默认为 ROTATION_ANIMATION_ROTATE 行为。
1910 #[java_field]
1911 pub fn set_rotation_animation(&self, value: i32) {}
1912
1913 /// 拥有此窗口的包的名称。
1914 #[java_field]
1915 pub fn get_package_name(&self) -> Option<String> {}
1916
1917 /// 拥有此窗口的包的名称。
1918 #[java_field]
1919 pub fn set_package_name(&self, value: Option<String>) {}
1920
1921 /// 窗口的特定方向值。可以是 ActivityInfo.screenOrientation 允许的任何相同值。如果未设置,将使用默认值 ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED。
1922 #[java_field]
1923 pub fn get_screen_orientation(&self) -> i32 {}
1924
1925 /// 窗口的特定方向值。可以是 ActivityInfo.screenOrientation 允许的任何相同值。如果未设置,将使用默认值 ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED。
1926 #[java_field]
1927 pub fn set_screen_orientation(&self, value: i32) {}
1928
1929 /// 窗口的首选刷新率。在 API 34 之前,这必须是窗口所在显示器支持的刷新率之一。所选的刷新率将应用于显示器的默认模式。从 API 34 开始,此值不限于从窗口的显示器获得的支持的刷新率:它可以是窗口打算运行的任何刷新率。任何刷新率都可以作为首选窗口刷新率提供。
1930 /// 操作系统将选择与 preferredRefreshRate 最匹配的刷新率。设置此值相当于使用 (preferred_frame_rate, Surface.FRAME_RATE_COMPATIBILITY_DEFAULT, Surface.CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS) 调用 Surface.setFrameRate。对于想要指定刷新率但不想为任何其他 displayMode 属性(例如分辨率)指定首选项的应用程序,应使用 preferredDisplayModeId。如果设置了 preferredDisplayModeId,则忽略此值。
1931 #[java_field]
1932 pub fn get_preferred_refresh_rate(&self) -> f32 {}
1933
1934 /// 窗口的首选刷新率。在 API 34 之前,这必须是窗口所在显示器支持的刷新率之一。所选的刷新率将应用于显示器的默认模式。从 API 34 开始,此值不限于从窗口的显示器获得的支持的刷新率:它可以是窗口打算运行的任何刷新率。任何刷新率都可以作为首选窗口刷新率提供。
1935 /// 操作系统将选择与 preferredRefreshRate 最匹配的刷新率。设置此值相当于使用 (preferred_frame_rate, Surface.FRAME_RATE_COMPATIBILITY_DEFAULT, Surface.CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS) 调用 Surface.setFrameRate。对于想要指定刷新率但不想为任何其他 displayMode 属性(例如分辨率)指定首选项的应用程序,应使用 preferredDisplayModeId。如果设置了 preferredDisplayModeId,则忽略此值。
1936 #[java_field]
1937 pub fn set_preferred_refresh_rate(&self, value: f32) {}
1938
1939 /// 窗口首选显示模式的 ID。这必须是窗口所在显示器支持的模式之一。值为 0 表示无偏好。
1940 #[java_field]
1941 pub fn get_preferred_display_mode_id(&self) -> i32 {}
1942
1943 /// 窗口首选显示模式的 ID。这必须是窗口所在显示器支持的模式之一。值为 0 表示无偏好。
1944 #[java_field]
1945 pub fn set_preferred_display_mode_id(&self, value: i32) {}
1946
1947 /// 窗口处于焦点状态时的最小显示刷新率。如果设置了 preferredDisplayModeId,则此值会被忽略。
1948 #[java_field]
1949 pub fn get_preferred_min_display_refresh_rate(&self) -> f32 {}
1950
1951 /// 窗口处于焦点状态时的最小显示刷新率。如果设置了 preferredDisplayModeId,则此值会被忽略。
1952 #[java_field]
1953 pub fn set_preferred_min_display_refresh_rate(&self, value: f32) {}
1954
1955 /// 窗口处于焦点状态时的最大显示刷新率。如果设置了 preferredDisplayModeId,则此值会被忽略。
1956 #[java_field]
1957 pub fn get_preferred_max_display_refresh_rate(&self) -> f32 {}
1958
1959 /// 窗口处于焦点状态时的最大显示刷新率。如果设置了 preferredDisplayModeId,则此值会被忽略。
1960 #[java_field]
1961 pub fn set_preferred_max_display_refresh_rate(&self, value: f32) {}
1962
1963 /// 控制状态栏的可见性。
1964 #[deprecated(note = "SystemUiVisibility 标志已弃用。请改用 WindowInsetsController。")]
1965 #[java_field]
1966 pub fn get_system_ui_visibility(&self) -> i32 {}
1967
1968 /// 控制状态栏的可见性。
1969 #[deprecated(note = "SystemUiVisibility 标志已弃用。请改用 WindowInsetsController。")]
1970 #[java_field]
1971 pub fn set_system_ui_visibility(&self, value: i32) {}
1972
1973 /// 此层次结构中的视图所要求的 UI 可见性。组合值应为 systemUiVisibility | subtreeSystemUiVisibility。
1974 #[java_field]
1975 pub fn get_subtree_system_ui_visibility(&self) -> i32 {}
1976
1977 /// 此层次结构中的视图所要求的 UI 可见性。组合值应为 systemUiVisibility | subtreeSystemUiVisibility。
1978 #[java_field]
1979 pub fn set_subtree_system_ui_visibility(&self, value: i32) {}
1980
1981 /// 获取有关系统 UI 可见性变化的回调。TODO:也许应该有一个我们需要的可选回调的位域。
1982 #[java_field]
1983 pub fn get_has_system_ui_listeners(&self) -> bool {}
1984
1985 /// 获取有关系统 UI 可见性变化的回调。TODO:也许应该有一个我们需要的可选回调的位域。
1986 #[java_field]
1987 pub fn set_has_system_ui_listeners(&self, value: bool) {}
1988
1989 /// 如果有 DisplayCutout,则控制窗口的布局方式。默认为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT。
1990 #[java_field]
1991 pub fn get_layout_in_display_cutout_mode(&self) -> i32 {}
1992
1993 /// 如果有 DisplayCutout,则控制窗口的布局方式。默认为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT。
1994 #[java_field]
1995 pub fn set_layout_in_display_cutout_mode(&self, value: i32) {}
1996
1997 /// 控制向应用进程公开的输入子系统的一组功能。警告:请勿使用 android.os.InputConfig 标志!必须将其设置为 WindowManager.LayoutParams.InputFeatureFlags 中包含的标志值。
1998 #[java_field]
1999 pub fn get_input_features(&self) -> i32 {}
2000
2001 /// 控制向应用进程公开的输入子系统的一组功能。警告:请勿使用 android.os.InputConfig 标志!必须将其设置为 WindowManager.LayoutParams.InputFeatureFlags 中包含的标志值。
2002 #[java_field]
2003 pub fn set_input_features(&self, value: i32) {}
2004
2005 /// 设置此窗口获得焦点时用户活动超时发生前的毫秒数。值为 -1 时使用标准超时。值为 0 时使用最小支持显示超时。此属性只能用于减少用户指定的显示超时;它永远不会使超时时间比正常时间长。仅应由键盘锁和手机应用使用。
2006 #[java_field]
2007 pub fn get_user_activity_timeout(&self) -> i64 {}
2008
2009 /// 设置此窗口获得焦点时用户活动超时发生前的毫秒数。值为 -1 时使用标准超时。值为 0 时使用最小支持显示超时。此属性只能用于减少用户指定的显示超时;它永远不会使超时时间比正常时间长。仅应由键盘锁和手机应用使用。
2010 #[java_field]
2011 pub fn set_user_activity_timeout(&self, value: i64) {}
2012
2013 /// 对于具有锚点的窗口(例如 PopupWindow),跟踪锚定窗口的视图。
2014 #[java_field]
2015 pub fn get_accessibility_id_of_anchor(&self) -> i64 {}
2016
2017 /// 对于具有锚点的窗口(例如 PopupWindow),跟踪锚定窗口的视图。
2018 #[java_field]
2019 pub fn set_accessibility_id_of_anchor(&self, value: i64) {}
2020
2021 /// 窗口标题与标题栏中显示的内容不同步,因此我们单独跟踪当前显示的标题以提供可访问性。
2022 #[java_field]
2023 pub fn get_accessibility_title<CS: CharSequence>(&self) -> CS {}
2024
2025 /// 窗口标题与标题栏中显示的内容不同步,因此我们单独跟踪当前显示的标题以提供可访问性。
2026 #[java_field]
2027 pub fn set_accessibility_title<CS: CharSequence>(&self, value: &CS) {}
2028
2029 /// 设置窗口管理器隐藏窗口的超时时间(以毫秒为单位)。对于诸如提示消息之类的瞬时通知很有用,这样我们就不必依赖客户端的配合来确保窗口被隐藏。必须在创建窗口时指定。请注意,应用程序无法处理未经其明确请求而被移除的窗口,并且可能会尝试与已移除的窗口进行交互,从而导致未定义的行为和崩溃。因此,我们确实会隐藏此类窗口,以防止它们覆盖其他应用程序。
2030 #[java_field]
2031 pub fn get_hide_timeout_milliseconds(&self) -> i64 {}
2032
2033 /// 设置窗口管理器隐藏窗口的超时时间(以毫秒为单位)。对于诸如提示消息之类的瞬时通知很有用,这样我们就不必依赖客户端的配合来确保窗口被隐藏。必须在创建窗口时指定。请注意,应用程序无法处理未经其明确请求而被移除的窗口,并且可能会尝试与已移除的窗口进行交互,从而导致未定义的行为和崩溃。因此,我们确实会隐藏此类窗口,以防止它们覆盖其他应用程序。
2034 #[java_field]
2035 pub fn set_hide_timeout_milliseconds(&self, value: i64) {}
2036
2037 /// 指示此窗口是否希望连接的显示器对生成的图像或视频帧进行最少的后期处理。仅当窗口在屏幕上可见时才会请求此设置。当低延迟比图像增强处理具有更高的优先级时,应使用此设置(例如,对于游戏或视频会议)。如果显示器接收器通过 HDMI 连接,则设备将开始发送启用了自动低延迟模式和游戏内容类型的信息帧。这会将连接的显示器切换到最小图像处理模式(如果可用),从而减少延迟,改善游戏或视频会议应用程序的用户体验。有关更多信息,请参阅 HDMI 2.1 规范。
2038 /// 如果显示器接收器具有内部连接或使用 HDMI 以外的其他协议,效果可能类似,但由实现定义。切换到具有最少后期处理的模式的功能可以通过系统设置菜单中的用户设置禁用。在这种情况下,此字段将被忽略,显示器将保持其当前模式。
2039 #[java_field]
2040 pub fn get_prefer_minimal_post_processing(&self) -> bool {}
2041
2042 /// 指示此窗口是否希望连接的显示器对生成的图像或视频帧进行最少的后期处理。仅当窗口在屏幕上可见时才会请求此设置。当低延迟比图像增强处理具有更高的优先级时,应使用此设置(例如,对于游戏或视频会议)。如果显示器接收器通过 HDMI 连接,则设备将开始发送启用了自动低延迟模式和游戏内容类型的信息帧。这会将连接的显示器切换到最小图像处理模式(如果可用),从而减少延迟,改善游戏或视频会议应用程序的用户体验。有关更多信息,请参阅 HDMI 2.1 规范。
2043 /// 如果显示器接收器具有内部连接或使用 HDMI 以外的其他协议,效果可能类似,但由实现定义。切换到具有最少后期处理的模式的功能可以通过系统设置菜单中的用户设置禁用。在这种情况下,此字段将被忽略,显示器将保持其当前模式。
2044 #[java_field]
2045 pub fn set_prefer_minimal_post_processing(&self, value: bool) {}
2046
2047 /// 如果指定,则用于计算相对圆角的框架将是此窗口的框架减去此窗口提供的插入部分。任务栏将在其上方绘制假圆角,因此我们需要此插入部分来计算此窗口的正确圆角。
2048 #[java_field]
2049 pub fn get_insets_rounded_corner_frame(&self) -> bool {}
2050
2051 /// 如果指定,则用于计算相对圆角的框架将是此窗口的框架减去此窗口提供的插入部分。任务栏将在其上方绘制假圆角,因此我们需要此插入部分来计算此窗口的正确圆角。
2052 #[java_field]
2053 pub fn set_insets_rounded_corner_frame(&self, value: bool) {}
2054
2055 /**
2056 指定此窗口在布局期间应避免重叠的插入类型。
2057 `types` 哪些 WindowInsets。此窗口应避免的插入类型。此对象的初始值包括所有系统栏。
2058 */
2059 #[java_method]
2060 pub fn set_fit_insets_types(&self, types: i32) {}
2061
2062 /**
2063 指定此窗口在布局期间应避免重叠的边。
2064 `sides` 此窗口应避免与指定类型的边重叠。此对象的初始值包括所有边。
2065 */
2066 #[java_method]
2067 pub fn set_fit_insets_sides(&self, sides: i32) {}
2068
2069 /**
2070 指定此窗口是否应适合窗口插入,无论它们是否可见。
2071 `ignore` 如果为 true,此窗口将适合给定的类型,即使它们不可见。
2072 */
2073 #[java_method]
2074 pub fn set_fit_insets_ignoring_visibility(&self, ignore: bool) {}
2075
2076 /**
2077 指定应将窗口视为受信任的系统覆盖层。考虑窗口在输入调度期间是否被遮挡时,将忽略受信任的系统覆盖层。需要 android.Manifest.permission.INTERNAL_SYSTEM_WINDOW 权限。
2078 @see android.view.MotionEvent#FLAG_WINDOW_IS_OBSCURED
2079 @see android.view.MotionEvent#FLAG_WINDOW_IS_PARTIALLY_OBSCURED
2080 */
2081 #[java_method]
2082 pub fn set_trusted_overlay(&self) {}
2083
2084 /**
2085 当在 TYPE_APPLICATION_OVERLAY 窗口上设置时,它们保持可见,即使为另一个可见窗口设置了 SYSTEM_FLAG_HIDE_NON_SYSTEM_OVERLAY_WINDOWS。
2086 `is_system_application_overlay` 系统应用覆盖。
2087 */
2088 #[java_method]
2089 pub fn set_system_application_overlay(&self, is_system_application_overlay: bool) {}
2090
2091 /// 如果此窗口被标记为系统应用程序覆盖,则返回。
2092 #[java_method]
2093 pub fn is_system_application_overlay(&self) -> bool {}
2094
2095 /**
2096 设置是否应向系统壁纸发送触摸事件(可以由第三方应用程序提供),以启用背景中显示壁纸的窗口。默认情况下,这将设置为true。检查flag_show_wallpaper以获取有关显示窗口后面系统壁纸的更多信息。
2097 `enable` 是否可以向系统壁纸发送触摸事件。
2098 */
2099 #[java_method]
2100 pub fn set_wallpaper_touch_events_enabled(&self, enable: bool) {}
2101
2102 /**
2103 返回是否允许在后台显示壁纸的窗口向系统壁纸(可由第三方应用提供)发送触摸事件。检查 FLAG_SHOW_WALLPAPER 以获取有关在窗口后面显示系统壁纸的更多信息。
2104 返回:是否允许向系统壁纸发送触摸事件。
2105 */
2106 #[java_method]
2107 pub fn are_wallpaper_touch_events_enabled(&self) -> bool {}
2108
2109 /**
2110 设置是否可以为该窗口的位置变化播放动画。
2111 `enable` 如果禁用,窗口将立即移动到其新位置而不播放动画。
2112 */
2113 #[java_method]
2114 pub fn set_can_play_move_animation(&self, enable: bool) {}
2115
2116 /// 是否允许在此窗口上的位置改变期间播放动画。这并不能保证在所有此类情况下都会播放动画。例如,拖动调整大小可能会移动窗口但不播放动画。
2117 #[java_method]
2118 pub fn can_play_move_animation(&self) -> bool {}
2119
2120 /// WindowInsets。此窗口避免重叠的类型。
2121 #[java_method]
2122 pub fn get_fit_insets_types(&self) -> i32 {}
2123
2124 /// 此窗口避免重叠的侧面。
2125 #[java_method]
2126 pub fn get_fit_insets_sides(&self) -> i32 {}
2127
2128 /// 如果此窗口适合窗口插图,则无论它们是否可见,都为 true。
2129 #[java_method]
2130 pub fn is_fit_insets_ignoring_visibility(&self) -> bool {}
2131
2132 #[java_method]
2133 pub fn for_rotation(&self, rotation: i32) -> Self {}
2134
2135 #[java_constructor]
2136 pub fn new() -> Self {}
2137
2138 #[java_method]
2139 pub fn set_title<CS: CharSequence>(&self, title: Option<CS>) {}
2140
2141 #[java_method]
2142 pub fn get_title<CS: CharSequence>(&self) -> Option<CS> {}
2143
2144 /**
2145 根据输入视图的高度(视觉 z 位置)设置表面插图。
2146 */
2147 #[java_method]
2148 pub fn set_surface_insets(&self, view: &View, manual: bool, preserve_previous: bool) {}
2149
2150 /// 返回窗口是否启用了 HDR 转换
2151 #[java_method]
2152 pub fn is_hdr_conversion_enabled(&self) -> bool {}
2153
2154 /// 启用/禁用窗口的 HDR 转换。默认情况下,窗口的 HDR 转换已启用。
2155 #[java_method]
2156 pub fn set_hdr_conversion_enabled(&self, enabled: bool) {}
2157
2158 /**
2159 设置窗口的颜色模式。设置颜色模式可能会覆盖窗口的像素格式。
2160 `color_mode` 颜色模式必须是 ActivityInfo.COLOR_MODE_DEFAULT、ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT 或 ActivityInfo.COLOR_MODE_HDR 之一。
2161 */
2162 #[java_method]
2163 pub fn set_color_mode(&self, color_mode: i32) {}
2164
2165 /// 返回窗口的颜色模式,可以是 ActivityInfo.COLOR_MODE_DEFAULT、ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT 或 ActivityInfo.COLOR_MODE_HDR 之一。
2166 #[java_method]
2167 pub fn get_color_mode(&self) -> i32 {}
2168
2169 /**
2170 使窗口后面的屏幕模糊。效果类似于 dimAmount,但不是变暗,而是使窗口后面的内容模糊(或与暗淡量相结合,如果指定了)。模糊的密度由模糊半径设置。半径定义相邻区域的大小,从中对像素进行平均以形成每个像素的最终颜色。该操作近似于高斯模糊。半径为 0 表示无模糊。半径越大,模糊越密集。
2171 请注意与 Window.setBackgroundBlurRadius 的区别,它仅在窗口范围内模糊。后面模糊会使窗口后面的整个屏幕模糊。需要设置 FLAG_BLUR_BEHIND。由于 GPU 限制,某些设备可能不支持跨窗口模糊。它也可以在运行时禁用,例如在省电模式下、使用多媒体隧道时或请求最少的后期处理时。在这种情况下,不会计算或绘制任何模糊,导致窗口与其后面的内容之间没有深度分离。为了避免这种情况,应用程序可能需要在其窗口上使用更多的 dimAmount。
2172 要监听跨窗口模糊启用/禁用事件,请使用 addCrossWindowBlurEnabledListener。
2173 `blur_behind_radius` 用于模糊后方的模糊半径(以像素为单位)
2174 */
2175 #[java_method]
2176 pub fn set_blur_behind_radius(&self, blur_behind_radius: i32) {}
2177
2178 /// 返回窗口半径后面的模糊程度。
2179 #[java_method]
2180 pub fn get_blur_behind_radius(&self) -> i32 {}
2181
2182 #[java_method]
2183 pub fn describe_contents(&self) -> i32 {}
2184
2185 #[java_method]
2186 pub fn copy_from(&self, o: &Self) -> i32 {}
2187
2188 /**
2189 缩放布局参数的坐标和大小。
2190 `scale` 缩放系数。
2191 */
2192 #[java_method]
2193 pub fn scale(&self, scale: f32) {}
2194
2195 /**
2196 如果布局参数将导致窗口覆盖整个屏幕,则为 True;否则为 false。
2197 */
2198 #[java_method]
2199 pub fn is_fullscreen(&self) -> bool {}
2200
2201 /// 如果窗口应自行处理所有指针事件(无论它们是否在窗口内),则为 True。如果窗口是模态窗口,其可触摸区域将扩展至其任务的大小。
2202 #[java_method]
2203 pub fn is_modal(&self) -> bool {}
2204}
2205
2206/**
2207提供有关逻辑显示器的大小和密度的信息。显示区域有两种不同的描述方式。应用程序显示区域指定可能包含应用程序窗口的显示器部分,不包括系统装饰。应用程序显示区域可能小于实际显示区域,因为系统减去了状态栏等装饰元素所需的空间。
2208使用 WindowMetrics.getBounds() 查询应用程序窗口边界。实际显示区域指定应用程序在当前系统状态下可访问的显示器部分。在某些情况下,实际显示区域可能小于显示器的物理尺寸。使用 WindowManager.getCurrentWindowMetrics() 确定活动窗口的当前大小。
2209与 UI 相关的工作(例如选择 UI 布局)应依赖于 WindowMetrics.getBounds()。有关详细信息,请参阅 getRealSize / getRealMetrics。逻辑显示器不一定代表特定的物理显示设备,例如内部显示器或外部显示器。
2210根据当前连接的设备以及是否启用镜像,逻辑显示器的内容可能会显示在一个或多个物理显示器上。
2211*/
2212#[java_class(name = "android/view/Display")]
2213pub struct Display;
2214
2215impl Display {
2216 /// 默认的 Display ID,假设有一个主显示器,则为主显示器的 ID。
2217 pub const DEFAULT_DISPLAY: i32 = 0;
2218
2219 /// 无效的显示 ID。
2220 pub const INVALID_DISPLAY: i32 = -1;
2221
2222 /// 分辨率宽度无效。
2223 pub const INVALID_DISPLAY_WIDTH: i32 = -1;
2224
2225 /// 分辨率高度无效。
2226 pub const INVALID_DISPLAY_HEIGHT: i32 = -1;
2227
2228 /// 刷新率无效。
2229 pub const INVALID_DISPLAY_REFRESH_RATE: f32 = 0.0;
2230
2231 /// 默认显示组 ID,假设有一个主显示器,则为主显示器的显示组 ID。
2232 pub const DEFAULT_DISPLAY_GROUP: i32 = 0;
2233
2234 /// 显示组 ID 无效。
2235 pub const INVALID_DISPLAY_GROUP: i32 = -1;
2236
2237 /// 显示标志:表示显示器支持合成存储在受保护图形缓冲区中的内容。如果设置了此标志,则显示设备支持合成受保护缓冲区。如果未设置此标志,则显示设备可能不支持合成受保护缓冲区;用户可能会在屏幕上看到空白区域而不是受保护的内容。安全 (DRM) 视频解码器可以分配受保护的图形缓冲区,以请求在视频解码器和外部显示接收器之间提供受硬件保护的路径。
2238 /// 如果没有可用的硬件保护路径,则可能无法合成存储在受保护图形缓冲区中的内容。应用程序可以使用此标志的缺失作为提示,表示它不应该为此显示使用受保护的缓冲区,因为内容可能不可见。例如,如果未设置标志,则应用程序可以选择不在此显示器上显示内容、显示信息性错误消息、选择备用内容流或采用不依赖受保护缓冲区的不同内容解码策略。
2239 pub const FLAG_SUPPORTS_PROTECTED_BUFFERS: i32 = 1 << 0;
2240
2241 /// 显示标志:表示显示器具有安全的视频输出并支持合成安全表面。如果设置了此标志,则显示设备具有安全的视频输出并能够显示安全表面。它也可能能够显示 FLAG_SUPPORTS_PROTECTED_BUFFERS 受保护的缓冲区。如果未设置此标志,则显示设备可能没有安全的视频输出;用户可能会在屏幕上看到空白区域,而不是安全表面或受保护缓冲区的内容。
2242 /// 安全表面用于防止应用程序渲染到这些表面的内容出现在屏幕截图中或在非安全显示器上查看。安全视频解码器使用受保护的缓冲区来实现类似目的。应用程序通过指定 WindowManager.LayoutParams#FLAG_SECURE 窗口标志来创建具有安全表面的窗口。同样,应用程序通过在将安全视图附加到其包含窗口之前调用 SurfaceView#setSecure 来创建具有安全表面的 SurfaceView。应用程序可以使用此标志的缺失来提示它不应在此显示器上创建安全表面或受保护的缓冲区,因为内容可能不可见。例如,如果未设置该标志,则应用程序可以选择不在此显示器上显示内容,显示信息性错误消息,选择备用内容流或采用不依赖安全表面或受保护缓冲区的其他策略来解码内容。
2243 pub const FLAG_SECURE: i32 = 1 << 1;
2244
2245 /// 显示标志:表示该显示是私有的。只有拥有该显示的应用和已经在该显示上的应用才能在该显示上创建窗口。
2246 pub const FLAG_PRIVATE: i32 = 1 << 2;
2247
2248 /// 显示标志:表示该显示器是演示显示器。此标志标识适合用作演示显示器的辅助显示器,例如外部或无线显示器。应用程序可以自动将其内容投影到演示显示器,以提供更丰富的第二屏幕体验。
2249 pub const FLAG_PRESENTATION: i32 = 1 << 3;
2250
2251 /// 显示标志:表示显示屏为圆形。此标志标识显示屏为圆形、椭圆形或其他形状,不允许用户看到显示屏的所有逻辑角落。
2252 pub const FLAG_ROUND: i32 = 1 << 4;
2253
2254 /// 显示标志:表示在显示非安全键盘保护时,显示器可以显示其内容。此标志标识如果无需输入凭据即可关闭键盘保护,则辅助显示器将继续显示内容。使用的一个示例是虚拟显示器,其内容显示在系统无法直接看到的外部硬件显示器上。
2255 /// TODO (b/114338689): 删除该标志并使用 IWindowManager#shouldShowWithInsecureKeyguard
2256 pub const FLAG_CAN_SHOW_WITH_INSECURE_KEYGUARD: i32 = 1 << 5;
2257
2258 /// 显示标志:表示显示应显示系统装饰。此标志标识应显示系统装饰的辅助显示,例如状态栏、导航栏、主页活动或 IME。请注意,如果没有 FLAG_TRUSTED,此标志不起作用
2259 /// TODO (b/114338689): 删除该标志并使用 IWindowManager#setShouldShowSystemDecors
2260 pub const FLAG_SHOULD_SHOW_SYSTEM_DECORATIONS: i32 = 1 << 6;
2261
2262 /// 标志:信任该显示器可以显示系统装饰并接收输入,无需用户触摸。
2263 pub const FLAG_TRUSTED: i32 = 1 << 7;
2264
2265 /// 标志:表示显示器不应该成为默认 DisplayGroup 的一部分,而应该成为新 DisplayGroup 的一部分。
2266 pub const FLAG_OWN_DISPLAY_GROUP: i32 = 1 << 8;
2267
2268 /// 标志:表示显示屏应始终解锁。仅在未在默认显示组中的虚拟显示上有效。
2269 pub const FLAG_ALWAYS_UNLOCKED: i32 = 1 << 9;
2270
2271 /// 标志:表示当用户触摸屏幕时,显示器不应播放音效或执行触觉反馈。
2272 pub const FLAG_TOUCH_FEEDBACK_DISABLED: i32 = 1 << 10;
2273
2274 /**
2275 标志:表示显示器维持自己的焦点和触摸模式。
2276 此标志在行为上与 com.android.internal.R.bool.config_perDisplayFocusEnabled 类似,但仅适用于特定显示器,而不是系统范围的所有显示器。
2277 注意:必须信任显示器才能拥有自己的焦点。
2278 */
2279 pub const FLAG_OWN_FOCUS: i32 = 1 << 11;
2280
2281 /**
2282 标志:表示显示器不应通过从另一个显示器窃取顶部焦点而成为顶部焦点显示器。
2283 结果是只有目标输入事件(输入事件的 displayId 与显示器的 displayId 匹配)才能到达此显示器。如果系统仅由一个显示器组成,或者所有显示器都设置了此标志,则设置了此标志的显示器仍可成为顶部聚焦显示器。在这两种情况下,默认显示器都会成为顶部聚焦显示器。
2284 注意:如果显示器是顶部聚焦显示器,或者显示器管理自己的焦点(通过 FLAG_OWN_FOCUS)或所有显示器管理自己的焦点(通过 ` ` 标志),则显示器仅具有聚焦窗口。如果显示器没有聚焦窗口,则不会向其发送任何输入事件。因此,此标志仅与 FLAG_OWN_FOCUS 一起使用才有用,如果未设置,将被忽略。
2285 注意:框架仅支持顶部聚焦显示屏上的 IME(b/262520411)。因此,在显示屏上启用此标志会隐式禁用显示任何 IME。这不是预期的行为,但在实施 b/262520411 之前无法修复。如果您需要在显示屏上使用 IME,请不要设置此标志。
2286 */
2287 pub const FLAG_STEAL_TOP_FOCUS_DISABLED: i32 = 1 << 12;
2288
2289 /// 显示器标志:表示显示器为后置显示器。此标志标识背对用户的互补显示器。
2290 pub const FLAG_REAR: i32 = 1 << 13;
2291
2292 /// 显示标志:表示不应缩放显示内容以适应物理屏幕尺寸。仅用于开发以模拟具有较小物理屏幕的设备,同时保持密度。
2293 pub const FLAG_SCALING_DISABLED: i32 = 1 << 30;
2294
2295 /// 显示类型:未知的显示类型。
2296 pub const TYPE_UNKNOWN: i32 = 0;
2297
2298 /// 显示器类型:通过内部端口连接的物理显示器。
2299 pub const TYPE_INTERNAL: i32 = 1;
2300
2301 /// 显示器类型:通过外部端口连接的物理显示器。
2302 pub const TYPE_EXTERNAL: i32 = 2;
2303
2304 /// 显示类型:WiFi显示。
2305 pub const TYPE_WIFI: i32 = 3;
2306
2307 /// 显示类型:覆盖显示。
2308 pub const TYPE_OVERLAY: i32 = 4;
2309
2310 /// 显示类型:虚拟显示。
2311 pub const TYPE_VIRTUAL: i32 = 5;
2312
2313 /// 显示状态:显示状态未知。
2314 pub const STATE_UNKNOWN: i32 = 0;
2315
2316 /// 显示状态:显示屏关闭。
2317 pub const STATE_OFF: i32 = 1;
2318
2319 /// 显示状态:显示屏亮。
2320 pub const STATE_ON: i32 = 2;
2321
2322 /// 显示状态:显示器在低功耗状态下处于打瞌睡状态;它仍然处于开启状态,但针对在设备非交互时显示系统提供的内容进行了优化。
2323 pub const STATE_DOZE: i32 = 3;
2324
2325 /// 显示状态:显示器处于挂起低功耗状态,处于休眠状态;它仍处于开启状态,但 CPU 不会更新它。这可以用于以下两种情况之一:在设备处于非交互状态时显示系统提供的静态内容,或允许“Sidekick”计算资源更新显示。因此,CPU 不得在此模式下控制显示器。
2326 pub const STATE_DOZE_SUSPEND: i32 = 4;
2327
2328 /// 显示状态:显示屏已开启并针对 VR 模式进行了优化。
2329 pub const STATE_VR: i32 = 5;
2330
2331 /// 显示状态:显示器处于挂起的全功率状态;它仍然打开,但 CPU 不会更新它。这可以以两种方式之一使用:在设备处于非交互状态时显示系统提供的静态内容,或允许“Sidekick”计算资源更新显示。因此,CPU 不得在此模式下控制显示器。
2332 pub const STATE_ON_SUSPEND: i32 = 6;
2333
2334 /* 下面定义的颜色模式常量必须与 system/core/include/system/graphics-base.h 中的常量保持同步 */
2335
2336 /// 显示颜色模式:当前颜色模式未知或无效。
2337 pub const COLOR_MODE_INVALID: i32 = -1;
2338
2339 /// 显示色彩模式:显示器的默认或原生色域。
2340 pub const COLOR_MODE_DEFAULT: i32 = 0;
2341
2342 #[doc(hidden)]
2343 pub const COLOR_MODE_BT601_625: i32 = 1;
2344
2345 #[doc(hidden)]
2346 pub const COLOR_MODE_BT601_625_UNADJUSTED: i32 = 2;
2347
2348 #[doc(hidden)]
2349 pub const COLOR_MODE_BT601_525: i32 = 3;
2350
2351 #[doc(hidden)]
2352 pub const COLOR_MODE_BT601_525_UNADJUSTED: i32 = 4;
2353
2354 #[doc(hidden)]
2355 pub const COLOR_MODE_BT709: i32 = 5;
2356
2357 #[doc(hidden)]
2358 pub const COLOR_MODE_DCI_P3: i32 = 6;
2359
2360 #[doc(hidden)]
2361 pub const COLOR_MODE_SRGB: i32 = 7;
2362
2363 #[doc(hidden)]
2364 pub const COLOR_MODE_ADOBE_RGB: i32 = 8;
2365
2366 #[doc(hidden)]
2367 pub const COLOR_MODE_DISPLAY_P3: i32 = 9;
2368
2369 /// 表示当显示屏被移除时,其所有活动将移至主显示屏,并且最顶层的活动将成为焦点。
2370 /// TODO (b/114338689): 删除该标志并使用 WindowManager#REMOVE_CONTENT_MODE_MOVE_TO_PRIMARY
2371 pub const REMOVE_MODE_MOVE_CONTENT_TO_PRIMARY: i32 = 0;
2372
2373 /// 表示当display被移除时,其所有堆栈和任务都将被移除,所有活动将按照通常的生命周期被销毁。
2374 /// TODO (b/114338689): 删除该标志并使用 WindowManager#REMOVE_CONTENT_MODE_DESTROY
2375 pub const REMOVE_MODE_DESTROY_CONTENT: i32 = 1;
2376
2377 #[doc(hidden)]
2378 pub const DISPLAY_MODE_ID_FOR_FRAME_RATE_OVERRIDE: i32 = 0xFF;
2379
2380 /**
2381 获取显示 ID。
2382 每个逻辑显示都有一个唯一 ID。默认显示 ID 为 DEFAULT_DISPLAY。
2383 */
2384 #[java_method]
2385 pub fn get_display_id(&self) -> i32 {}
2386
2387 /**
2388 获取显示器唯一 ID。
2389 唯一 ID 与显示器 ID 不同,因为物理显示器在重新启动后具有稳定的唯一 ID。
2390 */
2391 #[java_method]
2392 pub fn get_unique_id(&self) -> Option<String> {}
2393
2394 /**
2395 如果此显示仍然有效,则返回 true;如果显示已被移除,则返回 false。如果显示无效,则此类的方法将继续报告最近观察到的显示信息。但是,在显示消亡后继续使用 Display 对象是不明智的(而且毫无意义)。如果重新连接具有相同 ID 的显示,则之前无效的显示可能会再次有效。
2396 返回:如果显示仍然有效,则返回 True。
2397 */
2398 #[java_method]
2399 pub fn is_valid(&self) -> bool {}
2400
2401 /**
2402 获取显示器的层堆栈。每个显示器都有自己独立的层堆栈,表面放置在其上,由表面投射器进行管理。
2403 返回:显示器的层堆栈编号。
2404 */
2405 #[java_method]
2406 pub fn get_layer_stack(&self) -> i32 {}
2407
2408 /**
2409 返回描述显示器功能的标志组合。
2410 返回:显示标志。
2411 */
2412 #[java_method]
2413 pub fn get_flags(&self) -> i32 {}
2414
2415 /**
2416 获取显示类型。
2417 返回:显示类型。
2418 */
2419 #[java_method]
2420 pub fn get_type(&self) -> i32 {}
2421
2422 /**
2423 获取拥有此显示屏的应用程序的 UID,如果显示屏归系统所有,则获得零。如果显示屏是私有的,则只有所有者可以使用它。
2424 */
2425 #[java_method]
2426 pub fn get_owner_uid(&self) -> i32 {}
2427
2428 /**
2429 获取拥有此显示屏的应用程序的软件包名称,如果显示屏归系统所有,则返回 null。如果显示屏是私有的,则只有所有者可以使用它。
2430 */
2431 #[java_method]
2432 pub fn get_owner_package_name(&self) -> Option<String> {}
2433
2434 /**
2435 获取显示器的名称。请注意,某些显示器可能会被用户重命名。
2436 返回:显示器的名称。
2437 */
2438 #[java_method]
2439 pub fn get_name(&self) -> String {}
2440
2441 /**
2442 获取显示器配置的默认亮度。
2443 返回:默认亮度介于 0.0-1.0 之间
2444 */
2445 #[java_method]
2446 pub fn get_brightness_default(&self) -> f32 {}
2447
2448 /**
2449 返回将发生的最大屏幕尺寸。这主要用于壁纸。
2450 */
2451 #[java_method]
2452 pub fn get_maximum_size_dimension(&self) -> i32 {}
2453
2454 #[doc(hidden)]
2455 #[deprecated(note = "改用 WindowMetrics.getBounds.width()。")]
2456 #[java_method]
2457 pub fn get_width(&self) -> i32 {}
2458
2459 #[doc(hidden)]
2460 #[deprecated(note = "改用#height()。")]
2461 #[java_method]
2462 pub fn get_height(&self) -> i32 {}
2463
2464 /**
2465 返回屏幕从其“自然”方向的旋转。返回值可能是 Surface.ROTATION_0(无旋转)、Surface.ROTATION_90、Surface.ROTATION_180 或 Surface.ROTATION_270。
2466 例如,如果设备具有自然高大的屏幕,并且用户已将其侧放以进入横向方向,则此处返回的值可能是 Surface.ROTATION_90 或 Surface.ROTATION_270,具体取决于旋转的方向。角度是屏幕上绘制图形的旋转,与设备的物理旋转方向相反。例如,如果设备逆时针旋转 90 度,为了补偿渲染将顺时针旋转 90 度,因此此处返回的值将是 Surface.ROTATION_90。此旋转值将与 getMetrics 的结果相匹配:这意味着如果通过活动访问,旋转值将与活动相对应。
2467 */
2468 #[java_method]
2469 pub fn get_rotation(&self) -> i32 {}
2470
2471 /// 返回显示器的安装方向。
2472 #[java_method]
2473 pub fn get_install_orientation(&self) -> i32 {}
2474
2475 /// 返回:此显示的方向。
2476 #[deprecated(note = "使用 getRotation")]
2477 #[java_method]
2478 pub fn get_orientation(&self) -> i32 {}
2479
2480 /**
2481 获取显示器的像素格式。
2482 返回:PixelFormat 中定义的常量之一。
2483 */
2484 #[deprecated(note = "此方法不再受支持。结果始终为 PixelFormat。RGBA_8888。")]
2485 #[java_method]
2486 pub fn get_pixel_format(&self) -> i32 {}
2487
2488 /**
2489 获取此显示器的刷新率(以每秒帧数为单位)。
2490 */
2491 #[java_method]
2492 pub fn get_refresh_rate(&self) -> f32 {}
2493
2494 /**
2495 如果可以将连接的显示器切换到使用最小的后处理方式的模式,则返回true。如果显示器接收器通过HDMI连接,则如果显示屏支持自动低潜伏期模式或游戏内容类型,则此方法将返回true。如果显示器接收器具有内部连接或使用HDMI以外的其他协议,则如果可以将接收器切换到实现定义的低延迟图像处理模式,则此方法将返回true。
2496 通过系统设置菜单中的用户设置,可以禁用使用最小后处理模式的模式的能力。在这种情况下,此方法返回false。
2497 */
2498 #[java_method]
2499 pub fn is_minimal_post_processing_supported(&self) -> bool {}
2500
2501 /**
2502 请求显示器应用颜色模式。
2503 `color_mode` 颜色模式。
2504 */
2505 #[java_method]
2506 pub fn request_color_mode(&self, color_mode: i32) {}
2507
2508 /**
2509 返回此显示的活跃颜色模式
2510 */
2511 #[java_method]
2512 pub fn get_color_mode(&self) -> i32 {}
2513
2514 /// 获取显示屏的当前移除模式 - 移除显示屏内容时应对其执行哪些操作。在这种情况下,公共显示屏的默认行为是将所有活动移至主显示屏并使其处于焦点状态。对于私人显示屏 - 销毁所有活动。
2515 /// TODO (b/114338689): 删除方法并使用 IWindowManager#getRemoveContentMode
2516 #[java_method]
2517 pub fn get_remove_mode(&self) -> i32 {}
2518
2519 /**
2520 返回此显示器是否支持任何 HDR 类型。
2521 */
2522 #[java_method]
2523 pub fn is_hdr(&self) -> bool {}
2524
2525 /**
2526 显示器是否支持报告 hdr/sdr 比率。如果为 false,则 getHdrSdrRatio() 将始终为 1.0f
2527 */
2528 #[java_method]
2529 pub fn is_hdr_sdr_ratio_available(&self) -> bool {}
2530
2531 /**
2532 删除显示器的用户首选显示模式。
2533 */
2534 #[java_method]
2535 pub fn clear_user_preferred_display_mode(&self) {}
2536
2537 /**
2538 返回此显示器是否可用于显示广色域内容。这并不一定意味着设备本身可以渲染广色域内容。要确保可以生成广色域内容,请参阅 Configuration.isScreenWideColorGamut()。
2539 */
2540 #[java_method]
2541 pub fn is_wide_color_gamut(&self) -> bool {}
2542
2543 /**
2544 获取应用 VSYNC 偏移量(以纳秒为单位)。这是一个正值,表示 Choreographer 提供的 VSYNC 事件相对于显示刷新的相位偏移量。
2545 例如,如果 Choreographer 报告刷新发生在时间 N,则它实际上发生在 (N - appVsyncOffset)。应用通常不需要知道这一点。它仅适用于细粒度的 A/V 同步。
2546 */
2547 #[java_method]
2548 pub fn get_app_vsync_offset_nanos(&self) -> i64 {}
2549
2550 //noinspection SpellCheckingInspection
2551 /**
2552 这是缓冲区必须提前多久排队等待在给定时间进行演示。如果您希望缓冲区在时间 N 出现在屏幕上,则必须在 (N - presentationDeadline) 之前提交缓冲区。
2553 可以使用 android.opengl.EGLExt.eglPresentationTimeANDROID 设置 GLES 渲染所需的演示时间。对于视频解码,请使用 android.media.MediaCodec.releaseOutputBuffer(int, long)。时间以纳秒为单位表示,使用系统单调时钟 (System.nanoTime)。
2554 */
2555 #[java_method]
2556 pub fn get_presentation_deadline_nanos(&self) -> i64 {}
2557
2558 /**
2559 确定是否应将 WindowConfiguration.getMaxBounds() 报告为显示尺寸。当应用需要沙盒化时,最大边界字段可能小于逻辑尺寸。取决于 com.android.server.wm.ConfigurationContainer.providesMaxBounds() 中设置的 WindowConfiguration.getMaxBounds()。
2560 在大多数情况下,此值反映当前 DisplayArea 的大小。当应应用最大边界时,返回 true。
2561 */
2562 #[java_method]
2563 pub fn should_report_max_bounds(&self) -> bool {}
2564
2565 /**
2566 获取显示器的状态,例如是打开还是关闭。
2567 返回:显示器的状态:STATE_OFF、STATE_ON、STATE_DOZE、STATE_DOZE_SUSPEND、STATE_ON_SUSPEND 或 STATE_UNKNOWN 之一。
2568 */
2569 #[java_method]
2570 pub fn get_state(&self) -> i32 {}
2571
2572 /**
2573 如果指定的 UID 有权访问此显示,则返回 true。
2574 `uid` UID。
2575 */
2576 #[java_method]
2577 pub fn has_access(&self, uid: i32) -> bool {}
2578
2579 /// 如果显示是公共演示文稿显示,则返回true。
2580 #[java_method]
2581 pub fn is_public_presentation(&self) -> bool {}
2582
2583 /// 如果显示器是受信任的显示器,则为 true。
2584 #[java_method]
2585 pub fn is_trusted(&self) -> bool {}
2586
2587 /// 如果显示器可以从另一个显示器窃取顶部焦点,则为 true。
2588 #[java_method]
2589 pub fn can_steal_top_focus(&self) -> bool {}
2590
2591 #[doc(hidden)]
2592 #[java_method]
2593 pub fn type_to_string(r#type: i32) -> String {}
2594
2595 #[doc(hidden)]
2596 #[java_method]
2597 pub fn state_to_string(state: i32) -> String {}
2598
2599 /**
2600 如果在指定的显示器电源状态下可以暂停显示更新,则返回 true。在 SUSPEND 状态下,绝对禁止更新。
2601 `state` 状态。
2602 */
2603 #[java_method]
2604 pub fn is_suspended_state(state: i32) -> bool {}
2605
2606 /**
2607 如果在指定的显示器电源状态下显示器可能处于降低的操作模式,则返回 true。
2608 `state` 状态。
2609 */
2610 #[java_method]
2611 pub fn is_doze_state(state: i32) {}
2612
2613 /**
2614 如果显示器处于活动状态(例如 STATE_ON 或 STATE_VR),则返回 true。
2615 `state` 状态。
2616 */
2617 #[java_method]
2618 pub fn is_active_state(state: i32) {}
2619
2620 /**
2621 如果显示器处于关闭状态(例如 STATE_OFF),则返回 true。
2622 `state` 状态。
2623 */
2624 #[java_method]
2625 pub fn is_off_state(state: i32) -> bool {}
2626
2627 /**
2628 如果显示器处于开启状态(例如 STATE_ON 或 STATE_VR 或 STATE_ON_SUSPEND),则返回 true。
2629 `state` 状态。
2630 */
2631 #[java_method]
2632 pub fn is_on_state(state: i32) -> bool {}
2633
2634 /**
2635 如果指定的宽度有效,则返回 true。
2636 `width` 宽度。
2637 */
2638 #[java_method]
2639 pub fn is_width_valid(width: i32) -> bool {}
2640
2641 /**
2642 如果指定的高度有效,则返回 true。
2643 `height` 高度。
2644 */
2645 #[java_method]
2646 pub fn is_height_valid(height: i32) -> bool {}
2647
2648 /**
2649 如果指定的刷新率有效,则返回 true。
2650 `refresh_rate` 刷新率。
2651 */
2652 #[java_method]
2653 pub fn is_refresh_rate_valid(refresh_rate: f32) -> bool {}
2654}
2655
2656/// 输入事件的通用基类。
2657#[java_class(name = "android/view/InputEvent")]
2658pub struct InputEvent;
2659
2660impl InputEvent {
2661 /**
2662 获取此事件所来自设备的 ID。ID 为零表示事件不是来自物理设备并映射到默认键盘映射。其他数字是任意的,您不应该依赖这些值。
2663 返回:设备 ID。
2664 */
2665 #[java_method]
2666 pub fn get_device_id(&self) -> i32 {}
2667
2668 /**
2669 获取事件源。
2670 返回:事件源或输入设备。如果未知,则返回 SOURCE_UNKNOWN。
2671 */
2672 #[java_method]
2673 pub fn get_source(&self) -> i32 {}
2674
2675 /**
2676 修改事件的来源。
2677 `source` 新来源。
2678 */
2679 #[java_method]
2680 pub fn set_source(&self, source: i32) {}
2681
2682 /**
2683 确定事件是否来自给定的源。
2684 返回:事件是否来自给定的源。
2685 `source` 要检查的输入源。这可以是特定的设备类型,例如 InputDevice.SOURCE_TOUCH_NAVIGATION,也可以是更通用的设备类,例如 InputDevice.SOURCE_CLASS_POINTER。
2686 */
2687 #[java_method]
2688 pub fn is_from_source(&self, source: i32) -> bool {}
2689
2690 /**
2691 获取事件的显示 ID。
2692 返回:与事件关联的显示 ID。
2693 */
2694 #[java_method]
2695 pub fn get_display_id(&self) -> i32 {}
2696
2697 /**
2698 修改与事件关联的显示 ID
2699 `display_id`
2700 */
2701 #[java_method]
2702 pub fn set_display_id(&self, display_id: i32) {}
2703
2704 /**
2705 回收事件。此方法仅应由系统使用,因为应用程序不希望回收 KeyEvent 对象,但可以回收 MotionEvent 对象。
2706 有关详细信息,请参阅 KeyEvent.recycle()。
2707 */
2708 #[java_method]
2709 pub fn recycle(&self) {}
2710
2711 /**
2712 在将事件分发给应用程序后,如果合适,则有条件地回收事件。如果事件是 MotionEvent,则回收该事件。如果事件是 KeyEvent,则不回收该事件,因为应用程序希望按键事件是不可变的,因此一旦将事件分发给应用程序,我们就不能再回收它了。
2713 */
2714 #[java_method]
2715 pub fn recycle_if_needed_after_dispatch(&self) {}
2716
2717 /**
2718 获取一个私有标志,该标志指示系统何时检测到此输入事件可能与先前传递的输入事件的序列不一致,例如,当发送了按键释放事件但按键未按下时,或者当发送了指针移动事件但指针未按下时。
2719 返回:如果此事件被污染,则返回 True。
2720 */
2721 #[java_method]
2722 pub fn is_tainted(&self) -> bool {}
2723
2724 /**
2725 设置一个私有标志,指示系统何时检测到此输入事件可能与先前传递的输入事件的序列不一致,例如,当发送了按键释放事件但按键未按下时,或者当发送了指针移动事件但指针未按下时。
2726 `tainted` 如果此事件被污染,则为 True。
2727 */
2728 #[java_method]
2729 pub fn set_tainted(&self, tainted: bool) {}
2730
2731 /**
2732 以 android.os.SystemClock.uptimeMillis 时间基准查询此事件发生的时间。
2733 返回:以 android.os.SystemClock.uptimeMillis 时间基准返回此事件发生的时间。
2734 */
2735 #[java_method]
2736 pub fn get_event_time(&self) -> i64 {}
2737
2738 /**
2739 查询此事件发生的时间,以 android.os.SystemClock.uptimeMillis 时间为基础,但精度为纳秒(而不是毫秒)。该值以纳秒为精度,但可能不具有纳秒的精度。
2740 返回:返回此事件发生的时间,以 android.os.SystemClock.uptimeMillis 时间为基础,但精度为纳秒(而不是毫秒)。
2741 */
2742 #[java_method]
2743 pub fn get_event_time_nanos(&self) -> i64 {}
2744
2745 /**
2746 将输入事件标记为已取消。
2747 */
2748 #[java_method]
2749 pub fn cancel(&self) {}
2750
2751 /**
2752 获取此事件的唯一序列号。进程创建或接收的每个输入事件都有唯一的序列号。此外,每次回收事件对象时都会获得一个新的序列号。序列号仅保证在进程内本地唯一。打包事件时不会保留序列号。
2753 返回:此事件的唯一序列号。
2754 */
2755 #[java_method]
2756 pub fn get_sequence_number(&self) -> i32 {}
2757
2758 //noinspection SpellCheckingInspection
2759 /**
2760 获取此事件的 ID。此 ID 在事件创建时生成,并保存到事件的最后阶段。它不会因为事件跨越进程边界而改变,但在进行修改复制时应该会改变。为了避免将应用程序使用情况暴露给其他进程,此 ID 由 CSPRNG 生成。因此,虽然 ID 冲突的可能性相当低,但不能 100% 保证此 ID 的唯一性。经验法则是不要依赖生产逻辑的唯一性,而要依赖跟踪事件(例如日志记录和分析)的良好来源。
2761 返回:此事件的 ID。
2762 */
2763 #[java_method]
2764 pub fn get_id(&self) -> i32 {}
2765
2766 #[doc(hidden)]
2767 #[java_method]
2768 pub fn describe_contents(&self) -> i32 {}
2769}
2770
2771//noinspection SpellCheckingInspection
2772/**
2773用于报告按键和按钮事件的对象。每次按键都由一系列按键事件描述。按键以 ACTION_DOWN 按键事件开始。如果按键保持的时间足够长,以至于重复,则初始按下之后是其他按键事件,其中 ACTION_DOWN 和非零 getRepeatCount() 值。最后一个按键事件是按键弹起的 ACTION_UP。
2774如果取消按键,则按键弹起事件将设置 FLAG_CANCELED 标志。按键事件通常伴随着按键代码 (getKeyCode())、扫描代码 (getScanCode()) 和元状态 (getMetaState())。按键代码常量在此类中定义。扫描代码常量是从操作系统获得的原始设备特定代码,因此除非使用 KeyCharacterMap 进行解释,否则通常对应用程序没有意义。
2775元状态描述按键修饰符(如 META_SHIFT_ON 或 META_ALT_ON)的按下状态。按键代码通常与输入设备上的各个按键一一对应。许多按键和按键组合在不同的输入设备上具有完全不同的功能,因此在解释它们时必须小心谨慎。将按键映射到字符时,请始终使用与输入设备关联的 KeyCharacterMap。
2776请注意,可能同时有多个按键输入设备处于活动状态,并且每个设备都有自己的按键字符映射。由于软输入法可以使用多种创新的文本输入方式,因此无法保证软键盘上的任何按键都会生成按键事件:这由 IME 自行决定,实际上不鼓励发送此类事件。您永远不应该依赖于接收软输入法上任何按键的 KeyEvent。
2777特别是,默认软件键盘永远不会向任何针对 Jelly Bean 或更高版本的应用程序发送任何按键事件,并且只会向针对 Ice Cream Sandwich 或更早版本的应用程序发送某些删除和返回键按下事件。请注意,其他软件输入法可能永远不会发送按键事件,无论版本如何。考虑使用编辑器操作,如 android.view.inputmethod.EditorInfo。
2778如果您需要与软件键盘进行特定交互,则可以使用 IME_ACTION_DONE,因为它可以让用户更清楚地了解您的应用程序如何对按键做出反应。与 IME 交互时,框架可能会使用特殊操作 ACTION_MULTIPLE 传递按键事件,该操作指定单个重复的按键代码或要插入的字符序列。一般来说,框架无法保证它传递给视图的按键事件始终构成完整的按键序列,因为某些事件可能会在传递之前被包含视图删除或修改。视图实现应该准备好处理 FLAG_CANCELED,并且应该容忍异常情况,例如在没有先收到上一次按键的 ACTION_UP 的情况下收到新的 ACTION_DOWN。
2779有关不同类型的输入设备和源如何表示按键和按钮的更多信息,请参阅 InputDevice。
2780*/
2781#[java_class(name = "android/view/KeyEvent", extends=InputEvent)]
2782pub struct KeyEvent;
2783
2784impl KeyEvent {
2785 /// 键码常量:未知键码。
2786 pub const KEYCODE_UNKNOWN: i32 = 0;
2787
2788 /// 键码常量:软左键。通常位于手机显示屏下方,用作多功能特征键,用于选择显示在显示屏左下角的软件定义功能。
2789 pub const KEYCODE_SOFT_LEFT: i32 = 1;
2790
2791 /// 键码常量:软右键。通常位于手机显示屏下方,用作多功能特征键,用于选择显示在显示屏右下角的软件定义功能。
2792 pub const KEYCODE_SOFT_RIGHT: i32 = 2;
2793
2794 /// 键码常量:主页键。此键由框架处理,永远不会传递给应用程序。
2795 pub const KEYCODE_HOME: i32 = 3;
2796
2797 /// 键码常量:返回键。
2798 pub const KEYCODE_BACK: i32 = 4;
2799
2800 /// 键码常量:呼叫键。
2801 pub const KEYCODE_CALL: i32 = 5;
2802
2803 //noinspection SpellCheckingInspection
2804 /// 键码常量:结束呼叫键。
2805 pub const KEYCODE_ENDCALL: i32 = 6;
2806
2807 /// 键码常量:'0'键。
2808 pub const KEYCODE_0: i32 = 7;
2809
2810 /// 键码常量:'1'键。
2811 pub const KEYCODE_1: i32 = 8;
2812
2813 /// 键码常量:'2'键。
2814 pub const KEYCODE_2: i32 = 9;
2815
2816 /// 键码常量:'3'键。
2817 pub const KEYCODE_3: i32 = 10;
2818
2819 /// 键码常量:'4'键。
2820 pub const KEYCODE_4: i32 = 11;
2821
2822 /// 键码常量:'5'键。
2823 pub const KEYCODE_5: i32 = 12;
2824
2825 /// 键码常量:'6'键。
2826 pub const KEYCODE_6: i32 = 13;
2827
2828 /// 键码常量:'7'键。
2829 pub const KEYCODE_7: i32 = 14;
2830
2831 /// 键码常量:'8'键。
2832 pub const KEYCODE_8: i32 = 15;
2833
2834 /// 键码常量:'9'键。
2835 pub const KEYCODE_9: i32 = 16;
2836
2837 /// 键码常量:'*'键。
2838 pub const KEYCODE_STAR: i32 = 17;
2839
2840 /// 键码常量:'#'键。
2841 pub const KEYCODE_POUND: i32 = 18;
2842
2843 //noinspection SpellCheckingInspection
2844 /// 键码常量:方向键向上键。也可以从轨迹球运动合成。
2845 pub const KEYCODE_DPAD_UP: i32 = 19;
2846
2847 //noinspection SpellCheckingInspection
2848 /// 键码常量:方向键向下键。也可以从轨迹球运动合成。
2849 pub const KEYCODE_DPAD_DOWN: i32 = 20;
2850
2851 //noinspection SpellCheckingInspection
2852 /// 键码常量:方向键左键。也可以从轨迹球运动合成。
2853 pub const KEYCODE_DPAD_LEFT: i32 = 21;
2854
2855 //noinspection SpellCheckingInspection
2856 /// 键码常量:方向键右键。也可以从轨迹球运动合成。
2857 pub const KEYCODE_DPAD_RIGHT: i32 = 22;
2858
2859 //noinspection SpellCheckingInspection
2860 /// 键码常量:方向键中心键。也可以从轨迹球运动合成。
2861 pub const KEYCODE_DPAD_CENTER: i32 = 23;
2862
2863 /// 键码常量:音量向上键。调整扬声器音量。
2864 pub const KEYCODE_VOLUME_UP: i32 = 24;
2865
2866 /// 键码常量:音量减键。调整扬声器音量减小。
2867 pub const KEYCODE_VOLUME_DOWN: i32 = 25;
2868
2869 /// 键码常量:电源键。
2870 pub const KEYCODE_POWER: i32 = 26;
2871
2872 /// 键码常量:相机键。用于启动相机应用程序或拍照。
2873 pub const KEYCODE_CAMERA: i32 = 27;
2874
2875 /// 键码常量:清除键。
2876 pub const KEYCODE_CLEAR: i32 = 28;
2877
2878 /// 键码常量:'A'键。
2879 pub const KEYCODE_A: i32 = 29;
2880
2881 /// 键码常量:'B'键。
2882 pub const KEYCODE_B: i32 = 30;
2883
2884 /// 键码常量:'C'键。
2885 pub const KEYCODE_C: i32 = 31;
2886
2887 /// 键码常量:'D'键。
2888 pub const KEYCODE_D: i32 = 32;
2889
2890 /// 键码常量:'E'键。
2891 pub const KEYCODE_E: i32 = 33;
2892
2893 /// 键码常量:'F'键。
2894 pub const KEYCODE_F: i32 = 34;
2895
2896 /// 键码常量:'G'键。
2897 pub const KEYCODE_G: i32 = 35;
2898
2899 /// 键码常量:'H'键。
2900 pub const KEYCODE_H: i32 = 36;
2901
2902 /// 键码常量:'I'键。
2903 pub const KEYCODE_I: i32 = 37;
2904
2905 /// 键码常量:'J'键。
2906 pub const KEYCODE_J: i32 = 38;
2907
2908 /// 键码常量:'K'键。
2909 pub const KEYCODE_K: i32 = 39;
2910
2911 /// 键码常量:'L'键。
2912 pub const KEYCODE_L: i32 = 40;
2913
2914 /// 键码常量:'M'键。
2915 pub const KEYCODE_M: i32 = 41;
2916
2917 /// 键码常量:'N'键。
2918 pub const KEYCODE_N: i32 = 42;
2919
2920 /// 键码常量:'O'键。
2921 pub const KEYCODE_O: i32 = 43;
2922
2923 /// 键码常量:'P'键。
2924 pub const KEYCODE_P: i32 = 44;
2925
2926 /// 键码常量:'Q'键。
2927 pub const KEYCODE_Q: i32 = 45;
2928
2929 /// 键码常量:'R'键。
2930 pub const KEYCODE_R: i32 = 46;
2931
2932 /// 键码常量:'S'键。
2933 pub const KEYCODE_S: i32 = 47;
2934
2935 /// 键码常量:'T'键。
2936 pub const KEYCODE_T: i32 = 48;
2937
2938 /// 键码常量:'U'键。
2939 pub const KEYCODE_U: i32 = 49;
2940
2941 /// 键码常量:'V'键。
2942 pub const KEYCODE_V: i32 = 50;
2943
2944 /// 键码常量:'W'键。
2945 pub const KEYCODE_W: i32 = 51;
2946
2947 /// 键码常量:'X'键。
2948 pub const KEYCODE_X: i32 = 52;
2949
2950 /// 键码常量:'Y'键。
2951 pub const KEYCODE_Y: i32 = 53;
2952
2953 /// 键码常量:'Z'键。
2954 pub const KEYCODE_Z: i32 = 54;
2955
2956 /// 键码常量:','键。
2957 pub const KEYCODE_COMMA: i32 = 55;
2958
2959 /// 键码常量:'.'键。
2960 pub const KEYCODE_PERIOD: i32 = 56;
2961
2962 /// 键码常量:左Alt修饰键。
2963 pub const KEYCODE_ALT_LEFT: i32 = 57;
2964
2965 /// 键码常量:右Alt修饰键。
2966 pub const KEYCODE_ALT_RIGHT: i32 = 58;
2967
2968 /// 键码常量:左Shift修饰键。
2969 pub const KEYCODE_SHIFT_LEFT: i32 = 59;
2970
2971 /// 键码常量:右Shift修饰键。
2972 pub const KEYCODE_SHIFT_RIGHT: i32 = 60;
2973
2974 /// 键码常量:Tab键。
2975 pub const KEYCODE_TAB: i32 = 61;
2976
2977 /// 键码常量:空格键。
2978 pub const KEYCODE_SPACE: i32 = 62;
2979
2980 /// 键码常量:符号修饰键。用于输入替代符号。
2981 pub const KEYCODE_SYM: i32 = 63;
2982
2983 /// 键码常量:资源管理器特殊功能键。用于启动浏览器应用程序。
2984 pub const KEYCODE_EXPLORER: i32 = 64;
2985
2986 /// 键码常量:信封特殊功能键。用于启动邮件应用程序。
2987 pub const KEYCODE_ENVELOPE: i32 = 65;
2988
2989 /// 键码常量:Enter键。
2990 pub const KEYCODE_ENTER: i32 = 66;
2991
2992 /// 键码常量:退格键。删除插入点前的字符,与KEYCODE_FORWARD_DEL不同。
2993 pub const KEYCODE_DEL: i32 = 67;
2994
2995 /// 键码常量:'`'(反引号)键。
2996 pub const KEYCODE_GRAVE: i32 = 68;
2997
2998 /// 键码常量:'-'。
2999 pub const KEYCODE_MINUS: i32 = 69;
3000
3001 /// 键码常量:'='键。
3002 pub const KEYCODE_EQUALS: i32 = 70;
3003
3004 /// 键码常量:'[' 键。
3005 pub const KEYCODE_LEFT_BRACKET: i32 = 71;
3006
3007 /// 键码常量:']'键。
3008 pub const KEYCODE_RIGHT_BRACKET: i32 = 72;
3009
3010 /// 键码常量:'\'键。
3011 pub const KEYCODE_BACKSLASH: i32 = 73;
3012
3013 /// 键码常量:';'键。
3014 pub const KEYCODE_SEMICOLON: i32 = 74;
3015
3016 /// 键码常量:'''(单引号)键。
3017 pub const KEYCODE_APOSTROPHE: i32 = 75;
3018
3019 /// 键码常量:'/'键。
3020 pub const KEYCODE_SLASH: i32 = 76;
3021
3022 /// 键码常量:'@'键。
3023 pub const KEYCODE_AT: i32 = 77;
3024
3025 /// 键码常量:数字修饰键。用于输入数字符号。这个键不是Num Lock;它更像是KEYCODE_ALT_LEFT,并被android.text.method.MetaKeyKeyListener解释为ALT键。
3026 pub const KEYCODE_NUM: i32 = 78;
3027
3028 //noinspection SpellCheckingInspection
3029 /// 键码常量:耳机钩键。用于挂断电话并停止媒体。
3030 pub const KEYCODE_HEADSETHOOK: i32 = 79;
3031
3032 /// 键码常量:相机对焦键。用于对焦相机。
3033 pub const KEYCODE_FOCUS: i32 = 80;
3034
3035 /// 键码常量:'+'键。
3036 pub const KEYCODE_PLUS: i32 = 81;
3037
3038 /// 键码常量:菜单键。
3039 pub const KEYCODE_MENU: i32 = 82;
3040
3041 /// 键码常量:通知键。
3042 pub const KEYCODE_NOTIFICATION: i32 = 83;
3043
3044 /// 键码常量:搜索键。
3045 pub const KEYCODE_SEARCH: i32 = 84;
3046
3047 /// 键码常量:媒体播放/暂停键。
3048 pub const KEYCODE_MEDIA_PLAY_PAUSE: i32 = 85;
3049
3050 /// 键码常量:媒体停止键。
3051 pub const KEYCODE_MEDIA_STOP: i32 = 86;
3052
3053 /// 键码常量:媒体播放下一曲键。
3054 pub const KEYCODE_MEDIA_NEXT: i32 = 87;
3055
3056 /// 键码常量:媒体播放上一曲键。
3057 pub const KEYCODE_MEDIA_PREVIOUS: i32 = 88;
3058
3059 /// 键码常量:媒体倒带键。
3060 pub const KEYCODE_MEDIA_REWIND: i32 = 89;
3061
3062 /// 键码常量:媒体快进键。
3063 pub const KEYCODE_MEDIA_FAST_FORWARD: i32 = 90;
3064
3065 /// 键码常量:静音键。用于麦克风的静音键(不同于KEYCODE_VOLUME_MUTE,那是扬声器静音键)。
3066 pub const KEYCODE_MUTE: i32 = 91;
3067
3068 /// 键码常量:Page Up键。
3069 pub const KEYCODE_PAGE_UP: i32 = 92;
3070
3071 /// 键码常量:Page Down键。
3072 pub const KEYCODE_PAGE_DOWN: i32 = 93;
3073
3074 //noinspection SpellCheckingInspection
3075 /// 键码常量:图片符号修饰键。用于切换符号集(表情符号、颜文字)。
3076 pub const KEYCODE_PICTSYMBOLS: i32 = 94;
3077
3078 //noinspection SpellCheckingInspection
3079 /// 切换符号集(表情符号、颜文字)
3080 /// 键码常量:切换字符集修饰键。用于切换字符集(汉字、片假名)。
3081 pub const KEYCODE_SWITCH_CHARSET: i32 = 95; // 切换字符集(汉字、片假名)
3082
3083 /// 键码常量:A按钮键。在游戏控制器上,A按钮应为标有A的按钮或控制器按钮底部行的第一个按钮。
3084 pub const KEYCODE_BUTTON_A: i32 = 96;
3085
3086 /// 键码常量:B按钮键。在游戏控制器上,B按钮应为标有B的按钮或控制器按钮底部行的第二个按钮。
3087 pub const KEYCODE_BUTTON_B: i32 = 97;
3088
3089 /// 键码常量:C按钮键。在游戏控制器上,C按钮应为标有C的按钮或控制器按钮底部行的第三个按钮。
3090 pub const KEYCODE_BUTTON_C: i32 = 98;
3091
3092 /// 键码常量:X按钮键。在游戏控制器上,X按钮应为标有X的按钮或控制器按钮顶部行的第一个按钮。
3093 pub const KEYCODE_BUTTON_X: i32 = 99;
3094
3095 /// 键码常量:Y按钮键。在游戏控制器上,Y按钮应为标有Y的按钮或控制器按钮顶部行的第二个按钮。
3096 pub const KEYCODE_BUTTON_Y: i32 = 100;
3097
3098 /// 键码常量:Z按钮键。在游戏控制器上,Z按钮应为标有Z的按钮或控制器按钮顶部行的第三个按钮。
3099 pub const KEYCODE_BUTTON_Z: i32 = 101;
3100
3101 /// 键码常量:L1按钮键。在游戏控制器上,L1按钮应为标有L1(或L)的按钮或左上角的触发器按钮。
3102 pub const KEYCODE_BUTTON_L1: i32 = 102;
3103
3104 /// 键码常量:R1按钮键。在游戏控制器上,R1按钮应为标有R1(或R)的按钮或右上角的触发器按钮。
3105 pub const KEYCODE_BUTTON_R1: i32 = 103;
3106
3107 /// 键码常量:L2按钮键。在游戏控制器上,L2按钮应为标有L2的按钮或左下角的触发器按钮。
3108 pub const KEYCODE_BUTTON_L2: i32 = 104;
3109
3110 //noinspection SpellCheckingInspection
3111 /// 键码常量:左拇指按钮键。在游戏控制器上,左拇指按钮表示按下左(或唯一)操纵杆。
3112 pub const KEYCODE_BUTTON_THUMBL: i32 = 106;
3113
3114 //noinspection SpellCheckingInspection
3115 /// 键码常量:右拇指按钮键。在游戏控制器上,右拇指按钮表示按下了右操纵杆。
3116 pub const KEYCODE_BUTTON_THUMBR: i32 = 107;
3117
3118 /// 键码常量:R2 按钮键。在游戏控制器上,R2 按钮应该是标有 R2 的按钮或右下角触发器按钮。
3119 pub const KEYCODE_BUTTON_R2: i32 = 105;
3120
3121 /// 键码常量:开始按钮键。在游戏控制器上,标有“开始”的按钮。
3122 pub const KEYCODE_BUTTON_START: i32 = 108;
3123
3124 /// 键码常量:选择按钮键。在游戏控制器上,标有“选择”的按钮。
3125 pub const KEYCODE_BUTTON_SELECT: i32 = 109;
3126
3127 /// 键码常量:模式按钮键。在游戏控制器上,标有“模式”的按钮。
3128 pub const KEYCODE_BUTTON_MODE: i32 = 110;
3129
3130 /// 键码常量:Esc 键。
3131 pub const KEYCODE_ESCAPE: i32 = 111;
3132
3133 /// 键码常量:向前删除键。与 KEYCODE_DEL 不同,它删除插入点前面的字符。
3134 pub const KEYCODE_FORWARD_DEL: i32 = 112;
3135
3136 /// 键码常量:左 Control 修饰键。
3137 pub const KEYCODE_CTRL_LEFT: i32 = 113;
3138
3139 /// 键码常量:右 Control 修饰键。
3140 pub const KEYCODE_CTRL_RIGHT: i32 = 114;
3141
3142 /// 键码常量:大写锁定键。
3143 pub const KEYCODE_CAPS_LOCK: i32 = 115;
3144
3145 /// 键码常量:滚动锁定键。
3146 pub const KEYCODE_SCROLL_LOCK: i32 = 116;
3147
3148 /// 键码常量:左 Meta 修饰键。
3149 pub const KEYCODE_META_LEFT: i32 = 117;
3150
3151 /// 键码常量:右 Meta 修饰键。
3152 pub const KEYCODE_META_RIGHT: i32 = 118;
3153
3154 /// 键码常量:功能修饰键。
3155 pub const KEYCODE_FUNCTION: i32 = 119;
3156
3157 //noinspection SpellCheckingInspection
3158 /// 键码常量:系统请求/打印屏幕键。
3159 pub const KEYCODE_SYSRQ: i32 = 120;
3160
3161 /// 键码常量:Break / Pause 键。
3162 pub const KEYCODE_BREAK: i32 = 121;
3163
3164 /// 键码常量:Home 移动键。用于滚动或移动光标到 行 的开始或列表的顶部。
3165 pub const KEYCODE_MOVE_HOME: i32 = 122;
3166
3167 /// 键码常量:End 移动键。用于滚动或移动光标到 行 的末尾或列表的底部。
3168 pub const KEYCODE_MOVE_END: i32 = 123;
3169
3170 /// 键码常量:Insert 键。切换插入/覆盖编辑模式。
3171 pub const KEYCODE_INSERT: i32 = 124;
3172
3173 /// 键码常量:前进键。在历史堆栈中向前导航。与 KEYCODE_BACK 互补。
3174 pub const KEYCODE_FORWARD: i32 = 125;
3175
3176 /// 键码常量:播放媒体键。
3177 pub const KEYCODE_MEDIA_PLAY: i32 = 126;
3178
3179 /// 键码常量:暂停媒体键。
3180 pub const KEYCODE_MEDIA_PAUSE: i32 = 127;
3181
3182 /// 键码常量:关闭媒体键。例如,可用于关闭 CD 托盘。
3183 pub const KEYCODE_MEDIA_CLOSE: i32 = 128;
3184
3185 /// 键码常量:弹出媒体键。例如,可用于弹出 CD 托盘。
3186 pub const KEYCODE_MEDIA_EJECT: i32 = 129;
3187
3188 /// 键码常量:录制媒体键。
3189 pub const KEYCODE_MEDIA_RECORD: i32 = 130;
3190
3191 /// 键码常量:F1 键。
3192 pub const KEYCODE_F1: i32 = 131;
3193
3194 /// 键码常量:F2 键。
3195 pub const KEYCODE_F2: i32 = 132;
3196
3197 /// 键码常量:F3 键。
3198 pub const KEYCODE_F3: i32 = 133;
3199
3200 /// 键码常量:F4 键。
3201 pub const KEYCODE_F4: i32 = 134;
3202
3203 /// 键码常量:F5 键。
3204 pub const KEYCODE_F5: i32 = 135;
3205
3206 /// 键码常量:F6 键。
3207 pub const KEYCODE_F6: i32 = 136;
3208
3209 /// 键码常量:F7 键。
3210 pub const KEYCODE_F7: i32 = 137;
3211
3212 /// 键码常量:F8 键。
3213 pub const KEYCODE_F8: i32 = 138;
3214
3215 /// 键码常量:F9 键。
3216 pub const KEYCODE_F9: i32 = 139;
3217
3218 /// 键码常量:F10 键。
3219 pub const KEYCODE_F10: i32 = 140;
3220
3221 /// 键码常量:F11 键。
3222 pub const KEYCODE_F11: i32 = 141;
3223
3224 /// 键码常量:数字键盘'('键
3225 pub const KEYCODE_NUMPAD_LEFT_PAREN: i32 = 162;
3226
3227 /// 键码常量:数字键盘')'键。
3228 pub const KEYCODE_NUMPAD_RIGHT_PAREN: i32 = 163;
3229
3230 /// 键码常量:F12 键。
3231 pub const KEYCODE_F12: i32 = 142;
3232
3233 /// 键码常量:Num Lock 键。这是 Num Lock 键,与 KEYCODE_NUM 不同。此键会改变数字键盘上其他键的行为。
3234 pub const KEYCODE_NUM_LOCK: i32 = 143;
3235
3236 /// 键码常量:数字键盘 '0' 键。
3237 pub const KEYCODE_NUMPAD_0: i32 = 144;
3238
3239 /// 键码常量:数字键盘 '1' 键。
3240 pub const KEYCODE_NUMPAD_1: i32 = 145;
3241
3242 /// 键码常量:数字键盘 '2' 键。
3243 pub const KEYCODE_NUMPAD_2: i32 = 146;
3244
3245 /// 键码常量:数字键盘 '3' 键。
3246 pub const KEYCODE_NUMPAD_3: i32 = 147;
3247
3248 /// 键码常量:数字键盘 '4' 键。
3249 pub const KEYCODE_NUMPAD_4: i32 = 148;
3250
3251 /// 键码常量:数字键盘 '5' 键。
3252 pub const KEYCODE_NUMPAD_5: i32 = 149;
3253
3254 /// 键码常量:数字键盘 '6' 键。
3255 pub const KEYCODE_NUMPAD_6: i32 = 150;
3256
3257 /// 键码常量:数字键盘 '7' 键。
3258 pub const KEYCODE_NUMPAD_7: i32 = 151;
3259
3260 /// 键码常量:数字键盘 '8' 键。
3261 pub const KEYCODE_NUMPAD_8: i32 = 152;
3262
3263 /// 键码常量:数字键盘 '9' 键。
3264 pub const KEYCODE_NUMPAD_9: i32 = 153;
3265
3266 /// 键码常量:数字键盘 '/' 键(用于除法)。
3267 pub const KEYCODE_NUMPAD_DIVIDE: i32 = 154;
3268
3269 /// 键码常量:数字键盘 '*' 键(用于乘法)。
3270 pub const KEYCODE_NUMPAD_MULTIPLY: i32 = 155;
3271
3272 /// 键码常量:数字键盘 '-' 键(用于减法)。
3273 pub const KEYCODE_NUMPAD_SUBTRACT: i32 = 156;
3274
3275 /// 键码常量:数字键盘 '+' 键(用于加法)。
3276 pub const KEYCODE_NUMPAD_ADD: i32 = 157;
3277
3278 /// 键码常量:数字键盘 '.' 键(用于小数或数字分组)。
3279 pub const KEYCODE_NUMPAD_DOT: i32 = 158;
3280
3281 /// 键码常量:数字键盘 ',' 键(用于小数或数字分组)。
3282 pub const KEYCODE_NUMPAD_COMMA: i32 = 159;
3283
3284 /// 键码常量:数字键盘 Enter 键。
3285 pub const KEYCODE_NUMPAD_ENTER: i32 = 160;
3286
3287 /// 键码常量:绿色“可编程”键。在电视遥控器上,用作上下文/可编程键。
3288 pub const KEYCODE_PROG_GREEN: i32 = 184;
3289
3290 /// 键码常量:数字键盘 '=' 键。
3291 pub const KEYCODE_NUMPAD_EQUALS: i32 = 161;
3292
3293 /// 键码常量:音量静音键。用于扬声器的静音键(与 KEYCODE_MUTE 不同,后者是麦克风的静音键)。此键通常应实现为切换键,即第一次按下时静音扬声器,第二次按下时恢复原始音量。
3294 pub const KEYCODE_VOLUME_MUTE: i32 = 164;
3295
3296 /// 键码常量:信息键。通常在电视遥控器上,用于显示与当前正在查看的内容相关的附加信息。
3297 pub const KEYCODE_INFO: i32 = 165;
3298
3299 /// 键码常量:频道上键。在电视遥控器上,用于增加电视频道。
3300 pub const KEYCODE_CHANNEL_UP: i32 = 166;
3301
3302 /// 键码常量:频道下键。在电视遥控器上,用于减少电视频道。
3303 pub const KEYCODE_CHANNEL_DOWN: i32 = 167;
3304
3305 /// 键码常量:放大键。
3306 pub const KEYCODE_ZOOM_IN: i32 = 168;
3307
3308 /// 键码常量:缩小键。
3309 pub const KEYCODE_ZOOM_OUT: i32 = 169;
3310
3311 /// 键码常量:电视键。在电视遥控器上,切换到观看直播电视。
3312 pub const KEYCODE_TV: i32 = 170;
3313
3314 /// 键码常量:窗口键。在电视遥控器上,切换画中画模式或其他窗口功能。在 Android Wear 设备上,触发显示偏移。
3315 pub const KEYCODE_WINDOW: i32 = 171;
3316
3317 /// 键码常量:指南键。在电视遥控器上,显示节目指南。
3318 pub const KEYCODE_GUIDE: i32 = 172;
3319
3320 /// 键码常量:DVR 键。在某些电视遥控器上,切换到录制的节目的 DVR 模式。
3321 pub const KEYCODE_DVR: i32 = 173;
3322
3323 /// 键码常量:书签键。在某些电视遥控器上,用于标记内容或网页为书签。
3324 pub const KEYCODE_BOOKMARK: i32 = 174;
3325
3326 /// 键码常量:切换字幕键。在电视节目期间,切换闭路字幕文本的模式。
3327 pub const KEYCODE_CAPTIONS: i32 = 175;
3328
3329 /// 键码常量:设置键。启动系统设置活动。
3330 pub const KEYCODE_SETTINGS: i32 = 176;
3331
3332 /// 键码常量:语言切换键。切换当前输入语言,例如在 QWERTY 键盘上切换英语和日语。在某些设备上,按 Shift+空格键可以执行相同的功能。
3333 pub const KEYCODE_LANGUAGE_SWITCH: i32 = 204;
3334
3335 /// 键码常量:电视电源键。在HDMI电视面板设备和不支持HDMI的Android TV设备上,切换设备的电源状态。在HDMI源设备上,通过HDMI-CEC切换HDMI连接电视的电源状态,并使源设备跟随此电源状态。
3336 pub const KEYCODE_TV_POWER: i32 = 177;
3337
3338 /// 键码常量:电视输入键。在电视遥控器上,在电视屏幕上切换输入。
3339 pub const KEYCODE_TV_INPUT: i32 = 178;
3340
3341 /// 键码常量:机顶盒电源键。在电视遥控器上,切换外部机顶盒的电源。
3342 pub const KEYCODE_STB_POWER: i32 = 179;
3343
3344 /// 键码常量:机顶盒输入键。在电视遥控器上,切换外部机顶盒的输入模式。
3345 pub const KEYCODE_STB_INPUT: i32 = 180;
3346
3347 /// 键码常量:A/V接收器电源键。在电视遥控器上,切换外部A/V接收器的电源。
3348 pub const KEYCODE_AVR_POWER: i32 = 181;
3349
3350 /// 键码常量:A/V接收器输入键。在电视遥控器上,切换外部A/V接收器的输入模式。
3351 pub const KEYCODE_AVR_INPUT: i32 = 182;
3352
3353 /// 键码常量:红色“可编程”键。在电视遥控器上,作为上下文/可编程键使用。
3354 pub const KEYCODE_PROG_RED: i32 = 183;
3355
3356 /// 键码常量:黄色“可编程”键。在电视遥控器上,作为上下文/可编程键使用。
3357 pub const KEYCODE_PROG_YELLOW: i32 = 185;
3358
3359 /// 键码常量:蓝色“可编程”键。在电视遥控器上,作为上下文/可编程键使用。
3360 pub const KEYCODE_PROG_BLUE: i32 = 186;
3361
3362 /// 键码常量:应用程序切换键。应该显示应用程序切换器对话框。
3363 pub const KEYCODE_APP_SWITCH: i32 = 187;
3364
3365 /// 键码常量:通用游戏板按钮#1。
3366 pub const KEYCODE_BUTTON_1: i32 = 188;
3367
3368 /// 键码常量:通用游戏板按钮#2。
3369 pub const KEYCODE_BUTTON_2: i32 = 189;
3370
3371 //noinspection SpellCheckingInspection
3372 /// 键码常量:日语全角/半角键。
3373 pub const KEYCODE_ZENKAKU_HANKAKU: i32 = 211;
3374
3375 //noinspection SpellCheckingInspection
3376 /// 键码常量:日语字母数字键。
3377 pub const KEYCODE_EISU: i32 = 212;
3378
3379 //noinspection SpellCheckingInspection
3380 /// 键码常量:日语非转换键。
3381 pub const KEYCODE_MUHENKAN: i32 = 213;
3382
3383 //noinspection SpellCheckingInspection
3384 /// 键码常量:日语转换键。
3385 pub const KEYCODE_HENKAN: i32 = 214;
3386
3387 /// 键码常量:通用游戏板按钮#3。
3388 pub const KEYCODE_BUTTON_3: i32 = 190;
3389
3390 /// 键码常量:通用游戏板按钮#4。
3391 pub const KEYCODE_BUTTON_4: i32 = 191;
3392
3393 /// 键码常量:通用游戏板按钮#5。
3394 pub const KEYCODE_BUTTON_5: i32 = 192;
3395
3396 /// 键码常量:通用游戏板按钮#6。
3397 pub const KEYCODE_BUTTON_6: i32 = 193;
3398
3399 /// 键码常量:通用游戏板按钮#7。
3400 pub const KEYCODE_BUTTON_7: i32 = 194;
3401
3402 /// 键码常量:通用游戏板按钮#8。
3403 pub const KEYCODE_BUTTON_8: i32 = 195;
3404
3405 /// 键码常量:通用游戏板按钮#9。
3406 pub const KEYCODE_BUTTON_9: i32 = 196;
3407
3408 /// 键码常量:通用游戏板按钮#10。
3409 pub const KEYCODE_BUTTON_10: i32 = 197;
3410
3411 /// 键码常量:通用游戏板按钮#11。
3412 pub const KEYCODE_BUTTON_11: i32 = 198;
3413
3414 /// 键码常量:通用游戏板按钮#12。
3415 pub const KEYCODE_BUTTON_12: i32 = 199;
3416
3417 /// 键码常量:通用游戏板按钮#13。
3418 pub const KEYCODE_BUTTON_13: i32 = 200;
3419
3420 /// 键码常量:通用游戏板按钮#14。
3421 pub const KEYCODE_BUTTON_14: i32 = 201;
3422
3423 /// 键码常量:通用游戏板按钮#15。
3424 pub const KEYCODE_BUTTON_15: i32 = 202;
3425
3426 /// 键码常量:通用游戏板按钮#16。
3427 pub const KEYCODE_BUTTON_16: i32 = 203;
3428
3429 /// 键码常量:礼仪模式键。在某些设置(如在拥挤的火车上)中,打开和关闭静音或振动模式,使设备表现得更加礼貌。在某些设备上,此键可能仅在长按时才有效。
3430 pub const KEYCODE_MANNER_MODE: i32 = 205;
3431
3432 /// 键码常量:3D模式键。在2D和3D模式之间切换显示。
3433 pub const KEYCODE_3D_MODE: i32 = 206;
3434
3435 /// 键码常量:联系人特殊功能键。用于启动地址簿应用程序。
3436 pub const KEYCODE_CONTACTS: i32 = 207;
3437
3438 /// 键码常量:日历特殊功能键。用于启动日历应用程序。
3439 pub const KEYCODE_CALENDAR: i32 = 208;
3440
3441 /// 键码常量:音轨键。切换音轨。
3442 pub const KEYCODE_MEDIA_AUDIO_TRACK: i32 = 222;
3443
3444 /// 键码常量:睡眠键。使设备进入睡眠状态。行为类似于 KEYCODE_POWER,但如果设备已处于睡眠状态,则不起作用。
3445 pub const KEYCODE_SLEEP: i32 = 223;
3446
3447 /// 键码常量:唤醒键。唤醒设备。行为有点类似于 KEYCODE_POWER,但如果设备已唤醒,则不起作用。
3448 pub const KEYCODE_WAKEUP: i32 = 224;
3449
3450 /// 键码常量:音乐特殊功能键。用于启动音乐播放器应用程序。
3451 pub const KEYCODE_MUSIC: i32 = 209;
3452
3453 /// 键码常量:计算器特殊功能键。用于启动计算器应用程序。
3454 pub const KEYCODE_CALCULATOR: i32 = 210;
3455
3456 /// 键码常量:日本假名/平假名键。
3457 pub const KEYCODE_KATAKANA_HIRAGANA: i32 = 215;
3458
3459 /// 键码常量:日本日元键。
3460 pub const KEYCODE_YEN: i32 = 216;
3461
3462 /// 键码常量:日本Ro键。
3463 pub const KEYCODE_RO: i32 = 217;
3464
3465 /// 键码常量:日本假名键。
3466 pub const KEYCODE_KANA: i32 = 218;
3467
3468 /// 键码常量:辅助键。启动全局辅助活动。不会传递给应用程序。
3469 pub const KEYCODE_ASSIST: i32 = 219;
3470
3471 /// 键码常量:亮度减小键。降低屏幕亮度。
3472 pub const KEYCODE_BRIGHTNESS_DOWN: i32 = 220;
3473
3474 /// 键码常量:亮度增大键。提高屏幕亮度。
3475 pub const KEYCODE_BRIGHTNESS_UP: i32 = 221;
3476
3477 /// 键码常量:配对键。启动外设配对模式。对于配对遥控器或游戏控制器特别有用,尤其是如果没有其他输入模式可用时。
3478 pub const KEYCODE_PAIRING: i32 = 225;
3479
3480 /// 键码常量:媒体顶层菜单键。跳转到媒体菜单的顶部。
3481 pub const KEYCODE_MEDIA_TOP_MENU: i32 = 226;
3482
3483 /// 键码常量:‘11’键。
3484 pub const KEYCODE_11: i32 = 227;
3485
3486 /// 键码常量:“12”键。
3487 pub const KEYCODE_12: i32 = 228;
3488
3489 /// 键码常量:上一个频道键。跳转到最后一个观看的频道。
3490 pub const KEYCODE_LAST_CHANNEL: i32 = 229;
3491
3492 /// 键码常量:电视数据服务键。显示数据服务,如天气、体育等。
3493 pub const KEYCODE_TV_DATA_SERVICE: i32 = 230;
3494
3495 /// 键码常量:语音助手键。启动全局语音助手活动。不会传递给应用程序。
3496 pub const KEYCODE_VOICE_ASSIST: i32 = 231;
3497
3498 /// 键码常量:收音机键。切换电视服务/收音机服务。
3499 pub const KEYCODE_TV_RADIO_SERVICE: i32 = 232;
3500
3501 /// 键码常量:电视图文键。显示电视图文服务。
3502 pub const KEYCODE_TV_TELETEXT: i32 = 233;
3503
3504 /// 键码常量:数字输入键。当每个数字键被分配用于选择单独的频道时,启动输入多位频道号。对应于 CEC 用户控制代码的数字输入模式 (0x1D)。
3505 pub const KEYCODE_TV_NUMBER_ENTRY: i32 = 234;
3506
3507 /// 键码常量:模拟地面广播键。切换到模拟地面广播服务。
3508 pub const KEYCODE_TV_TERRESTRIAL_ANALOG: i32 = 235;
3509
3510 /// 键码常量:数字地面广播键。切换到数字地面广播服务。
3511 pub const KEYCODE_TV_TERRESTRIAL_DIGITAL: i32 = 236;
3512
3513 /// 键码常量:卫星键。切换到数字卫星广播服务。
3514 pub const KEYCODE_TV_SATELLITE: i32 = 237;
3515
3516 /// 键码常量:BS键。切换到日本可用的BS数字卫星广播服务。
3517 pub const KEYCODE_TV_SATELLITE_BS: i32 = 238;
3518
3519 /// 键码常量:CS键。切换到日本可用的CS数字卫星广播服务。
3520 pub const KEYCODE_TV_SATELLITE_CS: i32 = 239;
3521
3522 /// 键码常量:BS/CS键。在BS和CS数字卫星服务之间切换。
3523 pub const KEYCODE_TV_SATELLITE_SERVICE: i32 = 240;
3524
3525 /// 键码常量:切换网络键。切换选择广播服务。
3526 pub const KEYCODE_TV_NETWORK: i32 = 241;
3527
3528 /// 键码常量:天线/电缆键。在天线和电缆之间切换广播输入源。
3529 pub const KEYCODE_TV_ANTENNA_CABLE: i32 = 242;
3530
3531 /// 键码常量:HDMI #1 键。切换到 HDMI 输入 #1。
3532 pub const KEYCODE_TV_INPUT_HDMI_1: i32 = 243;
3533
3534 /// 键码常量:HDMI #2 键。切换到 HDMI 输入 #2。
3535 pub const KEYCODE_TV_INPUT_HDMI_2: i32 = 244;
3536
3537 /// 键码常量:HDMI #3 键。切换到 HDMI 输入 #3。
3538 pub const KEYCODE_TV_INPUT_HDMI_3: i32 = 245;
3539
3540 /// 键码常量:HDMI #4 键。切换到 HDMI 输入 #4。
3541 pub const KEYCODE_TV_INPUT_HDMI_4: i32 = 246;
3542
3543 /// 键码常量:复合 #1 键。切换到复合视频输入 #1。
3544 pub const KEYCODE_TV_INPUT_COMPOSITE_1: i32 = 247;
3545
3546 /// 键码常量:复合 #2 键。切换到复合视频输入 #2。
3547 pub const KEYCODE_TV_INPUT_COMPOSITE_2: i32 = 248;
3548
3549 /// 键码常量:分量 #1 键。切换到分量视频输入 #1。
3550 pub const KEYCODE_TV_INPUT_COMPONENT_1: i32 = 249;
3551
3552 /// 键码常量:分量 #2 键。切换到分量视频输入 #2。
3553 pub const KEYCODE_TV_INPUT_COMPONENT_2: i32 = 250;
3554
3555 /// 键码常量:VGA #1 键。切换到 VGA(模拟 RGB)输入 #1。
3556 pub const KEYCODE_TV_INPUT_VGA_1: i32 = 251;
3557
3558 /// 键码常量:音频描述键。开启/关闭音频描述。
3559 pub const KEYCODE_TV_AUDIO_DESCRIPTION: i32 = 252;
3560
3561 /// 键码常量:音频描述混合音量调高键。与正常音频音量相比,增大音频描述音量。
3562 pub const KEYCODE_TV_AUDIO_DESCRIPTION_MIX_UP: i32 = 253;
3563
3564 /// 键码常量:音频描述混音音量减小键。与正常音频音量相比,降低音频描述音量。
3565 pub const KEYCODE_TV_AUDIO_DESCRIPTION_MIX_DOWN: i32 = 254;
3566
3567 /// 键码常量:缩放模式键。更改缩放模式(正常、全屏、缩放、宽缩放等)
3568 pub const KEYCODE_TV_ZOOM_MODE: i32 = 255;
3569
3570 /// 键码常量:内容菜单键。进入标题列表。对应于CEC用户控制代码的“内容菜单”(0x0B)
3571 pub const KEYCODE_TV_CONTENTS_MENU: i32 = 256;
3572
3573 /// 键码常量:媒体上下文菜单键。进入媒体内容的上下文菜单。对应于CEC用户控制代码的“媒体上下文相关菜单”(0x11)。
3574 pub const KEYCODE_TV_MEDIA_CONTEXT_MENU: i32 = 257;
3575
3576 /// 键码常量:定时器编程键。进入定时器录制菜单。对应于CEC用户控制代码的“定时器编程”(0x54)。
3577 pub const KEYCODE_TV_TIMER_PROGRAMMING: i32 = 258;
3578
3579 /// 键码常量:帮助键。
3580 pub const KEYCODE_HELP: i32 = 259;
3581
3582 /// 键码常量:导航到上一个键。在有序的项目集合中向后移动一个项目。
3583 pub const KEYCODE_NAVIGATE_PREVIOUS: i32 = 260;
3584
3585 /// 键码常量:导航到下一个键。在有序的项目集合中前进到下一个项目。
3586 pub const KEYCODE_NAVIGATE_NEXT: i32 = 261;
3587
3588 /// 键码常量:导航进入键。激活当前具有焦点的项目或展开到导航层级的下一个级别。
3589 pub const KEYCODE_NAVIGATE_IN: i32 = 262;
3590
3591 /// 键码常量:导航退出键。退出导航层级的一个级别或折叠当前具有焦点的项目。
3592 pub const KEYCODE_NAVIGATE_OUT: i32 = 263;
3593
3594 /// 键码常量:Wear手表上的主要电源/重置按钮的主要茎键。
3595 pub const KEYCODE_STEM_PRIMARY: i32 = 264;
3596
3597 /// 键码常量:Wear的通用茎键1
3598 pub const KEYCODE_STEM_1: i32 = 265;
3599
3600 //noinspection SpellCheckingInspection
3601 /// 键码常量:方向键向上-向左
3602 pub const KEYCODE_DPAD_UP_LEFT: i32 = 268;
3603
3604 //noinspection SpellCheckingInspection
3605 /// 键码常量:方向键向下向左
3606 pub const KEYCODE_DPAD_DOWN_LEFT: i32 = 269;
3607
3608 //noinspection SpellCheckingInspection
3609 /// 键码常量:方向键右上
3610 pub const KEYCODE_DPAD_UP_RIGHT: i32 = 270;
3611
3612 //noinspection SpellCheckingInspection
3613 /// 键码常量:方向键右下
3614 pub const KEYCODE_DPAD_DOWN_RIGHT: i32 = 271;
3615
3616 /// 键码常量:Wear 的通用茎键 2
3617 pub const KEYCODE_STEM_2: i32 = 266;
3618
3619 /// 键码常量:Wear 的通用茎键 3
3620 pub const KEYCODE_STEM_3: i32 = 267;
3621
3622 /// 键码常量:跳过向前的媒体键。
3623 pub const KEYCODE_MEDIA_SKIP_FORWARD: i32 = 272;
3624
3625 /// 键码常量:跳过向后的媒体键。
3626 pub const KEYCODE_MEDIA_SKIP_BACKWARD: i32 = 273;
3627
3628 /// 键码常量:逐帧向前媒体键。每次向前移动一帧媒体。
3629 pub const KEYCODE_MEDIA_STEP_FORWARD: i32 = 274;
3630
3631 /// 键码常量:逐帧向后媒体键。每次向后移动一帧媒体。
3632 pub const KEYCODE_MEDIA_STEP_BACKWARD: i32 = 275;
3633
3634 /// 键码常量:除非持有唤醒锁,否则使设备进入休眠状态。
3635 pub const KEYCODE_SOFT_SLEEP: i32 = 276;
3636
3637 /// 键码常量:剪切键。
3638 pub const KEYCODE_CUT: i32 = 277;
3639
3640 /// 键码常量:复制键。
3641 pub const KEYCODE_COPY: i32 = 278;
3642
3643 /// 键码常量:粘贴键。
3644 pub const KEYCODE_PASTE: i32 = 279;
3645
3646 /// 键码常量:由系统用于向上导航
3647 pub const KEYCODE_SYSTEM_NAVIGATION_UP: i32 = 280;
3648
3649 /// 键码常量:由系统用于向下导航
3650 pub const KEYCODE_SYSTEM_NAVIGATION_DOWN: i32 = 281;
3651
3652 /// 键码常量:由系统用于向左导航
3653 pub const KEYCODE_SYSTEM_NAVIGATION_LEFT: i32 = 282;
3654
3655 /// 键码常量:由系统用于向右导航
3656 pub const KEYCODE_SYSTEM_NAVIGATION_RIGHT: i32 = 283;
3657
3658 /// 键码常量:显示所有应用
3659 pub const KEYCODE_ALL_APPS: i32 = 284;
3660
3661 /// 键码常量:刷新键。
3662 pub const KEYCODE_REFRESH: i32 = 285;
3663
3664 /// 键码常量:点赞键。应用可以使用此键让用户对内容进行点赞。
3665 pub const KEYCODE_THUMBS_UP: i32 = 286;
3666
3667 /// 键码常量:反对键。应用可利用此功能让用户反对内容。
3668 pub const KEYCODE_THUMBS_DOWN: i32 = 287;
3669
3670 /// 键码常量:用于切换当前正在使用内容的 android.accounts.Account。系统可能会使用该代码来全局设置账户。
3671 pub const KEYCODE_PROFILE_SWITCH: i32 = 288;
3672
3673 /// 键码常量:视频应用键 #1。
3674 pub const KEYCODE_VIDEO_APP_1: i32 = 289;
3675
3676 /// 键码常量:视频应用键 #2。
3677 pub const KEYCODE_VIDEO_APP_2: i32 = 290;
3678
3679 /// 键码常量:视频应用键 #3。
3680 pub const KEYCODE_VIDEO_APP_3: i32 = 291;
3681
3682 /// 键码常量:视频应用键 #4。
3683 pub const KEYCODE_VIDEO_APP_4: i32 = 292;
3684
3685 /// 键码常量:视频应用键 #5。
3686 pub const KEYCODE_VIDEO_APP_5: i32 = 293;
3687
3688 /// 键码常量:视频应用键 #6。
3689 pub const KEYCODE_VIDEO_APP_6: i32 = 294;
3690
3691 /// 键码常量:视频应用键 #7。
3692 pub const KEYCODE_VIDEO_APP_7: i32 = 295;
3693
3694 /// 键码常量:视频应用键 #8。
3695 pub const KEYCODE_VIDEO_APP_8: i32 = 296;
3696
3697 /// 键码常量:特色应用键 #1。
3698 pub const KEYCODE_FEATURED_APP_1: i32 = 297;
3699
3700 /// 键码常量:特色应用键 #2。
3701 pub const KEYCODE_FEATURED_APP_2: i32 = 298;
3702
3703 /// 键码常量:特色应用键 #3。
3704 pub const KEYCODE_FEATURED_APP_3: i32 = 299;
3705
3706 /// 键码常量:特色应用键 #4。
3707 pub const KEYCODE_FEATURED_APP_4: i32 = 300;
3708
3709 /// 键码常量:演示应用键 #1。
3710 pub const KEYCODE_DEMO_APP_1: i32 = 301;
3711
3712 /// 键码常量:演示应用键 #2。
3713 pub const KEYCODE_DEMO_APP_2: i32 = 302;
3714
3715 /// 键码常量:演示应用键 #3。
3716 pub const KEYCODE_DEMO_APP_3: i32 = 303;
3717
3718 /// 键码常量:演示应用键 #4。
3719 pub const KEYCODE_DEMO_APP_4: i32 = 304;
3720
3721 /// 键码常量:键盘背光调暗
3722 pub const KEYCODE_KEYBOARD_BACKLIGHT_DOWN: i32 = 305;
3723
3724 /// 键码常量:键盘背光调亮
3725 pub const KEYCODE_KEYBOARD_BACKLIGHT_UP: i32 = 306;
3726
3727 /// 键码常量:键盘背光切换
3728 pub const KEYCODE_KEYBOARD_BACKLIGHT_TOGGLE: i32 = 307;
3729
3730 /// 键码常量:触控笔笔杆上的主要按钮。这通常是最靠近触控笔尖的按钮。
3731 pub const KEYCODE_STYLUS_BUTTON_PRIMARY: i32 = 308;
3732
3733 /// 键码常量:触控笔笔杆上的第二个按钮。这通常是从触控笔尖算起的第二个按钮。
3734 pub const KEYCODE_STYLUS_BUTTON_SECONDARY: i32 = 309;
3735
3736 /// 键码常量:触控笔笔杆上的第三个按钮。这通常是从触控笔尖开始的第三个按钮。
3737 pub const KEYCODE_STYLUS_BUTTON_TERTIARY: i32 = 310;
3738
3739 /// 键码常量:触控笔尾部的按钮。此按钮的使用通常与橡皮擦的功能无关。
3740 pub const KEYCODE_STYLUS_BUTTON_TAIL: i32 = 311;
3741
3742 /// 键码常量:打开最近使用的应用程序视图(又称概览)。此键由框架处理,永远不会传递给应用程序。
3743 pub const KEYCODE_RECENT_APPS: i32 = 312;
3744
3745 /// 键码常量:用户可以通过系统自定义其用途的按钮。用户可自定义键 #1。
3746 pub const KEYCODE_MACRO_1: i32 = 313;
3747
3748 /// 键码常量:用户可以通过系统自定义其用途的按钮。用户可自定义键 #2。
3749 pub const KEYCODE_MACRO_2: i32 = 314;
3750
3751 /// 键码常量:用户可以通过系统自定义其用途的按钮。用户可自定义键 #3。
3752 pub const KEYCODE_MACRO_3: i32 = 315;
3753
3754 /// 键码常量:用户可以通过系统自定义其用途的按钮。用户可自定义键 #4。
3755 pub const KEYCODE_MACRO_4: i32 = 316;
3756
3757 /// 最后一个 KEYCODE 的整数值。随着新的键码添加到 KeyEvent,该值会增加。
3758 pub const LAST_KEYCODE: i32 = Self::KEYCODE_MACRO_4;
3759
3760 #[doc(hidden)]
3761 #[deprecated(note = "现在键码数量已超过 MAX_KEYCODE。请使用 getMaxKeyCode()。")]
3762 pub const MAX_KEYCODE: i32 = 84;
3763
3764 /// getAction值:该键已被按下。
3765 pub const ACTION_DOWN: i32 = 0;
3766
3767 /// getAction 值:按键已被释放。
3768 pub const ACTION_UP: i32 = 1;
3769
3770 #[doc(hidden)]
3771 #[deprecated(
3772 note = "输入系统不再使用。getAction 值:连续发生多个重复按键事件,或者正在传递复杂字符串。如果按键代码不是 KEYCODE_UNKNOWN,则 getRepeatCount() 方法返回应执行给定按键代码的次数。否则,如果按键代码是 KEYCODE_UNKNOWN,则这是 getCharacters 返回的字符序列。"
3773 )]
3774 pub const ACTION_MULTIPLE: i32 = 2;
3775
3776 /// SHIFT 键在 CAPS 模式下锁定。保留供 MetaKeyKeyListener 用于其 API 中已发布的常量。
3777 pub const META_CAP_LOCKED: i32 = 0x100;
3778
3779 /// ALT 键已锁定。保留供 MetaKeyKeyListener 用于其 API 中已发布的常量。
3780 pub const META_ALT_LOCKED: i32 = 0x200;
3781
3782 /// SYM 键已锁定。保留供 MetaKeyKeyListener 用于其 API 中已发布的常量。
3783 pub const META_SYM_LOCKED: i32 = 0x400;
3784
3785 /// 文本处于选择模式。保留供 MetaKeyKeyListener 使用,用于其 API 中未发布的私有常量,目前由于遗留原因而保留。
3786 pub const META_SELECTING: i32 = 0x800;
3787
3788 /// 此掩码用于检查是否按下了 ALT 元键之一。
3789 pub const META_ALT_ON: i32 = 0x02;
3790
3791 /// 此掩码用于检查左边 ALT 元键是否被按下。
3792 pub const META_ALT_LEFT_ON: i32 = 0x10;
3793
3794 /// 此掩码用于检查是否按下了右边 ALT 元键。
3795 pub const META_ALT_RIGHT_ON: i32 = 0x20;
3796
3797 /// 此掩码用于检查是否按下了 SHIFT 元键之一。
3798 pub const META_SHIFT_ON: i32 = 0x1;
3799
3800 /// 此掩码用于检查左 SHIFT 元键是否被按下。
3801 pub const META_SHIFT_LEFT_ON: i32 = 0x40;
3802
3803 /// 此掩码用于检查是否按下了右 SHIFT 元键。
3804 pub const META_SHIFT_RIGHT_ON: i32 = 0x80;
3805
3806 /// 此掩码用于检查 SYM 元键是否被按下。
3807 pub const META_SYM_ON: i32 = 0x4;
3808
3809 /// 此掩码用于检查 FUNCTION 元键是否被按下。
3810 pub const META_FUNCTION_ON: i32 = 0x8;
3811
3812 /// 此掩码用于检查是否按下了 CTRL 元键之一。
3813 pub const META_CTRL_ON: i32 = 0x1000;
3814
3815 /// 此掩码用于检查左边 CTRL 元键是否被按下。
3816 pub const META_CTRL_LEFT_ON: i32 = 0x2000;
3817
3818 /// 此掩码用于检查是否按下了右边 CTRL 元键。
3819 pub const META_CTRL_RIGHT_ON: i32 = 0x4000;
3820
3821 /// 此掩码用于检查是否按下了 META 元键之一。
3822 pub const META_META_ON: i32 = 0x10000;
3823
3824 /// 该掩码用于检查左META键是否按下。
3825 pub const META_META_LEFT_ON: i32 = 0x20000;
3826
3827 /// 此掩码用于检查是否按下了正确的 META 元键。
3828 pub const META_META_RIGHT_ON: i32 = 0x40000;
3829
3830 /// 此掩码用于检查 CAPS LOCK 元键是否打开。
3831 pub const META_CAPS_LOCK_ON: i32 = 0x100000;
3832
3833 /// 此掩码用于检查 NUM LOCK 元键是否打开。
3834 pub const META_NUM_LOCK_ON: i32 = 0x200000;
3835
3836 /// 此掩码用于检查 SCROLL LOCK 元键是否打开。
3837 pub const META_SCROLL_LOCK_ON: i32 = 0x400000;
3838
3839 /// 此掩码是 META_SHIFT_ON、META_SHIFT_LEFT_ON 和 META_SHIFT_RIGHT_ON 的组合。
3840 pub const META_SHIFT_MASK: i32 =
3841 Self::META_SHIFT_ON | Self::META_SHIFT_LEFT_ON | Self::META_SHIFT_RIGHT_ON;
3842
3843 /// 此掩码是 META_ALT_ON、META_ALT_LEFT_ON 和 META_ALT_RIGHT_ON 的组合。
3844 pub const META_ALT_MASK: i32 =
3845 Self::META_ALT_ON | Self::META_ALT_LEFT_ON | Self::META_ALT_RIGHT_ON;
3846
3847 /// 此掩码是 META_CTRL_ON、META_CTRL_LEFT_ON 和 META_CTRL_RIGHT_ON 的组合。
3848 pub const META_CTRL_MASK: i32 =
3849 Self::META_CTRL_ON | Self::META_CTRL_LEFT_ON | Self::META_CTRL_RIGHT_ON;
3850
3851 /// 此掩码是 META_META_ON、META_META_LEFT_ON 和 META_META_RIGHT_ON 的组合。
3852 pub const META_META_MASK: i32 =
3853 Self::META_META_ON | Self::META_META_LEFT_ON | Self::META_META_RIGHT_ON;
3854
3855 /// 如果设备由于该键事件而被唤醒,则设置此掩码。
3856 #[deprecated(note = "由于系统本身会消耗所有唤醒键,因此系统永远不会设置此标志。")]
3857 pub const FLAG_WOKE_HERE: u32 = 0x1;
3858
3859 /// 如果键事件是由软件键盘生成的,则设置此掩码。
3860 pub const FLAG_SOFT_KEYBOARD: u32 = 0x2;
3861
3862 /// 如果我们不希望按键事件导致我们离开触摸模式,则设置此掩码。
3863 pub const FLAG_KEEP_TOUCH_MODE: u32 = 0x4;
3864
3865 /// 如果已知事件来自系统的可信部分,则设置此掩码。也就是说,已知事件来自用户,并且不可能被第三方组件欺骗。
3866 pub const FLAG_FROM_SYSTEM: u32 = 0x8;
3867
3868 /// 此掩码用于兼容性,以识别来自 IME 的输入键,该 IME 的输入键已自动标记为“下一个”或“完成”。这允许 TextView 将这些输入键作为旧应用程序的正常输入键进行分派,但在收到这些输入键时仍会执行适当的操作。
3869 pub const FLAG_EDITOR_ACTION: u32 = 0x10;
3870
3871 /// 当与向上键事件相关联时,这表示按键已被取消。这通常用于虚拟触摸屏按键,用户可以从虚拟按键区域滑动到显示屏上:在这种情况下,应用程序将收到已取消的向上事件,并且不应执行通常与按键相关联的操作。
3872 /// 请注意,要使此功能正常工作,应用程序在收到向上事件或长按超时已过期之前不能对按键执行操作。
3873 pub const FLAG_CANCELED: u32 = 0x20;
3874
3875 /// 此按键事件由虚拟(屏幕上)硬键区域生成。通常,这是触摸屏上常规显示屏之外的区域,专用于“硬件”按钮。
3876 pub const FLAG_VIRTUAL_HARD_KEY: u32 = 0x40;
3877
3878 /// 此标志是为长按超时后发生的第一次按键重复设置的。
3879 pub const FLAG_LONG_PRESS: u32 = 0x80;
3880
3881 /// 当按键事件因按下时执行长按动作而设置了 FLAG_CANCELED 时设置。
3882 pub const FLAG_CANCELED_LONG_PRESS: u32 = 0x100;
3883
3884 /// 当此事件的按键代码从其初始按下时仍在被跟踪时,设置为 ACTION_UP。也就是说,有人请求在按键按下时开始跟踪,并且长按不会导致跟踪被取消。
3885 pub const FLAG_TRACKING: u32 = 0x200;
3886
3887 /// 当合成按键事件以实现应用未处理的事件的默认行为时设置。后备按键事件由未处理的轨迹球运动(用于模拟方向键盘)和按键映射中声明的某些未处理的按键(例如,当 NumLock 关闭时的特殊功能数字键盘键)生成。
3888 pub const FLAG_FALLBACK: u32 = 0x400;
3889
3890 /// 此标志表示此事件由无障碍服务修改或生成。值 = 0x800
3891 pub const FLAG_IS_ACCESSIBILITY_EVENT: u32 = 0x800;
3892
3893 //noinspection SpellCheckingInspection
3894 /// 表示密钥正在被预先分派。
3895 pub const FLAG_PREDISPATCH: u32 = 0x20000000;
3896
3897 /// 私人控制,用于确定应用程序何时跟踪按键序列。
3898 pub const FLAG_START_TRACKING: u32 = 0x40000000;
3899
3900 /// 私有标志,指示系统何时检测到此按键事件可能与先前传送的按键事件的顺序不一致,例如,当发送了按键释放事件但按键并未按下时。
3901 pub const FLAG_TAINTED: u32 = 0x80000000;
3902
3903 /// 返回最大键码。
3904 #[java_method]
3905 pub fn get_max_key_code() -> i32 {}
3906
3907 /// 获取在字符 c 上添加重音后生成的字符。例如,getDeadChar('`', 'e') 返回 è。
3908 #[java_method]
3909 pub fn get_dead_char(accent: i32, c: i32) -> i32 {}
3910
3911 /**
3912 创建一个新的按键事件。
3913 `action` 操作代码:ACTION_DOWN、ACTION_UP 或 ACTION_MULTIPLE。
3914 `code` 按键代码。
3915 */
3916 #[java_constructor]
3917 pub fn new(action: i32, code: i32) -> Self {}
3918
3919 /**
3920 创建一个新的按键事件。
3921 `down_time` 此按键代码最初按下的时间(以 android.os.SystemClock.uptimeMillis 为单位)。
3922 `event_time` 此事件发生的时间(以 android.os.SystemClock.uptimeMillis 为单位)。
3923 `action` 操作代码:ACTION_DOWN、ACTION_UP 或 ACTION_MULTIPLE。
3924 `code` 按键代码。
3925 `repeat` 按下事件的重复计数(如果是在首次按下之后,则 > 0)或多个事件的事件计数。
3926 */
3927 #[java_constructor]
3928 pub fn new_with_time(
3929 down_time: i64,
3930 event_time: i64,
3931 action: i32,
3932 code: i32,
3933 repeat: i32,
3934 ) -> Self {
3935 }
3936
3937 /// 获取(可能回收的)按键事件。
3938 #[java_method]
3939 pub fn obtain(
3940 down_time: i64,
3941 event_time: i64,
3942 action: i32,
3943 code: i32,
3944 repeat: i32,
3945 meta_state: i32,
3946 device_id: i32,
3947 scan_code: i32,
3948 flags: u32,
3949 source: i32,
3950 display_id: i32,
3951 characters: String,
3952 ) -> Self {
3953 }
3954
3955 /// 获取另一个关键事件的副本(可能被回收)。
3956 #[java_method]
3957 pub fn obtain_other(other: &Self) -> Self {}
3958
3959 /**
3960 创建与给定事件相同的新按键事件,但其事件时间和重复次数将替换为给定值。
3961 `event` 要复制的现有事件。这不会被修改。
3962 `event_time` 事件的新事件时间(以 android.os.SystemClock.uptimeMillis 为单位)。
3963 `new_repeat` 事件的新重复次数。
3964 */
3965 #[java_method]
3966 pub fn change_time_repeat(event: &Self, event_time: i64, new_repeat: i32) -> Self {}
3967
3968 /**
3969 创建与给定事件相同的新键事件,但其事件时间和重复次数将替换为给定值。
3970 `event` 要复制的现有事件。这不会被修改。
3971 `event_time` 事件的新事件时间(以 android.os.SystemClock.uptimeMillis 为单位)。
3972 `new_repeat` 事件的新重复次数。
3973 `new_flags` 事件的新标志,替换原始事件中的整个值。
3974 */
3975 #[java_method]
3976 pub fn change_time_repeat_with_flags(
3977 event: &Self,
3978 event_time: i64,
3979 new_repeat: i32,
3980 new_flags: u32,
3981 ) -> Self {
3982 }
3983
3984 /**
3985 创建一个与给定事件相同的新键事件,但其操作将替换为给定值。
3986 `event` 要复制的现有事件。这不会被修改。
3987 `action` 事件的新操作代码。
3988 */
3989 #[java_method]
3990 pub fn change_action(event: &Self, action: i32) -> Self {}
3991
3992 /**
3993 创建一个与给定事件相同的新键事件,但其标志将被替换为给定值。
3994 `event` 要复制的现有事件。这不会被修改。
3995 `flags` 新的标志常量。
3996 */
3997 #[java_method]
3998 pub fn change_flags(event: &Self, flags: u32) -> Self {}
3999
4000 /**
4001 返回:如果操作是 ACTION_DOWN,则返回 true;否则返回 false。
4002 */
4003 #[deprecated(note = "不要在新代码中使用,而是明确检查 getAction()。")]
4004 #[java_method]
4005 pub fn is_down(&self) -> bool {}
4006
4007 /**
4008 这是系统键吗?系统键不能用作菜单快捷键。
4009 */
4010 #[java_method]
4011 pub fn is_system(&self) -> bool {}
4012
4013 #[doc(hidden)]
4014 #[java_method(overload = isWakeKey)]
4015 pub fn is_wake(&self) -> bool {}
4016
4017 /**
4018 如果指定的键码是游戏手柄按钮,则返回 true。
4019 返回:如果键码是游戏手柄按钮(例如 KEYCODE_BUTTON_A),则返回 True。
4020 */
4021 #[java_method]
4022 pub fn is_gamepad_button(key_code: i32) -> bool {}
4023
4024 /**
4025 默认情况下,按键是否会触发对焦点视图的点击。
4026 */
4027 #[java_method]
4028 pub fn is_confirm_key(key_code: i32) -> bool {}
4029
4030 /**
4031 返回此键是否将被发送到android.media.session.MediaSession。若未处理则回调。
4032 */
4033 #[java_method]
4034 pub fn is_media_session_key(key_code: i32) -> bool {}
4035
4036 /// 这是系统键吗?系统键不能用作菜单快捷键。
4037 #[java_method]
4038 pub fn is_system_key(key_code: i32) -> bool {}
4039
4040 #[doc(hidden)]
4041 #[java_method]
4042 pub fn is_wake_key(key_code: i32) -> bool {}
4043
4044 #[doc(hidden)]
4045 #[java_method]
4046 pub fn is_meta_key(key_code: i32) -> bool {}
4047
4048 #[doc(hidden)]
4049 #[java_method]
4050 pub fn is_alt_key(key_code: i32) -> bool {}
4051
4052 #[doc(hidden)]
4053 #[java_method]
4054 pub fn get_device_id(&self) -> i32 {}
4055
4056 #[doc(hidden)]
4057 #[java_method]
4058 pub fn get_source(&self) -> i32 {}
4059
4060 #[doc(hidden)]
4061 #[java_method]
4062 pub fn set_source(&self, source: i32) {}
4063
4064 #[doc(hidden)]
4065 #[java_method]
4066 pub fn get_display_id(&self) -> i32 {}
4067
4068 #[doc(hidden)]
4069 #[java_method]
4070 pub fn set_display_id(&self, display_id: i32) {}
4071
4072 /// 返回元键的状态。
4073 /// 返回:一个整数,其中每个设置为 1 的位代表按下的元键
4074 #[java_method]
4075 pub fn get_meta_state(&self) -> i32 {}
4076
4077 /**
4078 返回修饰键的状态。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,此函数专门屏蔽了 META_CAPS_LOCK_ON、META_SCROLL_LOCK_ON 和 META_NUM_LOCK_ON。返回的值由使用 normalizeMetaState(int) 规范化的元状态(来自 getMetaState)组成,然后使用 getModifierMetaStateMask 进行屏蔽,以便仅保留有效的修饰位。
4079 返回:一个整数,其中设置为 1 的每个位代表按下的修饰键。
4080 */
4081 #[java_method]
4082 pub fn get_modifiers(&self) -> i32 {}
4083
4084 /**
4085 修改事件的标志。
4086 `new_flags` 事件的新标志,替换整个值。
4087 */
4088 #[java_method]
4089 pub fn set_flags(&self, new_flags: u32) {}
4090
4091 /**
4092 返回此键事件的标志。
4093 */
4094 #[java_method]
4095 pub fn get_flags(&self) -> i32 {}
4096
4097 /// 获取包含所有有效修饰键元状态位的掩码。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,掩码明确排除 META_CAPS_LOCK_ON、META_SCROLL_LOCK_ON 和 META_NUM_LOCK_ON。
4098 /// 返回:修饰键元状态掩码,它是 META_SHIFT_ON、META_SHIFT_LEFT_ON、META_SHIFT_RIGHT_ON、META_ALT_ON、META_ALT_LEFT_ON、META_ALT_RIGHT_ON、META_CTRL_ON、META_CTRL_LEFT_ON、META_CTRL_RIGHT_ON、META_META_ON、META_META_LEFT_ON、META_META_RIGHT_ON、META_SYM_ON、META_FUNCTION_ON 的组合。
4099 #[java_method]
4100 pub fn get_modifier_meta_state_mask() -> i32 {}
4101
4102 /**
4103 如果此键码是修饰键,则返回 true。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,此函数对这些键返回 false。
4104 返回:如果键码是 KEYCODE_SHIFT_LEFT、KEYCODE_SHIFT_RIGHT、KEYCODE_ALT_LEFT、KEYCODE_ALT_RIGHT、KEYCODE_CTRL_LEFT、KEYCODE_CTRL_RIGHT、KEYCODE_META_LEFT 或 KEYCODE_META_RIGHT、KEYCODE_SYM、KEYCODE_NUM、KEYCODE_FUNCTION 之一,则返回 True。
4105 */
4106 #[java_method]
4107 pub fn is_modifier_key(key_code: i32) -> bool {}
4108
4109 /**
4110 规范化指定的元状态。元状态被规范化,这样如果设置了左或右修饰符元状态位,则结果还将包括该修饰符的通用位。如果指定的元状态包含 META_ALT_LEFT_ON,则结果除了 META_ALT_LEFT_ON 和输入中指定的其他位之外,还将包含 META_ALT_ON。
4111 对 shift、control 和 meta 执行相同的过程。如果指定的元状态包含 MetaKeyKeyListener 定义的合成元状态,则这些状态将在此处转换,并从结果中删除原始合成元状态。MetaKeyKeyListener.META_CAP_LOCKED 转换为 META_CAPS_LOCK_ON。MetaKeyKeyListener.META_ALT_LOCKED 转换为 META_ALT_ON。MetaKeyKeyListener.META_SYM_LOCKED 转换为 META_SYM_ON。未定义的元状态位被删除。
4112 返回:规范化的元状态。
4113 `meta_state` 元状态。
4114 */
4115 #[java_method]
4116 pub fn normalize_meta_state(meta_state: i32) -> i32 {}
4117
4118 /**
4119 如果根据指定的元状态未按下任何修饰键,则返回 true。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,此函数忽略 META_CAPS_LOCK_ON、META_SCROLL_LOCK_ON 和 META_NUM_LOCK_ON。使用 normalizeMetaState(int) 比较之前,元状态已标准化。
4120 返回:如果没有按下任何修饰键,则返回 True。
4121 `meta_state` 要考虑的元状态。
4122 */
4123 #[java_method]
4124 pub fn meta_state_has_no_modifiers(meta_state: i32) -> bool {}
4125
4126 /**
4127 如果根据指定的元状态仅按下了指定的修饰键,则返回 true。如果按下了不同的修饰键组合,则返回 false。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,此函数忽略 META_CAPS_LOCK_ON、META_SCROLL_LOCK_ON 和 META_NUM_LOCK_ON。
4128 如果指定的修饰符掩码包括方向修饰符(例如 META_SHIFT_LEFT_ON),则此方法可确保在该侧按下修饰符。如果指定的修饰符掩码包括非方向修饰符(例如 META_SHIFT_ON),则此方法可确保在任一侧按下修饰符。如果指定的修饰符掩码包含同一类型键的方向和非方向修饰符,例如 META_SHIFT_ON 和 META_SHIFT_LEFT_ON,则此方法将抛出非法参数异常。
4129 返回:如果仅按下了指定的修饰键,则返回 True。
4130 抛出:IllegalArgumentException – 如果 modifiers 参数包含无效修饰符
4131 `meta_state` 要考虑的元状态。
4132 `modifiers` 要检查的修饰键的元状态。可能是 getModifierMetaStateMask() 定义的修饰符元状态的组合。可以为 0,以确保没有按下修饰键。
4133 */
4134 #[java_method]
4135 pub fn meta_state_has_modifiers(meta_state: i32, modifiers: i32) -> Result<bool> {}
4136
4137 /**
4138 如果没有按下修饰键,则返回 true。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,此函数忽略 META_CAPS_LOCK_ON、META_SCROLL_LOCK_ON 和 META_NUM_LOCK_ON。
4139 使用 normalizeMetaState(int) 进行比较之前,元状态已标准化。
4140 返回:如果没有按下修饰键,则返回 True。
4141 */
4142 #[java_method]
4143 pub fn has_no_modifiers(&self) -> bool {}
4144
4145 /**
4146 如果仅按下了指定的修饰键,则返回 true。如果按下了不同的修饰键组合,则返回 false。就此函数而言,KEYCODE_CAPS_LOCK、KEYCODE_SCROLL_LOCK 和 KEYCODE_NUM_LOCK 不被视为修饰键。因此,此函数忽略 META_CAPS_LOCK_ON、META_SCROLL_LOCK_ON 和 META_NUM_LOCK_ON。
4147 如果指定的修饰符掩码包括方向修饰符(例如 META_SHIFT_LEFT_ON),则此方法可确保在该侧按下修饰符。如果指定的修饰符掩码包括非方向修饰符(例如 META_SHIFT_ON),则此方法可确保在任一侧按下修饰符。如果指定的修饰符掩码包括同一类型键的方向修饰符和非方向修饰符(例如 META_SHIFT_ON 和 META_SHIFT_LEFT_ON),则此方法将引发非法参数异常。
4148 返回:如果仅按下了指定的修饰键,则为 True。
4149 抛出:IllegalArgumentException – 如果 modifiers 参数包含无效修饰键
4150 `modifiers` 要检查的修饰键的元状态。可能是 getModifierMetaStateMask() 定义的修饰键元状态的组合。可能为 0,以确保未按下任何修饰键。
4151 */
4152 #[java_method]
4153 pub fn has_modifiers(&self, modifiers: i32) -> Result<bool> {}
4154
4155 /**
4156 返回 ALT 元键的按下状态。如果按下了 ALT 键,则返回 true,否则返回 false
4157 */
4158 #[java_method]
4159 pub fn is_alt_pressed(&self) -> bool {}
4160
4161 /**
4162 返回 SHIFT 元键的按下状态。如果按下了 SHIFT 键,则返回 true,否则返回 false
4163 */
4164 #[java_method]
4165 pub fn is_shift_pressed(&self) -> bool {}
4166
4167 /**
4168 返回 SYM 元键的按下状态。
4169 返回:如果 SYM 键被按下,则返回 true,否则返回 false
4170 */
4171 #[java_method]
4172 pub fn is_sym_pressed(&self) -> bool {}
4173
4174 /**
4175 返回 CTRL 元键的按下状态。如果按下了 CTRL 键,则返回 true,否则返回 false
4176 */
4177 #[java_method]
4178 pub fn is_ctrl_pressed(&self) -> bool {}
4179
4180 /**
4181 返回 META 元键的按下状态。如果按下 META 键则返回 true,否则返回 false
4182 */
4183 #[java_method]
4184 pub fn is_meta_pressed(&self) -> bool {}
4185
4186 /**
4187 返回 FUNCTION 元键的按下状态。如果 FUNCTION 键被按下,则返回 true,否则返回 false
4188 */
4189 #[java_method]
4190 pub fn is_function_pressed(&self) -> bool {}
4191
4192 /**
4193 返回 CAPS LOCK 元键的锁定状态。如果 CAPS LOCK 键处于打开状态,则返回 true,否则返回 false
4194 */
4195 #[java_method]
4196 pub fn is_caps_lock_on(&self) -> bool {}
4197
4198 /**
4199 返回 SCROLL LOCK 元键的锁定状态。如果 SCROLL LOCK 键处于打开状态,则返回 true,否则返回 false
4200 */
4201 #[java_method]
4202 pub fn is_num_lock_on(&self) -> bool {}
4203
4204 /**
4205 查询此按键事件的操作。可能是 ACTION_DOWN、ACTION_UP 或 ACTION_MULTIPLE。
4206 返回:事件操作:ACTION_DOWN、ACTION_UP 或 ACTION_MULTIPLE。
4207 */
4208 #[java_method]
4209 pub fn get_action(&self) -> i32 {}
4210
4211 /// 对于 ACTION_UP 事件,表示事件已根据 FLAG_CANCELED 取消。
4212 #[java_method]
4213 pub fn is_canceled(&self) -> bool {}
4214
4215 /**
4216 为按键事件设置 FLAG_CANCELED 标志。
4217 */
4218 #[java_method]
4219 pub fn cancel(&self) {}
4220
4221 /// 在 KeyEvent.Callback.onKeyDown 期间调用此方法,让系统跟踪按键直至其最后按下(可能包括长按)。请注意,一次只能跟踪一个按键 - 如果在跟踪前一个按键时收到另一个按键按下事件,则跟踪前一个事件时会停止。
4222 #[java_method]
4223 pub fn start_tracking(&self) {}
4224
4225 /**
4226 对于 ACTION_UP 事件,表示该事件仍按照 FLAG_TRACKING 从其初始向下事件进行跟踪。
4227 */
4228 #[java_method]
4229 pub fn is_tracking(&self) -> bool {}
4230
4231 /// 对于 ACTION_DOWN 事件,表示该事件已根据 FLAG_LONG_PRESS 取消。
4232 #[java_method]
4233 pub fn is_long_press(&self) -> bool {}
4234
4235 /// 检索按键事件的按键代码。这是按下的物理按键,而不是 Unicode 字符。
4236 /// 返回:事件的按键代码。
4237 #[java_method]
4238 pub fn get_key_code(&self) -> i32 {}
4239
4240 /// 对于 ACTION_MULTIPLE 事件(其键代码为 KEYCODE_UNKNOWN)的特殊情况,这是与该事件关联的原始字符串。在所有其他情况下,它为空。
4241 /// 返回:返回与该事件关联的 1 个或多个字符的字符串。
4242 #[deprecated(note = "不再由输入系统使用。")]
4243 #[java_method]
4244 pub fn get_characters(&self) -> Option<String> {}
4245
4246 /// 查询此按键事件的硬件按键 ID。这些值不可靠,且因设备而异。@more 主要用于调试目的。
4247 #[java_method]
4248 pub fn get_scan_code(&self) -> i32 {}
4249
4250 /// 查询事件的重复计数。对于按键按下事件,这是按键重复的次数,第一次按下从 0 开始,然后从那里开始计数。对于按键弹起事件,此值始终等于零。对于多个按键事件,这是发生的按下/弹起对的数量。
4251 /// 返回:按键重复的次数。
4252 #[java_method]
4253 pub fn get_repeat_count(&self) -> i32 {}
4254
4255 /**
4256 修改事件的按下时间和事件时间。
4257 `down_time` 事件的新按下时间(以 android.os.SystemClock.uptimeMillis 为单位)。
4258 `event_time` 事件的新事件时间(以 android.os.SystemClock.uptimeMillis 为单位)。
4259 */
4260 #[java_method]
4261 pub fn set_time(down_time: i64, event_time: i64) {}
4262
4263 /**
4264 查询最近一次按键按下事件的时间,以 android.os.SystemClock.uptimeMillis 时间为基准。如果这是按下事件,则此方法与 getEventTime() 相同。
4265 请注意,当按下按键时,此值是最近按下的按键的按下时间,该按键可能不是此事件的同一物理按键。
4266 返回:返回最近一次按键按下时间,以 android.os.SystemClock.uptimeMillis 时间为基准
4267 */
4268 #[java_method]
4269 pub fn get_down_time(&self) -> i64 {}
4270
4271 /**
4272 以 android.os.SystemClock.uptimeMillis 时间基准检索此事件发生的时间。
4273 返回:以 android.os.SystemClock.uptimeMillis 时间基准返回此事件发生的时间。
4274 */
4275 #[java_method]
4276 pub fn get_event_time(&self) -> i64 {}
4277
4278 /**
4279 查询此事件发生的时间,以 android.os.SystemClock.uptimeMillis 时间为基础,但精度为纳秒(而不是毫秒)。该值以纳秒为精度,但可能不具有纳秒的精度。
4280 返回:返回此事件发生的时间,以 android.os.SystemClock.uptimeMillis 时间为基础,但精度为纳秒(而不是毫秒)。
4281 */
4282 #[java_method]
4283 pub fn get_event_time_nanos(&self) -> i64 {}
4284
4285 /**
4286 已重命名为 getDeviceId。
4287 */
4288 #[deprecated(note = "请改用 getDeviceId()。")]
4289 #[java_method]
4290 pub fn get_keyboard_device(&self) -> i32 {}
4291
4292 /**
4293 获取此键的主要字符。换句话说,就是实际打印在其上的标签。
4294 返回:显示标签字符,如果没有则返回 0(例如,对于非打印键)。
4295 */
4296 #[java_method]
4297 pub fn get_display_label(&self) -> char {}
4298
4299 /**
4300 获取由指定键和元键状态组合生成的 Unicode 字符。返回当指定元位(参见 MetaKeyKeyListener)处于活动状态时,指定键将生成的 Unicode 字符。
4301 如果该键不是用于键入 Unicode 字符的键,则返回 0。如果返回值已设置位 KeyCharacterMap.COMBINING_ACCENT,则该键是“死键”,在使用 KeyCharacterMap.COMBINING_ACCENT_MASK 进行屏蔽后,应将其与另一个键组合以实际生成字符(参见 KeyCharacterMap.getDeadChar)。
4302 返回:相关字符或组合重音符,如果没有,则返回 0。
4303 */
4304 #[java_method]
4305 pub fn get_unicode_char(&self) -> i32 {}
4306
4307 /**
4308 获取由指定键和元键状态组合生成的 Unicode 字符。返回当指定元位(参见 MetaKeyKeyListener)处于活动状态时,指定键将生成的 Unicode 字符。如果该键不是用于键入 Unicode 字符的键,则返回 0。
4309 如果返回值已设置 KeyCharacterMap.COMBINING_ACCENT 位,则该键是“死键”,在使用 KeyCharacterMap.COMBINING_ACCENT_MASK 屏蔽后,应与另一个键组合以实际生成字符(参见 KeyCharacterMap.getDeadChar)。
4310 返回:相关字符或组合重音符,如果没有,则返回 0。
4311 `meta_state` 元键修饰符状态。
4312 */
4313 #[java_method(overload=getUnicodeChar)]
4314 pub fn get_unicode_char_from(meta_state: i32) -> i32 {}
4315
4316 /**
4317 获取与该键关联的数字或符号。返回的是字符值,而不是数值。如果该键不是数字,而是符号,则返回该符号。
4318 此方法旨在支持键盘上的拨号盘和其他数字或符号输入,其中某些键兼具字母和符号键的功能。此方法返回与该键关联的数字或符号,与用户是否按下了所需的修饰键无关。
4319 例如,在一个特定的键盘上,按下 ALT 时,QWERTY 顶部行上的键会生成数字,因此 ALT-Q 会映射到“1”。因此,对于该键盘,当使用 KEYCODE_Q 调用 getNumber 时,它会返回“1”,以便用户可以在有意义时不按 ALT 来输入数字。
4320 返回:关联的数字或符号字符,如果没有,则返回 0。
4321 */
4322 #[java_method]
4323 pub fn get_number(&self) -> char {}
4324
4325 /**
4326 如果此键产生字形,则返回 true。
4327 如果此键是打印键,则返回 true。
4328 */
4329 #[java_method]
4330 pub fn is_printing_key(&self) -> bool {}
4331
4332 /**
4333 返回表示指定操作的符号名称的字符串,例如“ACTION_DOWN”,如果未知,则返回等效的数字常量,例如“35”。
4334 返回:指定操作的符号名称。
4335 `action` 操作。
4336 */
4337 #[java_method]
4338 pub fn action_to_string(action: i32) -> String {}
4339
4340 //noinspection SpellCheckingInspection
4341 /**
4342 返回表示指定键码的符号名称的字符串,例如“KEYCODE_A”、“KEYCODE_DPAD_UP”或等效数字常量(如“1001”(如果未知)。
4343 此函数主要用于调试、日志记录和测试。它不特定于语言环境,也不旨在以面向用户的方式使用。
4344 返回:指定键码的符号名称。
4345 `key_code` 键码。
4346 */
4347 #[java_method]
4348 pub fn key_code_to_string(key_code: i32) -> String {}
4349
4350 /**
4351 通过其符号名称(例如“KEYCODE_A”)或等效数字常量(例如“29”)获取键码。对于符号名称,从 Build.VERSION_CODES.Q 开始,前缀“KEYCODE_”是可选的。
4352 返回:键码,如果未找到,则返回 KEYCODE_UNKNOWN。
4353 `symbolic_name` 键码的符号名称。
4354 */
4355 #[java_method]
4356 pub fn key_code_from_string(symbolic_name: String) -> i32 {}
4357
4358 /**
4359 返回一个字符串,该字符串表示指定的组合元键修饰符状态标志的符号名称,例如“0”、“META_SHIFT_ON”、“META_ALT_ON|META_SHIFT_ON”或等效数字常量,例如“0x10000000”(如果未知)。
4360 返回:指定的组合元状态标志的符号名称。
4361 `meta_state` 元状态。
4362 */
4363 #[java_method]
4364 pub fn meta_state_to_string(meta_state: i32) -> String {}
4365}
4366
4367/// 当视图被点击并保持时调用的回调的接口定义。
4368#[allow(non_camel_case_types)]
4369#[java_interface(name = "android/view/View$OnLongClickListener")]
4370pub trait View_OnLongClickListener {
4371 /**
4372 当单击并按住某个视图时调用。
4373 返回:如果回调消耗了长按,则返回 true,否则返回 false。
4374 `v` 被单击并按住的视图。
4375 */
4376 fn on_long_click(&self, v: View) -> bool;
4377}
4378
4379#[doc(hidden)]
4380#[allow(non_camel_case_types)]
4381#[java_class(name = "android/view/View$OnLongClickListenerImpl")]
4382pub struct View_OnLongClickListenerImpl(Box<dyn Fn(View) -> bool + Send + Sync>);
4383
4384impl Default for View_OnLongClickListenerImplDefault {
4385 fn default() -> Self {
4386 Self(Box::new(|v| unimplemented!("{:?}", v)))
4387 }
4388}
4389
4390#[java_implement]
4391impl View_OnLongClickListener for View_OnLongClickListenerImpl {
4392 fn on_long_click(&self, v: View) -> bool {
4393 self.0(v)
4394 }
4395}
4396
4397/**
4398当硬件按键事件被分派到此视图时,要调用的回调的接口定义。回调将在按键事件被提供给视图之前被调用。
4399这仅适用于硬件键盘;软件输入法没有义务触发此侦听器。
4400*/
4401#[allow(non_camel_case_types)]
4402#[java_interface(name = "android/view/View$OnKeyListener")]
4403pub trait View_OnKeyListener {
4404 /**
4405 当硬件按键被分派到视图时调用。这允许侦听器有机会在目标视图之前做出响应。软件键盘中的按键通常不会触发此方法,尽管有些情况下可能会选择这样做。
4406 不要假设软件输入法必须基于按键;即使如此,它也可能以不同于您预期的方式使用按键,因此无法可靠地捕获软输入按键。
4407 返回:如果侦听器已使用事件,则返回 True,否则返回 false。
4408 `v` 按键被分派到的视图。
4409 `key_code` 按下的物理按键的代码
4410 `event` 包含有关事件的完整信息的 KeyEvent 对象。
4411 */
4412 fn on_key(&self, v: View, key_code: i32, event: KeyEvent) -> bool;
4413}
4414
4415#[doc(hidden)]
4416#[allow(non_camel_case_types)]
4417#[java_class(name = "android/widget/TextView$OnEditorActionListenerImpl")]
4418pub struct View_OnKeyListenerImpl(Box<dyn Fn(View, i32, KeyEvent) -> bool + Send + Sync>);
4419
4420impl Default for View_OnKeyListenerImplDefault {
4421 fn default() -> Self {
4422 Self(Box::new(|v, key_code, event| {
4423 unimplemented!("{:?}, {}, {:?}", v, key_code, event)
4424 }))
4425 }
4426}
4427
4428impl View_OnKeyListenerImpl {
4429 pub fn from_fn(
4430 func: impl Fn(/* v */ View, /* key_code */ i32, /* event */ KeyEvent) -> bool
4431 + Send
4432 + Sync
4433 + 'static,
4434 ) -> Result<Arc<Self>> {
4435 Self::new(View_OnKeyListenerImplDefault(Box::new(func)))
4436 }
4437}
4438
4439#[java_implement]
4440impl View_OnKeyListener for View_OnKeyListenerImpl {
4441 fn on_key(&self, v: View, key_code: i32, event: KeyEvent) -> bool {
4442 self.0(v, key_code, event)
4443 }
4444}
4445
4446/**
4447顶级窗口外观和行为策略的抽象基类。该类的实例应用于添加到窗口管理器的顶级视图。
4448它提供标准 UI 策略,例如背景、标题区域、默认按键处理等。框架将代表应用程序实例化该类的实现。
4449*/
4450#[java_class(name = "android/view/Window")]
4451pub struct Window;
4452
4453impl Window {
4454 /// 标记“选项面板”功能。默认情况下启用此功能。
4455 pub const FEATURE_OPTIONS_PANEL: i32 = 0;
4456
4457 /// 标记为“无标题”功能,关闭屏幕顶部的标题。
4458 pub const FEATURE_NO_TITLE: i32 = 1;
4459
4460 /// 进度指示器功能的标志。
4461 #[deprecated(note = "从 API 21 开始不再支持。")]
4462 pub const FEATURE_PROGRESS: i32 = 2;
4463
4464 /// 标记在标题栏左侧有一个图标
4465 pub const FEATURE_LEFT_ICON: i32 = 3;
4466
4467 /// 标记在标题栏右侧有图标
4468 pub const FEATURE_RIGHT_ICON: i32 = 4;
4469
4470 /// 标记不确定的进度。
4471 #[deprecated(note = "从 API 21 开始不再支持。")]
4472 pub const FEATURE_INDETERMINATE_PROGRESS: i32 = 5;
4473
4474 /// 上下文菜单的标志。默认情况下启用该标志。
4475 pub const FEATURE_CONTEXT_MENU: i32 = 6;
4476
4477 /// 标记自定义标题。您不能将此功能与其他标题功能结合使用。
4478 pub const FEATURE_CUSTOM_TITLE: i32 = 7;
4479
4480 /// 用于启用操作栏的标志。某些设备默认启用该功能。操作栏取代了标题栏,并为某些设备上的屏幕菜单按钮提供了备用位置。
4481 pub const FEATURE_ACTION_BAR: i32 = 8;
4482
4483 /**
4484 用于请求覆盖窗口内容的操作栏的标志。通常,操作栏将位于窗口内容上方的空间中,但如果此功能与 FEATURE_ACTION_BAR 一起请求,它将覆盖在窗口内容本身上。如果您希望应用能够更好地控制操作栏的显示方式,例如让应用内容在具有透明背景的操作栏下方滚动,或者在应用内容上方显示透明/半透明的操作栏,这将非常有用。
4485 此模式与 View#SYSTEM_UI_FLAG_FULLSCREEN View.SYSTEM_UI_FLAG_FULLSCREEN 特别有用,它允许您结合其他屏幕装饰无缝隐藏操作栏。
4486 从 android.os.Build.VERSION_CODES#JELLY_BEAN 开始,当 ActionBar 处于此模式时,它将调整提供给 View#fitSystemWindows(android.graphics.Rect) View.fitSystemWindows(Rect) 的插入图以包含操作栏覆盖的内容,因此您可以在该空间内进行布局。
4487 */
4488 pub const FEATURE_ACTION_BAR_OVERLAY: i32 = 9;
4489
4490 /// 用于指定操作栏不存在时操作模式行为的标志。如果启用了覆盖,则允许操作模式 UI 覆盖现有窗口内容。
4491 pub const FEATURE_ACTION_MODE_OVERLAY: i32 = 10;
4492
4493 /// 标记用于请求无装饰窗口,该窗口可通过从左侧滑动来关闭。
4494 #[deprecated(note = "滑动关闭功能不再起作用。")]
4495 pub const FEATURE_SWIPE_TO_DISMISS: i32 = 11;
4496
4497 /**
4498 请求窗口内容更改的标志应使用 TransitionManager 进行动画处理。
4499 TransitionManager 使用 setTransitionManager(android.transition.TransitionManager) 设置。如果没有设置,则使用默认的 TransitionManager。
4500 */
4501 pub const FEATURE_CONTENT_TRANSITIONS: i32 = 12;
4502
4503 /// 通过发送或接收使用 android.app.ActivityOptions#makeSceneTransitionAnimation(android.app.Activity, android.util.Pair[]) 或 android.app.ActivityOptions#makeSceneTransitionAnimation(android.app.Activity, View, String) 创建的 ActivityOptions 包,使活动能够运行活动转换。
4504 pub const FEATURE_ACTIVITY_TRANSITIONS: i32 = 13;
4505
4506 /// 最大值用作功能ID
4507 pub const FEATURE_MAX: i32 = Self::FEATURE_ACTIVITY_TRANSITIONS;
4508
4509 /// 将进度条的可见性设置为 VISIBLE 的标志。
4510 #[deprecated(note = "从API 21开始,不再支持feature_progress和相关方法。")]
4511 pub const PROGRESS_VISIBILITY_ON: i32 = -1;
4512
4513 /// 将进度条的可见性设置为 GONE 的标志。
4514 #[deprecated(note = "从API 21开始,不再支持feature_progress和相关方法。")]
4515 pub const PROGRESS_VISIBILITY_OFF: i32 = -2;
4516
4517 /// 用于设置进度条不确定模式的标志。
4518 #[deprecated(note = "从 API 21 开始不再支持 FEATURE_INDETERMINATE_PROGRESS 和相关方法。")]
4519 pub const PROGRESS_INDETERMINATE_ON: i32 = -3;
4520
4521 /// 用于关闭进度条不确定模式的标志。
4522 #[deprecated(note = "从 API 21 开始不再支持 FEATURE_INDETERMINATE_PROGRESS 和相关方法。")]
4523 pub const PROGRESS_INDETERMINATE_OFF: i32 = -4;
4524
4525 /// (主要) 进度的起始值。
4526 #[deprecated(note = "从 API 21 开始不再支持 FEATURE_PROGRESS 和相关方法。")]
4527 pub const PROGRESS_START: i32 = 0;
4528
4529 /// (主要) 进度的结束值。
4530 #[deprecated(note = "从 API 21 开始不再支持 FEATURE_PROGRESS 和相关方法。")]
4531 pub const PROGRESS_END: i32 = 10000;
4532
4533 /// 次要进度的最低可能值。
4534 #[deprecated(note = "从 API 21 开始不再支持 FEATURE_PROGRESS 和相关方法。")]
4535 pub const PROGRESS_SECONDARY_START: i32 = 20000;
4536
4537 /// 次要进度的最高可能值。
4538 #[deprecated(note = "从 API 21 开始不再支持 FEATURE_PROGRESS 和相关方法。")]
4539 pub const PROGRESS_SECONDARY_END: i32 = 30000;
4540
4541 /// 使用自定义背景时状态栏背景视图的 transitionName。
4542 pub const STATUS_BAR_BACKGROUND_TRANSITION_NAME: &'static str = "android:status:background";
4543
4544 /// 使用自定义背景时导航栏背景视图的 transitionName。
4545 pub const NAVIGATION_BAR_BACKGROUND_TRANSITION_NAME: &'static str =
4546 "android:navigation:background";
4547
4548 /// 标志以允许主题驱动窗口字幕控件的颜色。与setDecorCaptionShade(int)一起使用。这是默认值。
4549 pub const DECOR_CAPTION_SHADE_AUTO: i32 = 0;
4550
4551 /// 用于在窗口标题上设置浅色控件的标志。与 setDecorCaptionShade(int) 一起使用。
4552 pub const DECOR_CAPTION_SHADE_LIGHT: i32 = 1;
4553
4554 /// 用于在窗口标题上设置深色控件的标志。与 setDecorCaptionShade(int) 一起使用。
4555 pub const DECOR_CAPTION_SHADE_DARK: i32 = 2;
4556
4557 #[doc(hidden)]
4558 #[java_constructor]
4559 pub fn new(context: &Context) -> Self {}
4560
4561 /**
4562 返回此窗口策略正在运行的上下文,用于检索资源和其他信息。
4563 返回:上下文提供给构造函数的上下文。
4564 */
4565 #[java_method]
4566 pub fn get_context(&self) -> Context {}
4567
4568 /**
4569 设置此窗口的容器。如果未设置,DecorWindow 将作为顶级窗口运行;否则,它将与容器协商以适当地显示自身。
4570 `container` 所需的容器窗口。
4571 */
4572 #[java_method]
4573 pub fn set_container(&self, container: Self) {}
4574
4575 /**
4576 返回此窗口的容器。
4577 返回:窗口包含的窗口,如果这是顶级窗口,则返回 null。
4578 */
4579 #[java_method]
4580 pub fn get_container(&self) -> Self {}
4581
4582 #[doc(hidden)]
4583 #[java_method]
4584 pub fn has_children(&self) -> bool {}
4585
4586 #[doc(hidden)]
4587 #[java_method]
4588 pub fn destroy(&self) {}
4589
4590 #[doc(hidden)]
4591 #[java_method]
4592 pub fn is_destroyed(&self) -> bool {}
4593
4594 /**
4595 返回允许此窗口显示其自己的窗口的窗口管理器。
4596 返回:WindowManager ViewManager。
4597 */
4598 #[java_method]
4599 pub fn get_window_manager<WM: WindowManager>(&self) -> WM {}
4600
4601 #[doc(hidden)]
4602 #[java_method]
4603 pub fn dispatch_on_window_dismissed(
4604 &self,
4605 finish_task: bool,
4606 suppress_window_transition: bool,
4607 ) {
4608 }
4609
4610 #[doc(hidden)]
4611 #[java_method]
4612 pub fn dispatch_on_window_swipe_dismissed(&self) {}
4613
4614 #[doc(hidden)]
4615 #[java_method]
4616 pub fn get_system_bar_appearance(&self) -> i32 {}
4617
4618 #[doc(hidden)]
4619 #[java_method]
4620 pub fn dispatch_on_system_bar_appearance_changed(&self, appearance: i32) {}
4621
4622 #[doc(hidden)]
4623 #[java_method]
4624 pub fn on_draw_legacy_navigation_bar_background_changed(
4625 &self,
4626 draw_legacy_navigation_bar_background: bool,
4627 ) -> bool {
4628 }
4629
4630 /**
4631 防止非系统覆盖窗口绘制在此窗口之上。
4632 `hide` 是否应隐藏非系统覆盖窗口。
4633 */
4634 #[java_method]
4635 pub fn set_hide_overlay_windows(&self, hide: bool) {}
4636
4637 /**
4638 返回此窗口是否以浮动样式显示(基于样式/主题中的 android.R.attr.windowIsFloating 属性)。
4639 返回:如果窗口配置为浮动显示在它后面的任何内容之上,则返回 true。
4640 */
4641 #[java_method]
4642 pub fn is_floating(&self) -> bool {}
4643
4644 /**
4645 设置窗口的宽度和高度布局参数。这两个参数的默认值均为 MATCH_PARENT;您可以将其更改为 WRAP_CONTENT 或绝对值,以使窗口不全屏显示。
4646 `width` 所需的窗口布局宽度。
4647 `height` 所需的窗口布局高度。
4648 */
4649 #[java_method]
4650 pub fn set_layout(&self, width: i32, height: i32) {}
4651
4652 /**
4653 根据重力常数设置窗口的重力。这控制窗口管理器在整个窗口中的定位方式;它仅在使用 WRAP_CONTENT 作为布局宽度或高度时有用。
4654 `gravity` 所需的重力常数。
4655 */
4656 #[java_method]
4657 pub fn set_gravity(&self, gravity: i32) {}
4658
4659 /**
4660 根据 WindowManager.LayoutParams 类型设置窗口的类型。
4661 `type` 新的窗口类型(参见 WindowManager.LayoutParams)。
4662 */
4663 #[java_method]
4664 pub fn set_type(&self, r#type: i32) {}
4665
4666 /**
4667 根据 PixelFormat 类型设置窗口的格式。这将覆盖窗口根据其窗口装饰选择的默认格式。
4668 `format` 新的窗口格式(参见 PixelFormat)。使用 PixelFormat。UNKNOWN 允许窗口选择格式。
4669 */
4670 #[java_method]
4671 pub fn set_format(&self, format: i32) {}
4672
4673 /**
4674 根据 WindowManager.LayoutParams.windowAnimations 指定要用于窗口的自定义动画。此处提供除 0 之外的任何值都将覆盖窗口通常从其主题中检索的动画。
4675 */
4676 #[java_method]
4677 pub fn set_window_animations(&self, res_id: i32) {}
4678
4679 /**
4680 根据 WindowManager.LayoutParams.softInputMode 为窗口指定一个显式软输入模式。在此处提供除“未指定”之外的任何内容都将覆盖窗口通常从其主题中检索的输入模式。
4681 */
4682 #[java_method]
4683 pub fn set_soft_input_mode(&self, mode: i32) {}
4684
4685 /**
4686 按照 setFlags 的说明,使用便捷函数设置 flags 中指定的标志位。
4687 `flags` 要设置的标志位。
4688 */
4689 #[java_method]
4690 pub fn add_flags(&self, flags: i32) {}
4691
4692 /**
4693 添加私有标志位。请参阅各个标志以了解所需的权限。
4694 `flags` 要添加的标志位。
4695 */
4696 #[java_method]
4697 pub fn add_private_flags(&self, flags: i32) {}
4698
4699 /**
4700 添加系统标志位。请参阅各个标志以了解所需的权限。
4701 注意:仅适用于可更新的系统组件(又称主线模块)
4702 `flags` 要添加的标志位。
4703 */
4704 #[java_method]
4705 pub fn add_system_flags(&self, flags: i32) {}
4706
4707 /**
4708 根据 WindowManager.LayoutParams 标志设置窗口的标志。
4709 请注意,在创建窗口装饰之前必须设置一些标志(通过第一次调用 setContentView(View, ViewGroup.LayoutParams) 或 getDecorView():WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN 和 WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR。
4710 这些将根据 android.R.attr.windowIsFloating 属性为您设置。
4711 `flags` 新的窗口标志(请参阅 WindowManager.LayoutParams)。
4712 `mask` 要修改的窗口标志位。
4713 */
4714 #[java_method]
4715 pub fn set_flags(&self, flags: i32, mask: i32) {}
4716
4717 /**
4718 设置窗口的请求颜色模式。请求的颜色模式可能会覆盖窗口的像素格式。
4719 请求的颜色模式必须是 ActivityInfo.COLOR_MODE_DEFAULT、ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT 或 ActivityInfo.COLOR_MODE_HDR 之一。
4720 请求的颜色模式不保证一定会被遵守。有关更多信息,请参阅 getColorMode()。
4721 */
4722 #[java_method]
4723 pub fn set_color_mode(&self, color_mode: i32) {}
4724
4725 /**
4726 如果 is_preferred 为 true,则此方法要求当此窗口在屏幕上可见时,连接的显示器进行最少的后期处理。否则,它要求显示器切换回标准图像处理。
4727 默认情况下,显示器不进行最少的后期处理,如果需要,则不应使用此方法。
4728 当低延迟比图像增强处理具有更高的优先级时(例如,对于游戏或视频会议),应将其与 is_preferred=true 一起使用。
4729 当屏幕上不再显示请求最少后期处理的窗口时,显示器将自动返回到标准图像处理模式。如果之前已为此窗口调用 setPreferMinimalPostProcessing(true) 并且不再需要最少的后期处理,则可以使用 setPreferMinimalPostProcessing(false)。
4730 如果显示器接收器通过 HDMI 连接,设备将开始发送启用了自动低延迟模式和游戏内容类型的信息帧。这会将连接的显示器切换到最小图像处理模式(如果可用),从而减少延迟,改善游戏或视频会议应用程序的用户体验。
4731 有关更多信息,请参阅 HDMI 2.1 规范。如果显示接收器具有内部连接或使用 HDMI 以外的其他协议,效果可能类似但由实现定义。
4732 可以通过系统设置菜单中的用户设置禁用切换到具有最少后期处理模式的功能。在这种情况下,此方法不执行任何操作。
4733 `is_preferred` 指示此窗口是否优先使用最少后期处理(is_preferred=true)或不优先使用(is_preferred=false)。
4734 */
4735 #[java_method]
4736 pub fn set_prefer_minimal_post_processing(&self, is_preferred: bool) {}
4737
4738 /**
4739 返回窗口所请求的颜色模式,可以是 ActivityInfo.COLOR_MODE_DEFAULT、ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT 或 ActivityInfo.COLOR_MODE_HDR 之一。
4740 如果请求的是 ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT,则窗口可能不会处于广色域模式,具体取决于设备和显示器对该模式的支持。使用 isWideColorGamut 确定窗口当前是否处于广色域模式。
4741 */
4742 #[java_method]
4743 pub fn get_color_mode(&self) -> i32 {}
4744
4745 /**
4746 如果此窗口的颜色模式为 ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT、显示器具有宽色域且此设备支持宽色域渲染,则返回 true。
4747 */
4748 #[java_method]
4749 pub fn is_wide_color_gamut(&self) -> bool {}
4750
4751 /**
4752 使用 WindowManager.LayoutParams.FLAG_DIM_BEHIND 时设置窗口后面的暗淡量。这将覆盖窗口根据其主题选择的默认暗淡量。
4753 `amount` 新的暗淡量,从 0(无暗淡)到 1(完全暗淡)。
4754 */
4755 #[java_method]
4756 pub fn set_dim_amount(&self, amount: f32) {}
4757
4758 /**
4759 设置装饰视图是否应适合 WindowInsets 的根级内容视图。如果设置为 true,框架将检查现已弃用的 View.SYSTEM_UI_LAYOUT_FLAGS 以及 WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE 标志,并根据这些标志调整内容。
4760 如果设置为 false,框架将不会将内容视图调整到插图中,而只会将 WindowInsets 传递到内容视图。
4761 `decor_fits_system_windows` 装饰视图是否应适合插图的根级内容视图。
4762 */
4763 #[java_method]
4764 pub fn set_decor_fits_system_windows(&self, decor_fits_system_windows: bool) {}
4765
4766 #[doc(hidden)]
4767 #[java_method]
4768 pub fn decor_fits_system_windows(&self) -> bool {}
4769
4770 /**
4771 指定自定义窗口属性。请注意:您在此处提供的布局参数通常应来自之前使用 getAttributes() 检索的值;您可能不想盲目地创建和应用自己的值,因为这会抹去框架设置的任何您不感兴趣的值。
4772 `a` 新的窗口属性,它将完全覆盖任何当前值。
4773 */
4774 #[java_method]
4775 pub fn set_attributes(&self, a: &WindowManager_LayoutParams) {}
4776
4777 /**
4778 查询与此面板关联的当前窗口属性。
4779 返回:WindowManager.LayoutParams 要么是现有的窗口属性对象,要么是新创建的对象(如果没有)。
4780 */
4781 #[java_method]
4782 pub fn get_attributes(&self) -> WindowManager_LayoutParams {}
4783
4784 #[doc(hidden)]
4785 #[java_method]
4786 pub fn set_close_on_touch_outside(&self, close: bool) {}
4787
4788 #[doc(hidden)]
4789 #[java_method]
4790 pub fn set_close_on_touch_outside_if_not_set(&self, close: bool) {}
4791
4792 #[doc(hidden)]
4793 #[java_method]
4794 pub fn always_read_close_on_touch_attr(&self) {}
4795
4796 /**
4797 设置调用窗口的持续性能要求。
4798 `enable` 禁用或启用该模式。
4799 */
4800 #[java_method]
4801 pub fn set_sustained_performance_mode(&self, enable: bool) {}
4802
4803 /**
4804 启用扩展屏幕功能。必须在setContentView()之前调用。只要在setContentView()之前,就可以根据需要多次调用。
4805 如果未调用,则不会提供扩展功能。一旦要求,您就无法关闭功能。您可以使用feature_custom_title使用其他标题功能。
4806 返回:现在设置的功能。
4807 `feature_id` 所需的功能,定义为Window的常数。
4808 */
4809 #[java_method]
4810 pub fn request_feature(&self, feature_id: i32) -> bool {}
4811
4812 #[doc(hidden)]
4813 #[java_method]
4814 pub fn make_active(&self) {}
4815
4816 #[doc(hidden)]
4817 #[java_method]
4818 pub fn is_active(&self) -> bool {}
4819
4820 /**
4821 查找由 android.app.Activity.onCreate 中处理的 android:id XML 属性标识的视图。这将隐式调用 getDecorView 并产生所有相关副作用。
4822 注意:在大多数情况下(取决于编译器支持情况),结果视图会自动转换为目标类类型。如果目标类类型不受约束,则可能需要显式转换。
4823 返回:如果找到,则返回具有给定 ID 的视图,否则返回 null
4824 `id` 要搜索的 ID
4825 */
4826 #[java_method]
4827 pub fn find_view_by_id(&self, id: i32) -> Option<View> {}
4828
4829 /**
4830 查找由 android.app.Activity.onCreate 中处理的 android:id XML 属性标识的视图,如果 ID 无效或层次结构中没有匹配的视图,则抛出 IllegalArgumentException。
4831 注意:在大多数情况下 - 取决于编译器支持 - 生成的视图会自动转换为目标类类型。如果目标类类型不受约束,则可能需要显式转换。
4832 `id` 要搜索的 ID 返回:具有给定 ID 的视图。
4833 */
4834 #[java_method]
4835 pub fn require_view_by_id(&self, id: i32) -> Result<View> {}
4836
4837 /**
4838 方便使用 setContentView(View, ViewGroup.LayoutParams) 将屏幕内容设置为显式视图。此视图直接放置在屏幕的视图层次结构中。它本身可以是一个复杂的视图层次结构。
4839 `layout_res_id` 要显示的内容视图资源ID。
4840 */
4841 #[java_method(overload = setContentView)]
4842 pub fn set_content_view_by_id(&self, layout_res_id: i32) {}
4843
4844 /**
4845 方便使用 setContentView(View, ViewGroup.LayoutParams) 将屏幕内容设置为显式视图。此视图直接放入屏幕的视图层次结构中。它本身可以是一个复杂的视图层次结构。
4846 `view` 要显示的所需内容。
4847 */
4848 #[java_method(overload = setContentView)]
4849 pub fn set_content_view_convenience(&self, view: &View) {}
4850
4851 /**
4852 将屏幕内容设置为显式视图。此视图直接放入屏幕的视图层次结构中。它本身可以是一个复杂的视图层次结构。
4853 请注意,调用此函数会“锁定”窗口的各种特性,从此时起,这些特性将无法更改:使用 requestFeature(int) 请求的功能,以及 setFlags(int, int) 中描述的某些窗口标志。如果设置了 FEATURE_CONTENT_TRANSITIONS,则将使用窗口的 TransitionManager 将内容从当前内容视图动画化为视图。
4854 `view` 需要显示的内容。
4855 `params` 视图的布局参数。
4856 */
4857 #[java_method]
4858 pub fn set_content_view(&self, view: &View, params: &ViewGroup_LayoutParams) {}
4859
4860 /**
4861 setContentView(View, ViewGroup.LayoutParams) 的变体,用于向屏幕添加额外的内容视图。在屏幕中任何现有视图之后添加 - 现有视图不会被删除。
4862 `view` 要显示的内容。
4863 `params` 视图的布局参数。
4864 */
4865 #[java_method]
4866 pub fn add_content_view(&self, view: &View, params: &ViewGroup_LayoutParams) {}
4867
4868 /// 删除用作屏幕内容的视图。
4869 #[java_method]
4870 pub fn clear_content_view(&self) {}
4871
4872 /**
4873 返回此窗口中当前具有焦点的视图,如果没有,则返回 null。
4874 请注意,这不会在任何包含窗口中查找。
4875 返回:View 具有焦点的当前视图或 null。
4876 */
4877 #[java_method]
4878 pub fn get_current_focus(&self) -> Option<View> {}
4879
4880 #[doc(hidden)]
4881 #[java_method]
4882 pub fn set_title<CS: CharSequence>(&self, title: Option<CS>) {}
4883
4884 #[doc(hidden)]
4885 #[java_method]
4886 pub fn set_title_color(&self, text_color: i32) {}
4887
4888 #[doc(hidden)]
4889 #[java_method]
4890 pub fn open_panel(&self, feature_id: i32, event: &KeyEvent) {}
4891
4892 #[doc(hidden)]
4893 #[java_method]
4894 pub fn close_panel(&self, feature_id: i32) {}
4895
4896 #[doc(hidden)]
4897 #[java_method]
4898 pub fn toggle_panel(&self, feature_id: i32, event: &KeyEvent) {}
4899
4900 #[doc(hidden)]
4901 #[java_method]
4902 pub fn invalidate_panel_menu(&self, feature_id: i32) {}
4903
4904 #[doc(hidden)]
4905 #[java_method]
4906 pub fn perform_panel_shortcut(
4907 &self,
4908 feature_id: i32,
4909 key_code: i32,
4910 event: &KeyEvent,
4911 flags: i32,
4912 ) -> bool {
4913 }
4914
4915 #[doc(hidden)]
4916 #[java_method]
4917 pub fn perform_panel_identifier_action(&self, feature_id: i32, id: i32, flags: i32) -> bool {}
4918
4919 #[doc(hidden)]
4920 #[java_method]
4921 pub fn close_all_panels(&self) {}
4922
4923 #[doc(hidden)]
4924 #[java_method]
4925 pub fn perform_context_menu_identifier_action(&self, id: i32, flags: i32) -> bool {}
4926
4927 /**
4928 设置窗口高度。对此属性的更改会立即生效,并将导致重新创建窗口表面。
4929 这是一项昂贵的操作,因此不应对此属性进行动画处理。
4930 `elevation` 窗口高度。
4931 */
4932 #[java_method]
4933 pub fn set_elevation(&self, elevation: f32) {}
4934
4935 /**
4936 获取窗口高度。
4937 */
4938 #[java_method]
4939 pub fn get_elevation(&self) -> f32 {}
4940
4941 /**
4942 设置是否应将窗口内容剪裁到窗口背景的轮廓。
4943 `clip_to_outline` 是否应将窗口内容剪裁到窗口背景的轮廓。
4944 */
4945 #[java_method]
4946 pub fn set_clip_to_outline(&self, clip_to_outline: bool) {}
4947
4948 /**
4949 将此窗口的背景更改为可绘制资源。将背景设置为 null 将使窗口不透明。要使窗口透明,您可以使用空的 可绘制资源(例如颜色为 0 的 ColorDrawable 或系统可绘制资源 android:drawable/empty。)
4950 `res_id` 将作为新背景安装的可绘制资源的资源标识符。
4951 */
4952 #[java_method]
4953 pub fn set_background_drawable_resource(&self, res_id: i32) {}
4954
4955 /**
4956 在窗口边界内模糊窗口后面的屏幕。模糊的密度由模糊半径设置。半径定义邻近区域的大小,从中对像素进行平均以形成每个像素的最终颜色。
4957 该操作近似于高斯模糊。半径为 0 表示无模糊。半径越大,模糊越密集。
4958 窗口背景可绘制对象绘制在模糊区域的顶部。模糊区域边界和圆角将模仿背景可绘制对象的边界和圆角。
4959 要使模糊区域可见,窗口必须是半透明的(请参阅 android.R.attr.windowIsTranslucent)和浮动的(请参阅 android.R.attr.windowIsFloating)。
4960 请注意与 WindowManager.LayoutParams.setBlurBehindRadius 的区别,它模糊了窗口后面的整个屏幕。背景模糊仅在窗口边界内模糊后面的屏幕。
4961 由于 GPU 限制,某些设备可能不支持跨窗口模糊。它也可以在运行时禁用,例如在省电模式下、使用多媒体隧道时或请求最少的后期处理时。
4962 在这种情况下,不会计算或绘制模糊,从而导致窗口背景透明。为了避免这种情况,应用程序可能需要将其主题更改为不使用模糊的主题。
4963 要监听跨窗口模糊启用/禁用事件,请使用 WindowManager.addCrossWindowBlurEnabledListener。
4964 `blur_radius` 用于窗口背景模糊的模糊半径(以像素为单位)
4965 */
4966 #[java_method]
4967 pub fn set_background_blur_radius(&self, blur_radius: i32) {}
4968
4969 /**
4970 根据资源标识符设置此窗口的可绘制功能的值。在调用此函数之前,您必须已调用 requestFeature(featureId)。
4971 `feature_id` 要更改的所需可绘制功能,由 Window 定义为常量。
4972 `res_id` 所需图像的资源标识符。
4973 */
4974 #[java_method]
4975 pub fn set_feature_drawable_resource(&self, feature_id: i32, res_id: i32) {}
4976
4977 /**
4978 为给定的可绘制功能设置自定义 alpha 值,控制背景透过该功能可见的程度。
4979 `feature_id` 需要更改的可绘制功能。功能是Window定义的常量。
4980 `alpha` – alpha 量,0 表示完全透明,255 表示完全不透明。
4981 */
4982 #[java_method]
4983 pub fn set_feature_drawable_alpha(&self, feature_id: i32, alpha: i32) {}
4984
4985 /**
4986 设置特征的整数值。值的范围取决于所设置的特征。对于 FEATURE_PROGRESS,它应该从 0 到 10000。当值为 10000 时,进度完成,指示器隐藏。
4987 `feature_id` 需要更改的特征。特征是由 Window 定义的常量。
4988 `value` 特征的值。此值的解释特定于特征。
4989 */
4990 #[java_method]
4991 pub fn set_feature_int(&self, feature_id: i32, value: i32) {}
4992
4993 /**
4994 请求关键事件到达此活动。如果您的活动没有焦点视图,但活动仍需要处理关键事件,请使用此选项。
4995 */
4996 #[java_method]
4997 pub fn take_key_events(&self, get: bool) {}
4998
4999 /**
5000 由自定义窗口(如对话框)使用,将按键事件传递到视图层次结构中。应用程序开发人员不需要实现或调用此功能。
5001 */
5002 #[java_method]
5003 pub fn super_dispatch_key_event(&self, event: &KeyEvent) -> bool {}
5004
5005 /**
5006 查询顶层窗口装饰视图(包含标准窗口框架/装饰以及其中的客户端内容),可将其作为窗口添加到窗口管理器。
5007 请注意,首次调用此函数会“锁定”各种窗口特性,如 setContentView(View, ViewGroup.LayoutParams) 中所述。
5008 返回:返回顶层窗口装饰视图。
5009 */
5010 #[java_method]
5011 pub fn get_decor_view(&self) -> View {}
5012
5013 /**
5014 返回状态栏背景视图或null。
5015 */
5016 #[java_method]
5017 pub fn get_status_bar_background_view(&self) -> Option<View> {}
5018
5019 /// 导航栏背景视图或空。
5020 #[java_method]
5021 pub fn get_navigation_bar_background_view(&self) -> Option<View> {}
5022
5023 /**
5024 查询当前装饰视图,但前提是它已经创建;否则返回 null。
5025 返回:返回顶级窗口装饰或 null。
5026 */
5027 #[java_method]
5028 pub fn peek_decor_view(&self) -> Option<View> {}
5029
5030 #[doc(hidden)]
5031 #[java_method]
5032 pub fn save_hierarchy_state(&self) -> Bundle {}
5033
5034 #[doc(hidden)]
5035 #[java_method]
5036 pub fn restore_hierarchy_state(&self, saved_instance_state: &Bundle) {}
5037
5038 /**
5039 返回窗口上默认设置的功能位。
5040 `context` 用于访问资源的上下文
5041 */
5042 #[java_method]
5043 pub fn get_default_features(context: &Context) -> i32 {}
5044
5045 /**
5046 查询特定功能的可用性。
5047 如果该功能已启用,则返回 true,否则返回 false。
5048 `feature` 要检查的功能 ID
5049 */
5050 #[java_method]
5051 pub fn has_feature(&self, feature: i32) -> bool {}
5052
5053 #[doc(hidden)]
5054 #[java_method]
5055 pub fn set_child_int(&self, feature_id: i32, value: i32) {}
5056
5057 /**
5058 是此窗口的定义快捷键之一。
5059 `key_code` 从KeyEvent到检查的密钥代码。
5060 `event` 用于帮助检查的键。
5061 */
5062 #[java_method]
5063 pub fn is_shortcut_key(&self, key_code: i32, event: &KeyEvent) -> bool {}
5064
5065 #[doc(hidden)]
5066 #[java_method]
5067 pub fn set_volume_control_stream(&self, stream_type: i32) {}
5068
5069 #[doc(hidden)]
5070 #[java_method]
5071 pub fn get_volume_control_stream(&self) -> i32 {}
5072
5073 /**
5074 设置将影响此窗口 UI 的额外选项。
5075 `ui_options` 指定此窗口额外选项的标志。
5076 */
5077 #[java_method(overload = setUiOptions)]
5078 pub fn set_ui_options_convenience(&self, ui_options: i32) {}
5079
5080 /**
5081 设置将影响此窗口 UI 的额外选项。只有经过 mask 过滤的位才会被修改。
5082 `ui_options` 指定此窗口额外选项的标志。
5083 `mask` 指定应修改哪些选项的标志。其他选项将保持不变。
5084 */
5085 #[java_method]
5086 pub fn set_ui_options(&self, ui_options: i32, mask: i32) {}
5087
5088 /**
5089 设置此窗口的主图标。
5090 `res_id` 要设置的可绘制对象的资源 ID
5091 */
5092 #[java_method]
5093 pub fn set_icon(&self, res_id: i32) {}
5094
5095 /**
5096 设置此窗口的默认图标。这将被来自主题或其他显式设置的任何其他图标设置操作覆盖。
5097 */
5098 #[java_method]
5099 pub fn set_default_icon(&self, res_id: i32) {}
5100
5101 /**
5102 设置此窗口的徽标。徽标通常代替图标显示,但通常更宽,并且还传达窗口标题信息。
5103 `res_id` 要设置的可绘制对象的资源 ID
5104 */
5105 #[java_method]
5106 pub fn set_logo(&self, res_id: i32) {}
5107
5108 /**
5109 设置此窗口的默认徽标。这将被来自主题或其他明确设置的任何其他徽标设置操作覆盖。
5110 */
5111 #[java_method]
5112 pub fn set_default_logo(&self, res_id: i32) {}
5113
5114 /**
5115 在本地设置焦点。窗口应该已经设置了 WindowManager.LayoutParams.FLAG_LOCAL_FOCUS_MODE 标志。
5116 `has_focus` 此窗口是否具有焦点。
5117 `in_touch_mode` 此窗口是否处于触摸模式。
5118 */
5119 #[java_method]
5120 pub fn set_local_focus(&self, has_focus: bool, in_touch_mode: bool) {}
5121
5122 /**
5123 控制 setEnterTransition(Transition) 中设置的过渡如何与调用 Activity 的退出过渡重叠。如果为 true,过渡将尽快开始。如果为 false,过渡将等到远程退出过渡完成后再开始。默认值为 true。
5124 `allow` 如果为 true,则在可能时启动进入过渡;如果为 false,则等到退出过渡完成。
5125 */
5126 #[java_method]
5127 pub fn set_allow_enter_transition_overlap(&self, allow: bool) {}
5128
5129 /**
5130 返回 setEnterTransition(Transition) 中设置的过渡与调用 Activity 的退出过渡如何重叠。如果为 true,过渡将尽快开始。如果为 false,过渡将等到远程退出过渡完成后再开始。默认值为 true。
5131 返回:如果进入过渡应尽快开始,则返回 true;如果应等到退出过渡完成,则返回 false。
5132 */
5133 #[java_method]
5134 pub fn get_allow_enter_transition_overlap(&self) -> bool {}
5135
5136 /**
5137 控制在完成之后重新进入时,setExitTransition(Transition) 中设置的过渡如何与被调用 Activity 的退出过渡重叠。
5138 如果为 true,过渡将尽快开始。如果为 false,过渡将等到被调用 Activity 的退出过渡完成后再开始。默认值为 true。
5139 `allow` 如果为 true,则在可能时启动过渡;如果为 false,则等到被调用 Activity 的退出过渡完成。
5140 */
5141 #[java_method]
5142 pub fn set_allow_return_transition_overlap(&self, allow: bool) {}
5143
5144 /**
5145 返回setExitTransition(Transition)中的过渡设置如何与在完成后重新输入时的退出活动的退出过渡。如果是true,过渡将尽快开始。当false时,过渡将等到呼叫活动的退出过渡完成之前。默认值是true。
5146 返回:true当过渡应在可能的情况下启动或何时等待时,直到被调用活动的退出过渡完成为止。
5147 */
5148 #[java_method]
5149 pub fn get_allow_return_transition_overlap(&self) -> bool {}
5150
5151 /**
5152 返回使用 Activity Transition 调用时进入或离开 Activity 时窗口背景淡入淡出的持续时间(以毫秒为单位)。
5153 执行进入 过渡时,背景开始透明并淡入。这需要 FEATURE_ACTIVITY_TRANSITIONS。默认值为 300 毫秒。
5154 返回:进入 过渡期间窗口背景淡入不透明的持续时间。
5155 */
5156 #[java_method]
5157 pub fn get_transition_background_fade_duration(&self) -> i64 {}
5158
5159 /**
5160 设置在使用 Activity Transition 调用时进入或离开 Activity 时窗口背景淡入淡出的持续时间(以毫秒为单位)。
5161 执行进入过渡时,背景开始透明并淡入。这需要 FEATURE_ACTIVITY_TRANSITIONS。默认值为 300 毫秒。
5162 `fade_duration_millis` 进入过渡期间窗口背景淡入或淡出不透明的持续时间。
5163 */
5164 #[java_method]
5165 pub fn set_transition_background_fade_duration(&self, fade_duration_millis: i64) {}
5166
5167 /**
5168 如果共享元素在共享元素转换期间应使用 Overlay,则返回 true;如果共享元素应作为正常 View 层次结构的一部分进行动画处理,则返回 false。默认值为 true。
5169 返回:如果共享元素在共享元素转换期间应使用 Overlay,则返回 true;如果共享元素应作为正常 View 层次结构的一部分进行动画处理,则返回 false。
5170 */
5171 #[java_method]
5172 pub fn get_shared_elements_use_overlay(&self) -> bool {}
5173
5174 /**
5175 设置共享元素在共享元素转换期间是否应使用 Overlay。默认值为 true。
5176 `shared_elements_use_overlay` true 表示共享元素应使用 Overlay 进行转换,false 表示在正常视图层次结构内进行转换。
5177 */
5178 #[java_method]
5179 pub fn set_shared_elements_use_overlay(&self, shared_elements_use_overlay: bool) {}
5180
5181 /// 状态栏的颜色。
5182 #[java_method]
5183 pub fn get_status_bar_color(&self) -> i32 {}
5184
5185 /**
5186 将状态栏的颜色设置为彩色。要使此功能生效,窗口必须使用 WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS 绘制系统栏背景,并且不得设置 WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS。
5187 如果颜色不是不透明的,请考虑设置 View.SYSTEM_UI_FLAG_LAYOUT_STABLE 和 View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN。视图背景的 transitionName 将是“android:status:background”。
5188 */
5189 #[java_method]
5190 pub fn set_status_bar_color(&self, color: i32) {}
5191
5192 /// 导航栏的颜色。
5193 #[java_method]
5194 pub fn get_navigation_bar_color(&self) -> i32 {}
5195
5196 /**
5197 将导航栏的颜色设置为`color`。要使此功能生效,窗口必须使用 WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS 绘制系统栏背景,并且不得设置 WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION。
5198 如果`color` 不透明,请考虑设置 View.SYSTEM_UI_FLAG_LAYOUT_STABLE 和 View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION。视图背景的 transitionName 将是“android:navigation:background”。
5199 */
5200 #[java_method]
5201 pub fn set_navigation_bar_color(&self, color: i32) {}
5202
5203 /**
5204 在导航栏和应用内容之间显示指定颜色的分隔线。要使此功能生效,窗口必须使用 WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS 绘制系统栏背景,并且不得设置 WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION。
5205 `divider_color` 细线的颜色。
5206 */
5207 #[java_method]
5208 pub fn set_navigation_bar_divider_color(&self, divider_color: i32) {}
5209
5210 /**
5211 查询导航栏分隔线的颜色。
5212 返回:导航栏分隔线的颜色。
5213 */
5214 #[java_method]
5215 pub fn get_navigation_bar_divider_color(&self) -> i32 {}
5216
5217 /**
5218 设置系统是否应在请求完全透明背景时确保状态栏具有足够的对比度。如果设置为此值,系统将确定是否需要使用纱布来确保状态栏与此应用的内容具有足够的对比度,并相应地设置适当的有效栏背景颜色。
5219 当状态栏颜色具有非零 alpha 值时,此属性的值无效。
5220 */
5221 #[java_method]
5222 pub fn set_status_bar_contrast_enforced(&self, ensure_contrast: bool) {}
5223
5224 /**
5225 返回系统是否在请求完全透明背景时确保状态栏具有足够的对比度。当状态栏颜色具有非零 alpha 值时,此属性的值无效。
5226 如果系统确保对比度,则返回 true,否则返回 false。
5227 */
5228 #[java_method]
5229 pub fn is_status_bar_contrast_enforced(&self) -> bool {}
5230
5231 /**
5232 设置系统是否应在请求完全透明背景时确保导航栏具有足够的对比度。如果设置为此值,系统将确定是否需要使用纱布来确保导航栏与此应用的内容具有足够的对比度,并相应地设置适当的有效栏背景颜色。
5233 当导航栏颜色具有非零 alpha 值时,此属性的值无效。
5234 */
5235 #[java_method]
5236 pub fn set_navigation_bar_contrast_enforced(&self, enforce_contrast: bool) {}
5237
5238 /**
5239 返回系统是否在请求完全透明背景时确保导航栏具有足够的对比度。当导航栏颜色具有非零 alpha 值时,此属性的值无效。
5240 如果系统确保对比度,则返回 true,否则返回 false。
5241 */
5242 #[java_method]
5243 pub fn is_navigation_bar_contrast_enforced(&self) -> bool {}
5244
5245 #[doc(hidden)]
5246 #[java_method]
5247 pub fn set_theme(&self, res_id: i32) {}
5248
5249 /**
5250 是否应将标题直接显示在内容上,而不是将内容向下推。这只会影响自由格式窗口,因为它们会显示标题。
5251 */
5252 #[java_method]
5253 pub fn set_overlay_with_decor_caption_enabled(&self, enabled: bool) {}
5254
5255 #[doc(hidden)]
5256 #[java_method]
5257 pub fn is_overlay_with_decor_caption_enabled(&self) -> bool {}
5258
5259 #[doc(hidden)]
5260 #[java_method]
5261 pub fn notify_restricted_caption_area_callback(
5262 &self,
5263 left: i32,
5264 top: i32,
5265 right: i32,
5266 bottom: i32,
5267 ) {
5268 }
5269
5270 /**
5271 设置标题控件的颜色。默认情况下,系统将尝试从主题中确定颜色。
5272 您可以使用 DECOR_CAPTION_SHADE_DARK、DECOR_CAPTION_SHADE_LIGHT 或 DECOR_CAPTION_SHADE_AUTO 覆盖此颜色。
5273 */
5274 #[java_method]
5275 pub fn set_decor_caption_shade(&self, decor_caption_shade: i32) {}
5276
5277 /**
5278 当活动从全屏模式变为多窗口模式或反之时调用。
5279 */
5280 #[java_method]
5281 pub fn on_multi_window_mode_changed(&self) {}
5282
5283 /**
5284 当活动转换为画中画模式或从画中画模式转换时调用。
5285 */
5286 #[java_method]
5287 pub fn on_picture_in_picture_mode_changed(&self, is_in_picture_in_picture_mode: bool) {}
5288}
5289
5290/// 上下文包装器允许您修改或替换包装上下文的主题。
5291#[java_class(name = "android/view/ContextThemeWrapper", extends = ContextWrapper)]
5292pub struct ContextThemeWrapper;
5293
5294/**
5295持有显示表面的人员的抽象接口。允许您控制表面大小和格式、编辑表面中的像素以及监视表面的变化。
5296此接口通常可通过 SurfaceView 类获得。当从运行其 SurfaceView 的线程以外的线程使用此接口时,您需要仔细阅读 lockCanvas 和 Callback.surfaceCreated() 方法。
5297*/
5298#[java_interface(name = "android/view/SurfaceHolder")]
5299pub trait SurfaceHolder {
5300 #[doc(hidden)]
5301 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
5302 const SURFACE_TYPE_NORMAL: i32 = 0;
5303
5304 #[doc(hidden)]
5305 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
5306 const SURFACE_TYPE_HARDWARE: i32 = 1;
5307
5308 #[doc(hidden)]
5309 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
5310 const SURFACE_TYPE_GPU: i32 = 2;
5311
5312 #[doc(hidden)]
5313 #[deprecated(note = "这将被忽略,该值在需要时自动设置。")]
5314 const SURFACE_TYPE_PUSH_BUFFERS: i32 = 3;
5315
5316 /**
5317 为该持有者添加一个回调接口。一个持有者可以关联多个回调接口。
5318 `callback` 新的 回调接口。
5319 */
5320 fn add_callback<C: SurfaceHolder_Callback>(&self, callback: &C);
5321
5322 /**
5323 从此持有者中移除先前添加的回调接口。
5324 `callback` 要移除的回调接口。
5325 */
5326 fn remove_callback<C: SurfaceHolder_Callback>(&self, callback: &C);
5327
5328 /**
5329 使用此方法可查明表面是否正在通过回调方法创建。此方法旨在与 SurfaceHolder.Callback.surfaceChanged 一起使用。
5330 如果表面正在创建,则返回 true。
5331 */
5332 fn is_creating(&self) -> bool;
5333
5334 /**
5335 设置表面的类型。
5336 */
5337 #[deprecated(note = "此项将被忽略,需要时会自动设置此值。")]
5338 fn set_type(&self, r#type: i32);
5339
5340 /**
5341 使表面具有固定大小。它永远不会改变此大小。使用 SurfaceView 时,必须从运行 SurfaceView 窗口的同一线程调用此方法。
5342 `width` 表面的宽度。
5343 `height` – 表面的高度。
5344 */
5345 fn set_fixed_size(&self, width: i32, height: i32);
5346
5347 /**
5348 允许表面根据其容器的布局调整大小(这是默认设置)。启用此功能后,您应该监视 SurfaceHolder.Callback.surfaceChanged 以了解表面大小的变化。
5349 使用 SurfaceView 时,必须从运行 SurfaceView 窗口的同一线程调用此功能。
5350 */
5351 fn set_size_from_layout(&self);
5352
5353 /**
5354 设置表面所需的 PixelFormat。默认值为 OPAQUE。
5355 使用 SurfaceView 时,必须从运行 SurfaceView 窗口的同一线程调用此方法。 `format` 来自 PixelFormat 的常量。
5356 */
5357 fn set_format(&self, format: i32);
5358
5359 /**
5360 启用或禁用选项以在显示此表面时保持屏幕打开。默认值为 false,允许其关闭。可从任何线程安全地调用此功能。
5361 `screen_on` 设置为 true 以强制屏幕保持打开状态,设置为 false 以允许其关闭。
5362 */
5363 fn set_keep_screen_on(&self, screen_on: bool);
5364
5365 /**
5366 开始编辑表面中的像素。返回的 Canvas 可用于绘制到表面的位图中。如果表面尚未创建或无法编辑,则返回 null。
5367 您通常需要实现 Callback.surfaceCreated 以查明 Surface 何时可用。 Surface 的内容永远不会在 unlockCanvas() 和 lockCanvas() 之间保留,因此,必须写入 Surface 区域内的每个像素。
5368 此规则的唯一例外是指定脏矩形时,在这种情况下,将保留非脏像素。如果在 Surface 未准备好时(在 Callback.surfaceCreated 之前或 Callback.surfaceDestroyed 之后)反复调用此函数,您的调用将被限制到较慢的速率,以避免消耗 CPU。
5369 如果没有返回 null,此函数会在内部保持锁定,直到相应的 unlockCanvasAndPost 调用,从而防止 SurfaceView 在绘制表面时创建、销毁或修改表面。
5370 这比直接访问 Surface 更方便,因为您不需要在 Callback.surfaceDestroyed 中与绘图线程进行特殊同步。
5371 返回:Canvas 用于绘制到表面。
5372 */
5373 fn lock_canvas(&self) -> Option<Canvas>;
5374
5375 /**
5376 与 lockCanvas() 类似,但允许指定脏矩形。必须写入该矩形内的每个像素;但是脏矩形之外的像素将在下次调用 lockCanvas() 时保留。
5377 返回:Canvas 用于绘制到 Surface 中。
5378 `dirty` 将被修改的表面区域。
5379 */
5380 fn lock_canvas_dirty(&self, dirty: &Rect);
5381
5382 /**
5383 完成编辑表面中的像素。调用此方法后,表面的当前像素将显示在屏幕上,但其内容将丢失,特别是无法保证再次调用 lockCanvas() 时 Surface 的内容保持不变。
5384 `canvas` 先前由 lockCanvas() 返回的 Canvas。
5385 */
5386 fn unlock_canvas_and_post(&self, canvas: &Canvas);
5387
5388 /**
5389 查询表面的当前大小。注意:不要修改返回的 Rect。
5390 这只能从 SurfaceView 窗口的线程或在 lockCanvas() 内部调用才安全。
5391 返回:Rect 表面的尺寸。左侧和顶部始终为 0。
5392 */
5393 fn get_surface_frame(&self) -> Rect;
5394
5395 /**
5396 直接访问表面对象。Surface 可能并非始终可用 - 例如,当使用 SurfaceView 时,持有者的 Surface 直到视图连接到窗口管理器并执行布局以确定 Surface 的尺寸和屏幕位置时才会创建。
5397 因此,您通常需要实现 Callback.surfaceCreated 以查明 Surface 何时可用。
5398 请注意,如果您直接从另一个线程访问 Surface,则必须正确实现 Callback.surfaceCreated 和 Callback.surfaceDestroyed 以确保线程仅在 Surface 有效时访问它,并且 Surface 不会在线程使用时被破坏。此方法旨在供经常需要直接访问 Surface 对象(通常将其传递给本机代码)的框架使用。
5399 返回:Surface 表面。
5400 */
5401 fn get_surface(&self) -> Surface;
5402}
5403
5404/**
5405客户端可以实现此接口来接收有关表面更改的信息。与 SurfaceView 一起使用时,被保留的 Surface 仅在调用 surfaceCreated(SurfaceHolder) 和 surfaceDestroyed(SurfaceHolder) 之间可用。
5406回调使用 SurfaceHolder.addCallback 方法设置。
5407*/
5408#[allow(non_camel_case_types)]
5409#[java_interface(name = "android/view/SurfaceHolder$Callback")]
5410pub trait SurfaceHolder_Callback {
5411 #[doc(hidden)]
5412 type SH: SurfaceHolder;
5413
5414 /**
5415 首次创建表面后会立即调用此方法。此方法的实现应启动所需的任何渲染代码。
5416 请注意,只有一个线程可以绘制到 Surface 中,因此如果您的正常渲染将在另一个线程中进行,则不应在此处绘制到 Surface 中。
5417 `holder` – 正在创建其表面的 SurfaceHolder。
5418 */
5419 fn surface_created(&self, holder: Self::SH);
5420
5421 /**
5422 在对表面进行任何结构更改(格式或大小)后,会立即调用此方法。此时,您应该更新表面中的图像。在 SurfaceCreated 之后,此方法始终至少调用一次。
5423 `holder` 表面已更改的 SurfaceHolder。
5424 `format` 表面的新 PixelFormat。
5425 `width` 表面的新宽度。
5426 `height` 表面的新高度。
5427 */
5428 fn surface_changed(&self, holder: Self::SH, format: i32, width: i32, height: i32);
5429
5430 /**
5431 在表面被销毁之前立即调用此函数。从此调用返回后,您不应再尝试访问此表面。
5432 如果您有一个直接访问表面的渲染线程,则必须确保在从此函数返回之前该线程不再接触表面。
5433 `holder` – 正在销毁其表面的 SurfaceHolder。
5434 */
5435 fn surface_destroyed(&self, holder: Self::SH);
5436}
5437
5438/**
5439客户端可以实现此接口来接收有关表面更改的信息。与 SurfaceView 一起使用时,被保留的 Surface 仅在调用 surfaceCreated(SurfaceHolder) 和 surfaceDestroyed(SurfaceHolder) 之间可用。
5440回调使用 SurfaceHolder.addCallback 方法设置。
5441*/
5442#[allow(non_camel_case_types)]
5443#[java_interface(name = "android/view/SurfaceHolder$Callback2")]
5444pub trait SurfaceHolder_Callback2: SurfaceHolder_Callback {
5445 /**
5446 当应用程序需要重绘其表面的内容时调用,在调整其大小后或出于其他原因。通过在重绘完成之前不从此处返回,您可以确保用户不会看到处于不良状态的表面(在以新大小正确绘制之前)。
5447 这通常会先调用surfaceChanged。从O开始,可以实现surfaceRedrawNeededAsync以提供非阻塞实现。如果未实现surfaceRedrawNeededAsync,则将改为调用此方法。
5448 `holder` 其表面已更改的SurfaceHolder。
5449 */
5450 fn surface_redraw_needed(&self, holder: &Self::SH);
5451}
5452
5453//noinspection SpellCheckingInspection
5454/**
5455处理由屏幕合成器管理的原始缓冲区。 Surface 通常由图像缓冲区的使用者(例如 SurfaceTexture、android.media.MediaRecorder 或 android.renderscript.Allocation)创建或从其创建,并交给某种生产者(例如 OpenGL、MediaPlayer 或 CameraDevice)进行绘制。
5456注意:Surface 就像与其关联的使用者的弱引用。它本身不会阻止其父级使用者被回收。
5457*/
5458#[java_class(name = "android/view/Surface")]
5459pub struct Surface;
5460
5461/// 测试android.view
5462#[cfg(feature = "test_android_view")]
5463pub fn test() {
5464 use crate::{
5465 android::app::Activity,
5466 java::lang::{CharSequenceExt, CharSequenceImpl},
5467 };
5468 let act = Activity::fetch().unwrap();
5469 let view = View::new(&act);
5470 assert!(view.to_string().starts_with("android.view.View"));
5471 view.announce_for_accessibility(&"通知".to_char_sequence::<CharSequenceImpl>().unwrap());
5472 view.request_focus();
5473 view.clear_focus();
5474 assert!(view.find_focus().is_some());
5475 view.set_activated(true);
5476 assert_eq!(true, view.is_activated());
5477 view.set_x(20f32);
5478 assert_eq!(20f32, view.get_x());
5479 view.set_y(30f32);
5480 assert_eq!(30f32, view.get_y());
5481 assert!(view.find_view_by_id(0).is_some());
5482 view.set_content_description(Some("测试".to_char_sequence::<CharSequenceImpl>().unwrap()));
5483 assert_eq!(
5484 "测试".to_char_sequence().ok(),
5485 view.get_content_description::<CharSequenceImpl>()
5486 );
5487 view.set_id(3);
5488 assert_eq!(3, view.get_id());
5489 let l = View_OnClickListenerImpl::from_fn(|_| {
5490 println!("View is clicked.");
5491 })
5492 .unwrap();
5493 view.set_on_click_listener(l.as_ref());
5494 view.set_visibility(View::GONE);
5495 assert_eq!(View::GONE, view.get_visibility());
5496 view.set_context_clickable(true);
5497 assert_eq!(true, view.is_context_clickable());
5498 view.set_clickable(true);
5499 assert_eq!(true, view.is_clickable());
5500 view.set_long_clickable(true);
5501 assert_eq!(true, view.is_long_clickable());
5502 view.set_allow_click_when_disabled(true);
5503 view.perform_click();
5504 assert!(view.get_parent::<ViewGroup>().is_some());
5505
5506 let params = ViewGroup_LayoutParams::new(
5507 ViewGroup_LayoutParams::MATCH_PARENT,
5508 ViewGroup_LayoutParams::MATCH_PARENT,
5509 );
5510 params.set_width(40);
5511 assert_eq!(40, params.get_width());
5512 params.set_height(50);
5513 assert_eq!(50, params.get_height());
5514 let params = ViewGroup_MarginLayoutParams::from_layout_params(¶ms);
5515 params.set_left_margin(20);
5516 assert_eq!(20, params.get_left_margin());
5517 params.set_top_margin(10);
5518 assert_eq!(10, params.get_top_margin());
5519 params.set_right_margin(30);
5520 assert_eq!(30, params.get_right_margin());
5521 params.set_bottom_margin(40);
5522 assert_eq!(40, params.get_bottom_margin());
5523 view.set_layout_params(¶ms);
5524 assert!(view.get_layout_params().is_some());
5525 let params = WindowManager_LayoutParams::new();
5526 params.set_flags(WindowManager_LayoutParams::FLAG_ALT_FOCUSABLE_IM);
5527 assert_eq!(
5528 WindowManager_LayoutParams::FLAG_ALT_FOCUSABLE_IM,
5529 params.get_flags()
5530 );
5531 let key_event = KeyEvent::new(KeyEvent::ACTION_DOWN, KeyEvent::KEYCODE_0);
5532 assert_eq!(KeyEvent::ACTION_DOWN, key_event.get_action());
5533 assert_eq!(KeyEvent::KEYCODE_0, key_event.get_key_code());
5534}