Export (0) Print
Expand All

ITextInputPanel interface

Applies to: desktop apps only

Provides control of appearance and behavior of the Tablet PC Input Panel.

Members

The ITextInputPanel interface inherits from the IUnknown interface. ITextInputPanel also has these types of members:

Methods

The ITextInputPanel interface has these methods.

MethodDescription
Advise

Establishes an advisory connection between the Tablet PC Input Panel and the specified sink object.

CommitPendingInput

Sends collected ink to the recognizer and posts the recognition result.

SetInPlaceHoverTargetPosition

Explicitly positions the Tablet PC Input Panel hover target in screen coordinates.

SetInPlacePosition

Explicitly positions the Tablet PC Input Panel in screen coordinates.

SetInPlaceVisibility

Shows or hides the Tablet PC Input Panel.

Unadvise

Terminates an advisory connection previously established through the ITextInputPanel::Advise Method.

 

Properties

The ITextInputPanel interface has these properties.

PropertyAccess typeDescription

AttachedEditWindow

Read/write

Sets or gets the window handle of the object to which the ITextInputPanel object is attached.

CurrentCorrectionMode

Read-only

Gets the current correction comb mode as specified by the CorrectionMode Enumeration.

CurrentInPlaceState

Read-only

Gets the current in-place state as specified by the InPlaceState Enumeration.

CurrentInputArea

Read-only

Gets the current input area as specified by the PanelInputArea Enumeration.

CurrentInteractionMode

Read-only

Gets the positioning of the Tablet PC Input Panel as specified by the InteractionMode Enumeration.

DefaultInPlaceState

Read/write

Gets or sets the default in-place state as specified by the InPlaceState Enumeration.

DefaultInputArea

Read/write

Gets or sets the default input area as specified by the PanelInputArea Enumeration.

ExpandPostInsertionCorrection

Read/write

Gets or sets a value that indicates whether the correction comb on the Tablet PC Input Panel is automatically expanded.

InPlaceBoundingRectangle

Read-only

Gets the bounding rectangle for Tablet PC Input Panel.

InPlaceVisibleOnFocus

Read/write

Gets or sets a value that indicates whether the Tablet PC Input Panel is displayed automatically when the window to which it is attached gets focus.

PopDownCorrectionHeight

Read-only

Gets the height of the Post-Insertion correction comb when it is positioned below Input Panel.

PopUpCorrectionHeight

Read-only

Gets the height of the Post-Insertion correction comb when it is positioned above Input Panel.

PreferredInPlaceDirection

Read/write

Gets or sets the preferred direction of the in-place Input Panel relative to the text entry field.

 

Remarks

ITextInputPanel Interface gives application developers more control and information about Input Panel's state than PenInputPanel Class. ITextInputPanel Interface replaces the PenInputPanel Class as the preferred mechanism for programmatically interacting with the Input Panel.

ITextInputPanel Interface provides:

  • A complete control over the positioning of the in-place Input Panel when the application has focus.
  • An access to the ink objects from the Input Panel text insertion in addition to the recognized text.
  • A set of properties that correspond exactly to Input Panel's capabilities giving both the ability to know Input Panel's current state and to customize Input Panel's configuration.

The ITextInputPanel Interface continues to provide nearly all of the programmatic capabilities of the PenInputPanel Class thus superseding the PenInputPanel Class.

This element is declared in Peninputpanel.h.

Requirements

Minimum supported client

Windows XP Tablet PC Edition

Minimum supported server

None supported

Header

Peninputpanel.h (also requires Peninputpanel_i.c)

DLL

Tiptsf.dll

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2015 Microsoft