InputPane.Showing 事件

定义

命名空间:

Windows.UI.ViewManagement

当输入窗格开始滑动到视图中时发生。

// Register
event_token Showing(TypedEventHandler<InputPane, InputPaneVisibilityEventArgs const&> const& handler) const;

// Revoke with event_token
void Showing(event_token const* cookie) const;

// Revoke with event_revoker
InputPane::Showing_revoker Showing(auto_revoke_t, TypedEventHandler<InputPane, InputPaneVisibilityEventArgs const&> const& handler) const;

public event TypedEventHandler<InputPane,InputPaneVisibilityEventArgs> Showing;

function onShowing(eventArgs) { /* Your code */ }
inputPane.addEventListener("showing", onShowing);
inputPane.removeEventListener("showing", onShowing);
- or -
inputPane.onshowing = onShowing;

Public Custom Event Showing As TypedEventHandler(Of InputPane, InputPaneVisibilityEventArgs) 

事件类型

TypedEventHandler<InputPane,InputPaneVisibilityEventArgs>

注解

系统将输入窗格与调用 GetForCurrentView 方法时可见的应用程序窗口相关联。 这意味着，您必须创建新的输入窗格对象，并在每次创建新窗口时注册显示事件。

当系统调用事件处理程序时，输入窗格尚未开始滑入视图。 事件处理程序返回后，输入窗格开始滑入视图。 如果事件处理程序在 200 毫秒) 内响应不够快 (，则输入窗格将开始滑入视图，而无需等待事件处理程序返回。

显示输入窗格时，可以使用“显示”事件创建自定义用户体验。 例如，在即时消息应用中，你可能希望调整聊天窗口和输入框的大小，使其适合输入窗格上方，以便用户无需滚动即可看到新消息。 如果确实创建自定义用户体验，请确保在事件参数上设置 EnsuredFocusedElementInView 属性，以通知应用框架你已处理输入窗格事件，并且它不应尝试为你执行此操作。

应尽量减少在显示输入窗格时所做的工作量，因为多个动画和内容重设大小可能会同时发生。 在此期间执行的工作越多，会影响整体系统性能，从而导致用户体验不佳。

另请参阅

• InputPaneVisibilityEventArgs
• TryShow()