Edit

Share via

IFrameworkInputPaneHandler::Showing method (shobjidl_core.h)

  • Article

Called before the input pane is shown, to allow the app window to make any necessary adjustments to its UI in response to the reduced screen space available to it. This is particularly important for input elements, such as text boxes, that are used in conjunction with the input pane.

Syntax

HRESULT Showing(
  [in] RECT *prcInputPaneScreenLocation,
  [in] BOOL fEnsureFocusedElementInView
);

Parameters

[in] prcInputPaneScreenLocation

Type: RECT*

A pointer to a RECT structure that supplies the screen coordinates that the input pane will occupy.

[in] fEnsureFocusedElementInView

Type: BOOL*

A pointer to a value that is set to true if the app should attempt to keep its currently focused element (such as a text box) in view, which could require the app to move the element or rearrange its UI.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

IFrameworkInputPaneHandler