跳到主要内容
版本：11.0.0

输入面板 v11.1 Preview!

InputPane 允许开发者监听平台输入面板（例如，软键盘或屏幕键盘）的当前状态和边界。

InputPane 可以通过 TopLevel 或 Window 的实例访问，有关访问 TopLevel 的更多详细信息，请访问 TopLevel 页面：

var inputPane = TopLevel.GetTopLevel(control).InputPane;
备注

目前Avalonia 不会根据输入面板的状态自动调整root视图和滚动位置。相反的，建议开发者使用 IInputPane API 并相应地调整他们的应用程序。

自动调整计划在未来的 11.* 版本中实现。

属性​

State​

当前输入面板状态。可能的值：

  • InputPaneState.Closed
  • InputPaneState.Opened
InputPaneState State { get; }

OccludedRect​

当前输入面板的边界。

Rect OccludedRect { get; }
备注

返回值是以当前顶级窗口的客户端坐标表示的。如果输入面板是浮动或分离的，并位于视图顶部，则会返回一个空矩形。

事件​

StateChanged​

当输入面板的状态发生变化时触发。

event EventHandler<InputPaneStateEventArgs>? StateChanged;

值得注意的是，事件参数包括几个有用的参数：

  • InputPaneStateEventArgs.NewState - 输入面板的新状态。
  • InputPaneStateEventArgs.StartRect - 输入面板的初始边界。
  • InputPaneStateEventArgs.EndRect - 输入面板的最终边界。
  • InputPaneStateEventArgs.AnimationDuration - 输入面板状态变化动画的持续时间。
  • InputPaneStateEventArgs.Easing - 输入面板状态变化动画的缓动效果。

拥有 AnimationDuration 和 Easing 允许开发者在两个状态之间创建过渡。

平台兼容性：​

功能WindowsmacOSLinux浏览器AndroidiOSTizen
State✔✖✖✔*✔✔✖
OccludedRect✔✖✖✔*✔✔✖
StateChanged✔✖✖✔*✔✔✖
StateChanged.StartRect✖✖✖✔*✔✔✖
StateChanged.AnimationDuration✖✖✖✖✔✔✖
StateChanged.Easing✖✖✖✖✔✔✖

* - 仅移动版 Chromium 浏览器支持 IInputPane API。