PenInputPanel.CommitPendingInput, méthode

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Envoie l'entrée manuscrite collectée au module de reconnaissance et publie le résultat de la reconnaissance. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
Public Sub CommitPendingInput
'Utilisation
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()

Notes

Pour les langues occidentales, le panneau Écriture manuscrite envoie l'entrée manuscrite collectée au module de reconnaissance et efface le pavé d'écriture. Pour les langues asiatiques qui utilisent plusieurs zones, le panneau Écriture manuscrite envoie les caractères reconnus et efface les zones. Le résultat de la reconnaissance est envoyé au contrôle auquel l'objet PenInputPanel est attaché.

Si aucune entrée n'est en attente ou si la propriété CurrentPanel est Clavier, CommitPendingInput n'effectue aucune action.

Si l'objet PenInputPanel est inactif, l'appel à cette méthode génère une erreur.

Depuis la version Microsoft® Windows® XP Édition 2005 Tablet PC, l'entrée manuscrite est reconnue à mesure que l'utilisateur l'effectue. Par conséquent, la fonction CommitPendingInput envoie le texte déjà reconnu au contrôle d'édition, sans forcer la reconnaissance.

Depuis la version Windows XP Édition Tablet PC 2005, si l'objet PenInputPanel est inactif, CommitPendingInput ne génère pas d'erreur, il est simplement retourné.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette méthode requiert l'autorisation SecurityPermissionFlag.AllFlags (page pouvant être en anglais), en plus des autorisations requises par PenInputPanel. Pour plus d'informations, consultez Security and Trust.

Exemples

Cet exemple C# crée un objet PenInputPanel, thePenInputPanel et l'attache à un contrôle InkEdit, theInkEdit. Il ajoute un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au formulaire pour PenInputPanel. Dans le gestionnaire d'événements, si l'objet PenInputPanel devient invisible, toute entrée en attente est envoyée au module de reconnaissance via l'appel à la méthode CommitPendingInput.

[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();
        }
    }
}

Cet exemple Microsoft® Visual Basic® .NET crée un objet PenInputPanel, thePenInputPanel et l'attache à un contrôle InkEdit, theInkEdit. Il ajoute un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au formulaire pour PenInputPanel. Dans le gestionnaire d'événements, si l'objet PenInputPanel devient invisible, toute entrée en attente est envoyée au module de reconnaissance via l'appel à la méthode CommitPendingInput.

[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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.