Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SetInPlacePosition Method

ITextInputPanel::SetInPlacePosition method

[ITextInputPanel is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use IInputPanelConfiguration. ]

Explicitly positions the Tablet PC Input Panel in screen coordinates.

Syntax


HRESULT SetInPlacePosition(
   int                xPosition,
   int                yPosition,
   CorrectionPosition position
);

Parameters

xPosition

The horizontal x-coordinate for the top left corner of the Input Panel, with no correction comb visible.

yPosition

The vertical y-coordinate for the top left corner of the Input Panel, with no correction comb visible.

position

The direction the post insertion correction comb should pop up in, as defined by the CorrectionPosition enumeration.

Return value

Returns false when the Input Panel is open (docked or floating) and cannot be moved; otherwise it returns true.

Return codeDescription
S_OK

Success.

E_FAIL

An unspecified error occurred.

 

Remarks

Note   In Windows 7, calling SetInPlacePosition will no longer use the CorrectionPosition parameter.

Take the height of the correction comb in mind when deciding where to position the Input Panel in order to keep the Input Panel and correction comb on screen. The direction specified in the position parameter overrides the direction set using the ITextInputPanel::PreferredInPlaceDirection Property.

There are no restrictions on where the Input Panel can be positioned. It is the responsibility of the application developer to make sure the Input Panel does not go off the screen. The ITextInputPanel::InPlaceBoundingRectangle Property, ITextInputPanel::PopUpCorrectionHeight Property, and ITextInputPanel::PopDownCorrectionHeight Property, along with the ITextInputPanelEventSink::InPlaceSizeChanging Method, can be used for this purpose.

This method is synchronous. Positioning occurs before the method returns.

Examples

This C++ example implements an EN_SETFOCUS event handler for an Edit control, IDC_EDIT3. It first checks to if an ITextInputPanel object, g_pTip, has been created. If it exists, it reports the values of several ITextInputPanel Interface properties to debug output using the TRACE macro. It also sets the position of the Input Panel by calling the ITextInputPanel::SetInPlacePosition Method.


void CCOMTIPDlg::OnEnSetFocusEdit3()
{
    if (NULL != g_pTip)
    {
		CorrectionMode mode;

		if (SUCCEEDED(g_pTip->get_CurrentCorrectionMode(&mode)))
        {
			TRACE("CurrentCorrectionMode: %d\n", mode);
		}

		InPlaceState state;

		if (SUCCEEDED(g_pTip->get_CurrentInPlaceState(&state)))
        {
			TRACE("CurrentInPlaceState: %d\n", state);
		}

		PanelInputArea area;

		if (SUCCEEDED(g_pTip->get_CurrentInputArea(&area)))
        {
			TRACE("CurrentInputArea: %d\n", area);
		}

		InteractionMode iMode;

		if (SUCCEEDED(g_pTip->get_CurrentInteractionMode(&iMode)))
        {
			TRACE("CurrentInteractionMode: %d\n", iMode);
		}

        RECT rect;

		if (SUCCEEDED(g_pTip->get_InPlaceBoundingRectangle(&rect)))
        {
	        TRACE("InPlaceBoundingRectangle.top: %d\n", rect.top);
	        TRACE("InPlaceBoundingRectangle.left: %d\n", rect.left);
	        TRACE("InPlaceBoundingRectangle.bottom: %d\n", rect.bottom);
	        TRACE("InPlaceBoundingRectangle.right: %d\n", rect.right);
        }

	    int nHeight;

		if (SUCCEEDED(g_pTip->get_PopDownCorrectionHeight(&nHeight)))
        {
	        TRACE("PopDownCorrectionHeight: %d\n", nHeight);
        }

	    if (SUCCEEDED(g_pTip->get_PopUpCorrectionHeight(&nHeight)))
        {
	        TRACE("PopUpCorrectionHeight: %d\n", nHeight);
        }

		if (SUCCEEDED(g_pTip->SetInPlacePosition(300, 300, CorrectionPosition_Bottom)))
		{
			TRACE("Call to SetInPlacePosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlacePosition() failed.\n");
		}
    }
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}


Requirements

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

End of client support

Windows 7

End of server support

None supported

Header

Peninputpanel.h (also requires Peninputpanel_i.c)

DLL

Tiptsf.dll

See also

ITextInputPanel Interface
ITextInputPanel::SetInPlaceHoverTargetPosition Method
ITextInputPanel::SetInPlaceVisibility Method

 

 

Community Additions

ADD
Show:
© 2015 Microsoft