InputPane.Showing Event

Definition

Namespace:

Windows.UI.ViewManagement

Occurs when the input pane starts sliding into view.

// 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) 

Event Type

TypedEventHandler<InputPane,InputPaneVisibilityEventArgs>

Remarks

The system associates the input pane with the application window that was visible when you called the GetForCurrentView method. This implies that you must create a new input pane object and register for the Showing event each time you create a new window.

When the system calls your event handler, the input pane has not started to slide into view. After your event handler returns, the input pane starts to slide into view. If your event handler doesn't respond quickly enough (within 200 milliseconds), the input pane starts to slide into view without waiting for your event handler to return.

You can use the Showing event to create a custom user experience when the input pane is displayed. For example, in an instant messenger app, you might want to resize the chat window and input box to fit above the input pane so that the user never has to scroll to see new messages. If you do create a custom user experience, make sure to set the EnsuredFocusedElementInView property on the event arguments to notify the app framework that you have handled the input pane event and it should not try to do so for you.

You should minimize the amount of work you do while the input pane is being shown because multiple animations and content resizes may be happening simultaneously. The more work you do during this period affects the overall system performance, causing a poor user experience.

See also

• InputPaneVisibilityEventArgs
• TryShow()