PenInputPanel.CommitPendingInput-Methode

Artikel
11/26/2008

Veraltet. Sendet erfasste Freihandeingaben an das Erkennungsmodul und stellt das Erkennungsergebnis bereit. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

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

Syntax

'Declaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
Public Sub CommitPendingInput
'Usage
Dim instance As PenInputPanel

instance.CommitPendingInput()

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public void CommitPendingInput()

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
public:
void CommitPendingInput()

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
public void CommitPendingInput()

public function CommitPendingInput()

Hinweise

Bei westlichen Sprachen sendet der Handschriftbereich die erfassten Freihandeingaben an das Erkennungsmodul und löscht den Schreibblock. Bei ostasiatischen Sprachen, die mehrere Felder verwenden, sendet der Handschriftbereich die erfassten Zeichen und löscht die Felder. Das Erkennungsergebnis wird an das Steuerelement gesendet, an das das PenInputPanel-Objekt angefügt ist.

Wenn es keine ausstehenden Eingaben gibt oder die CurrentPanel-Eigenschaft auf Keyboard festgelegt ist, unternimmt CommitPendingInput nichts.

Ist das PenInputPanel-Objekt inaktiv, generiert ein Aufruf dieser Methode einen Fehler.

Ab Microsoft® Windows® XP Tablet PC Edition 2005 werden Freihandeingaben erkannt, sobald der Benutzer sie eingibt. Daher sendet die CommitPendingInput-Funktion den schon erkannten Text an das Bearbeitungssteuerelement und erzwingt die Erkennung nicht mehr.

Wenn das PenInputPanel-Objekt inaktiv ist, dann generiert CommitPendingInput ab Microsoft® Windows® XP Tablet PC Edition 2005 keinen Fehler mehr, sondern kehrt einfach zurück.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Methode die SecurityPermissionFlag.AllFlags-Berechtigung sowie die von PenInputPanel geforderten Berechtigungen erforderlich. Weitere Informationen finden Sie unter Security and Trust.

Beispiele

In diesem C#-Beispiel wird das PenInputPanel-Objekt thePenInputPanel erstellt und an das InkEdit-Steuerelement theInkEdit angefügt. Fügt dem Formular für das PenInputPanel wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event hinzu. Wenn das PenInputPanel-Objekt unsichtbar wird, werden im Ereignishandler über einen Aufruf der CommitPendingInput-Methode die noch anstehenden Eingaben an das Erkennungsmodul gesendet.

[C#]

//...

// Declare the PenInputPanel object
PenInputPanel thePenInputPanel;

public Form1()
{
    // Required for Windows Form Designer support
    InitializeComponent();

    // Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = new PenInputPanel(theInkEdit);

    // Add a PenInputPanelVisibleChanged event handler
    thePenInputPanel.VisibleChanged +=
        new PenInputPanelVisibleChangedEventHandler(VisibleChanged_Event);
}

//...

public void VisibleChanged_Event(object sender,
PenInputPanelVisibleChangedEventArgs e)
{
    // Make sure the object that generated
    // the event is a PenInputPanel object
    if (sender is PenInputPanel)
    {
        PenInputPanel theSenderPanel = (PenInputPanel)sender;

        // If the panel has become invisible...
        if (!e.NewVisibility)
        {
            // Send pending input to the recognizer
            theSenderPanel.CommitPendingInput();
        }
    }
}

In diesem Microsoft Visual Basic® .NET-Beispiel wird das PenInputPanel-Objekt thePenInputPanel erstellt und an ein InkEdit-Steuerelement mit dem Namen theInkEdit angefügt. Fügt dem Formular für das PenInputPanel wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event hinzu. Wenn das PenInputPanel-Objekt unsichtbar wird, werden im Ereignishandler über einen Aufruf der CommitPendingInput-Methode die noch anstehenden Eingaben an das Erkennungsmodul gesendet.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

    'This call is required by the Windows Form Designer.
    InitializeComponent()

    ' Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = New PenInputPanel(theInkEdit)

    ' Add a PenInputPanelVisibleChanged event handler
    AddHandler thePenInputPanel.VisibleChanged, _
               AddressOf VisibleChanged_Event
End Sub 'New

'...

Public Sub VisibleChanged_Event(sender As Object, e As _
                                PenInputPanelVisibleChangedEventArgs)
    ' Make sure the object that generated
    ' the event is a PenInputPanel object
    If TypeOf sender Is PenInputPanel Then
       Dim theSenderPanel As PenInputPanel = CType(sender, PenInputPanel)

       ' If the panel has become invisible...
       If Not e.NewVisibility Then
          ' Send pending input to the recognizer
            theSenderPanel.CommitPendingInput()
       End If
    End If
End Sub 'VisibleChanged_Event

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.