TextInputPanel Class

Article
10/20/2012

Provides methods to attach and control the Tablet PC Input Panel.

Namespace: Microsoft.Ink.TextInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class TextInputPanel _
    Implements IDisposable
'Usage
Dim instance As TextInputPanel

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class TextInputPanel : IDisposable

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class TextInputPanel : IDisposable

public class TextInputPanel implements IDisposable

Remarks

TextInputPanel supersedes PenInputPanel, offering more control of Tablet PC Input Panel and more information about its state.

The TextInputPanel class is available as an attachable object allowing you to add Tablet PC Input Panel functionality to existing controls. The user interface is largely mandated by the current input language. You have the option of choosing either handwriting or keyboard as the default input method for the TextInputPanel object. The end user may switch between input methods using buttons on the user interface.

the TextInputPanel class offers the following customizations to Input Panel behavior:

Complete control over the positioning of the in-place Input Panel when the application has focus.
Access to the ink objects from the Input Panel text insertion in addition to the recognized text.
A set of properties corresponding exactly to Input Panel’s capabilities giving both the ability to know Input Panel’s current state and customize its configuration.

Warning

You must call the Dispose method on this object before it goes out of scope. This object maintains non-managed resources. Relying on finalization for this object can cause memory leaks and exceptions within your application.

For an example of disposing managed objects, see Using the Managed Library.

Inheritance Hierarchy

System.Object
Microsoft.Ink.TextInput.TextInputPanel

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via