IPenInputPanel::MoveTo method (peninputpanel.h)

Article
02/22/2024

Deprecated. The PenInputPanel has been replaced by the Text Input Panel (TIP).

Sets the position of the PenInputPanel object to a static screen position.

Syntax

HRESULT MoveTo(
  [in] long Left,
  [in] long Top
);

Parameters

[in] Left

The new horizontal position in screen coordinates.

[in] Top

The new vertical position in screen coordinates.

Return value

This method can return one of these values.

Return code	Description
S_OK	Success.
E_UNEXPECTED	Unexpected parameter or property type.
E_FAIL	An unspecified error occurred.

Remarks

The MoveTo method causes an error if the control to which the PenInputPanel is attached does not have focus. This method can be safely called if the pen input panel is not visible, as long as the attached control has focus.

If the new position causes the panel to appear outside the boundary of the screen working area, the panel is shifted toward the center of the working area so that the edges of the panel are adjacent to the nearest edges of the screen.

To explicitly override the automatic positioning behavior of the PenInputPanel object, use the Left and Top properties of the PenInputPanel object to determine its current position. If the PenInputPanel is located on a section of the screen that should be visible, use the MoveTo method to relocate the PenInputPanel.

You can also override the automatic positioning behavior of the PenInputPanel object by monitoring to the Left and Top parameters passed to a PanelMoving event handler. If the PenInputPanel is located on a section of the screen that should be visible, use the MoveTo method to relocate the PenInputPanel.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	peninputpanel.h
Library	InkObj.dll