RecognizerContext.EndInkInput-Methode
Beendet Freihandeingaben zum RecognizerContext-Objekt.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Sub EndInkInput
'Usage
Dim instance As RecognizerContext
instance.EndInkInput()
public void EndInkInput()
public:
void EndInkInput()
public void EndInkInput()
public function EndInkInput()
Hinweise
Nach dem Aufruf dieser Methode können Sie dem RecognizerContext-Objekt keine Stroke-Objekte hinzufügen.
Unter partieller Erkennung wird die Fähigkeit des Erkennungsmoduls verstanden, selbst dann Ergebnisse zurückzugeben, wenn die Anwendung die EndInkInput-Methode nicht aufruft. Diese Methode signalisiert der Anwendung, dass die Freihandeingabe beendet wurde. Eine partielle Erkennung tritt nur dann auf, wenn das Erkennungsmodul vor einem Aufruf der EndInkInput-Methode feststellen kann, dass Freihandeingaben erfolgten, und nicht alle Erkennungsmodule unterstützen dies. Erkennungsmodule, die keine partielle Erkennung unterstützen, geben erst dann ein Ergebnis zurück, wenn EndInkInput aufgerufen wird.
Unter inkrementeller Erkennung wird die Fähigkeit des Erkennungsmoduls verstanden, nur einen kleinen Teil der übergebenen Freihandeingaben zu verarbeiten und ein Ergebnis zurückzugeben. Betrachten wir beispielsweise eine Anwendung, die fünf Zeilen Freihandeingaben erhält und ein Erkennungsmodul für lateinische Schriftzeichen verwendet. Das Erkennungsmodul kann jeweils nur eine Zeile verarbeiten und ein Ergebnis zurückgeben. Dieser Prozess wird in der Leerlaufschleife des Hintergrundverarbeitungsthreads verwendet.
Wenn das Erkennungsmodul die partielle Erkennung unterstützt, kann es auch dann ein Ergebnis zurückgeben, wenn die EndInkInput-Methode noch nicht aufgerufen wurde.
Hinweis
Von der partiellen Erkennung abgeleitete Ergebnisse unterscheiden sich möglicherweise von den Ergebnissen nach dem Aufruf der EndInkInput-Methode. Bei Verwendung der partiellen Erkennung wird vom Erkennungsmodul nicht verlangt, Ergebnisse für die gesamte Freihandeingabe zurückzugeben. Wenn der Kontext von Freihandeingaben verloren geht, kann sich dies möglicherweise negativ auf die Erkennung auswirken.
Hinweis
In Windows Vista und neueren Versionen ist diese Methode ist für Erkennungsmodule westlicher Sprachen als veraltet markiert.
Beispiele
In diesem C#-Beispiel wird der buttonSubmit_Click-Ereignishandler für das Click-Ereignis eines Schaltflächensteuerelements veranschaulicht, der die gültigen Freihandeingaben in der Strokes-Auflistung erkennt, die dem RecognizerContext-Objekt theRecognizerContext (das in dem Bereich deklariert wird, der es enthält) zugeordnet ist, und sie in einem Textfeld anzeigt, sofern keine Fehler auftreten.
private void buttonSubmit_Click(object sender, System.EventArgs e)
{
theRecognizerContext.EndInkInput();
RecognitionStatus theRecognitionStatus;
theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
if (RecognitionStatus.NoError == theRecognitionStatus)
theTextBox.Text = theRecognitionResult.TopString;
else
// Handle the error cases here...
theTextBox.Text = "";
}
In diesem Microsoft Visual Basic® .NET-Beispiel wird der buttonSubmit_Click-Ereignishandler für das Click-Ereignis eines Schaltflächensteuerelements veranschaulicht, der die gültigen Freihandeingaben in der Strokes-Auflistung erkennt, die dem RecognizerContext-Objekt theRecognizerContext (das in dem Bereich deklariert wird, der es enthält) zugeordnet ist, und sie in einem Textfeld anzeigt, sofern keine Fehler auftreten.
Private Sub Button1_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
theRecognizerContext.EndInkInput()
Dim theRecognitionStatus As RecognitionStatus
theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
If RecognitionStatus.NoError = theRecognitionStatus Then
RichTextBox1.Text = theRecognitionResult.TopString
Else
'Handle the error conditions here.
RichTextBox1.Text = ""
End If
End Sub
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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0