IInkAnalyzer-Schnittstelle
Bietet Zugriff auf Layoutanalyse, Schreib- und Zeichnungsklassifizierung und Handschrifterkennung.
Member
Die IInkAnalyzer-Schnittstelle erbt von der IUnknown-Schnittstelle . IInkAnalyzer verfügt auch über folgende Membertypen:
Methoden
Die IInkAnalyzer-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Abbruch | Bricht den aktuellen Analysevorgang ab. |
| Addstroke | Fügt dem IInkAnalyzer Strichdaten für einen einzelnen Strich hinzu und weist dem Strich den Kulturbezeichner des aktiven Eingabethreads zu. |
| AddStrokeForLanguage | Fügt dem IInkAnalyzer Strichdaten für einen einzelnen Strich hinzu und weist dem Strich einen bestimmten Kulturbezeichner zu. |
| Addstrokes | Fügt dem IInkAnalyzer Strichdaten für mehrere Striche hinzu und weist den Strichen den Kulturbezeichner des aktiven Eingabethreads zu. |
| AddStrokesForLanguage | Fügt dem IInkAnalyzer Strichdaten für mehrere Striche hinzu und weist den Strichen den angegebenen Kulturbezeichner zu. |
| AddStrokesToCustomRecognizer | Fügt einem benutzerdefinierten Erkennungsknoten Strichdaten für mehrere Striche hinzu. |
| AddStrokeToCustomRecognizer | Fügt einem benutzerdefinierten Erkennungsknoten Strichdaten für einen einzelnen Strich hinzu. |
| Analysieren | Führt eine synchrone Freihandanalyse aus. |
| Backgroundanalyze | Führt eine asynchrone Freihandanalyse aus. |
| ClearStrokeData | Löscht Strichpaketdaten aus dem IInkAnalyzer. |
| Createanalysishint | Fügt dem IInkAnalyzer einen neuen Analysehinweisknoten mit einem unendlichen Bereich hinzu. |
| CreateContextNodes | Erstellt ein IContextNodes-Objekt . |
| CreateCustomRecognizer | Erstellt einen neuen benutzerdefinierten Erkennungsknoten für den IInkAnalyzer. |
| DeleteAnalysisHint | Entfernt einen Analysehinweis aus dem IInkAnalyzer. |
| Findinkleafnodes | Ruft alle Freihandblattknoten ab. |
| FindInkLeafNodesForStrokes | Ruft die Freihandblattknoten ab, die die angegebenen Striche enthalten. |
| FindLeafNodes | Ruft alle Blattknoten ab. |
| FindNode | Ruft das IContextNode-Objekt für einen angegebenen global eindeutigen Bezeichner (GUID) ab. |
| Findnodesoftype | Ruft alle IContextNode-Objekte des angegebenen Typs ab. |
| FindNodesOfTypeForStrokes | Ruft alle IContextNode-Objekte des angegebenen Typs ab, die die angegebenen Striche enthalten. |
| FindNodesOfTypeInSubTree | Ruft alle IContextNode-Objekte des angegebenen Typs ab, die Nachfolger des angegebenen IContextNode-Objekts sind. |
| FindNodesWithCallBack | Ruft alle IContextNode-Objekte ab, die den angegebenen Kriterien entsprechen. |
| FindNodesWithCallBackInSubTree | Ruft alle IContextNode-Objekte ab, die den angegebenen Kriterien entsprechen und Nachfolger des angegebenen IContextNode-Objekts sind. |
| Getalternates | Ruft 10 alternative Analyse-Elemente für alle Freihandeingaben ab, die dem IInkAnalyzer zugeordnet sind. |
| GetAlternatesForContextNodes | Ruft alternative Analyseelemente für die Knoten in einer angegebenen IContextNodes-Auflistung ab. |
| GetAlternatesForStrokes | Ruft Analyse-Alternativen für die Striche mit den angegebenen Strichbezeichnern ab. |
| Inkanalyzer.getanalysishints | Ruft alle IContextNode-Analysehinweisobjekte ab, die an den IInkAnalyzer angefügt sind. |
| GetAnalysisHintsByName | Ruft alle IContextNode-Analysehinweisobjekte ab, die an den IInkAnalyzer angefügt sind und den angegebenen Namen aufweisen. |
| GetAnalysisModes | Ruft Flags ab, die steuern, wie der IInkAnalyzer die Freihandanalyse ausführt. |
| GetDirtyRegion | Ruft den Bereich ab, der sich seit dem letzten Analysevorgang geändert hat. |
| GetInkAnalysisRecognizersByPriority | Ruft eine geordnete Auflistung von IInkAnalysisRecognizer-Objekten ab. |
| GetNodesFromTextRange | Ruft eine Auflistung von IContextNode-Objekten ab, die für den angegebenen Textbereich für die angegebenen Kontextknoten relevant sind. |
| Getrecognizedstring | Ruft die Zeichenfolge mit dem besten Ergebnis des Erkennungsvorgangs für die gesamte Kontextknotenstruktur im IInkAnalyzer ab. |
| GetRootNode | Ruft den Stamm-IContextNode der Kontextstruktur des IInkAnalyzer-Objekts ab. |
| GetStrokeLanguageId | Ruft den Gebietsschemabezeichner des angegebenen Strichs ab. |
| GetStrokeType | Ruft den Typ des angegebenen Strichs ab. |
| GetTextRangeFromNodes | Sucht den Textbereich in der erkannten Zeichenfolge, der einer Auflistung von IContextNode-Objekten entspricht. |
| IsAnalyzing | Ruft einen Wert ab, der angibt, ob der IInkAnalyzer eine Freihandanalyse ausführt. |
| LoadResults | Lädt gespeicherte Analyseergebnisse in den IInkAnalyzer. |
| Modifytopalternate | Ändert die aktuelle obere Alternative in die angegebene Alternative und löscht den Bestätigungstyp für alle IContextNode-Objekte , die dem Alternativen zugeordnet sind. |
| ModifyTopAlternateWithConfirmation | Ändert die aktuelle obere Alternative in die angegebene IAnalysisAlternate. |
| Reconcile | Bestimmt, welche Teile der Analyseergebnisse sich während der Freihandanalyse im Hintergrund geändert haben. |
| RemoveStroke | Entfernt den angegebenen Strich aus dem IInkAnalyzer. |
| RemoveStrokes | Entfernt die angegebenen Striche aus dem IInkAnalyzer. |
| Inkanalyzer.saveresults | Speichert alle Analyseergebnisse für einen IInkAnalyzer. |
| SaveResultsForNodes | Speichert Analyseergebnisse für eine bestimmte Kontextknotensammlung, die einem IInkAnalyzer zugeordnet ist. |
| SaveResultsForStrokes | Speichert Analyseergebnisse für die angegebenen Striche, die einem IInkAnalyzer zugeordnet sind. |
| Search | Stellt eine Fuzzy-Suche ohne Beachtung der Groß-/Kleinschreibung für die Suche nach analysierten Schreibstrichen und analysierten Zeichnungsstrichen mit erkannten Typen bereit. |
| SearchWithLanguageId | Stellt eine Fuzzy-Suche ohne Beachtung der Groß-/Kleinschreibung für die Suche nach analysierten Schreibstrichen und analysierten Zeichnungsstrichen mit erkannten Typen bereit. |
| SetAnalysisModes | Ändert Flags, die steuern, wie der IInkAnalyzer freihandanalyse ausführt. |
| SetDirtyRegion | Ändert den Bereich, der sich seit dem letzten Analysevorgang geändert hat. |
| SetHighestPriorityInkAnalysisRecognizer | Verschiebt den angegebenen IInkAnalysisRecognizer an die erste Position in der Liste der Freihanderkennungen des IInkAnalyzer-Objekts . |
| SetStrokeLanguageId | Ändert den Gebietsschemabezeichner für den angegebenen Strich. |
| SetStrokesLanguageId | Ändert den Gebietsschemabezeichner für die angegebenen Striche. |
| SetStrokesType | Ändert den Typ der angegebenen Striche. |
| Setstroketype | Ändert den Typ des angegebenen Strichs. |
| UpdateStrokesData | Updates die Paketdaten für die angegebenen Striche. |
Bemerkungen
IInkAnalyzer verwendet Strichpaketdaten zum Analysieren von Freihand und interagiert nicht direkt mit Objekten der InkDisp-Klasse oder InkStrokes-Sammlung .
Verwenden Sie eine der folgenden Methoden, um dem IInkAnalyzer zur Analyse Striche hinzuzufügen oder zu entfernen.
- IInkAnalyzer::AddStroke-Methode
- IInkAnalyzer::AddStrokes-Methode
- IInkAnalyzer::RemoveStroke-Methode
- IInkAnalyzer::RemoveStrokes-Methode
Diese Methoden aktualisieren die modifiziert Region (siehe IInkAnalyzer::GetDirtyRegion-Methode), die region, für die Striche im nächsten Analysevorgang analysiert werden.
Verwenden Sie zum Analysieren von Freihand die IInkAnalyzer::Analyze-Methode oder IInkAnalyzer::BackgroundAnalyze-Methode . Während der Analyse führt der IInkAnalyzer Layoutanalyse, Strichklassifizierung und Handschrifterkennung durch.
Verwenden Sie zum Ändern der Layoutanalyse- und Strichklassifizierungseinstellungen die Eigenschaft IInkAnalyzer::SetAnalysisModes Method .
Während der Analyse empfängt der IInkAnalyzer eine Reihe von Ereignissen, einschließlich der Ereignisse, die während der Hintergrundanalyse generiert wurden. _IAnalysisProxyEvents unterstützt die Datenproxyfeatures des IInkAnalyzers. Weitere Informationen finden Sie unter Datenproxy mit Freihandanalyse. Um den Analyseprozess in einem Ereignishandler zu beenden, rufen Sie IInkAnalyzer::Abort-Methode auf.
Verwenden Sie die IInkAnalyzer::SetStrokeLanguageId-Methode oder die IInkAnalyzer::SetStrokesLanguageId-Methode, um die Sprache zu ändern, die die Freihandanalyse zum Erkennen der Handschrift verwendet. Um zu ändern, wie die Freihandanalyse bestimmte Striche klassifiziert, verwenden Sie die IInkAnalyzer::SetStrokeType-Methode oder die IInkAnalyzer::SetStrokesType-Methode.
Der IInkAnalyzer lädt Informationen für alle installierten Freihanderkennungserkennungen. IInkAnalyzer::GetInkAnalysisRecognizersByPriority-Methode gibt eine IInkAnalysisRecognizers-Auflistung zurück, die jeden verfügbaren IInkAnalysisRecognizer enthält. Wenn mehrere Freihanderkennungen eine bestimmte Sprache unterstützen, verwenden Sie IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer-Methode , um festzulegen, welche Freihanderkennung Striche für diese Sprache verarbeitet.
Die Verwendung von Analysehinweisen kann die Erkennungsgenauigkeit verbessern, indem dem Freihandanalysator zusätzlichen Kontext bereitgestellt wird. Die zusätzlichen Kontextinformationen können dem Freihandanalysator helfen, die Anzahl möglicher Erkennungsergebnisse zu begrenzen. Beispielsweise können Sie den Bereich einschränken, indem Sie Factoide und erwartete Wörter definieren oder Ihre Eingabe in einen Erkennungsleitfaden strukturieren. Weitere Informationen zum Bereitstellen von Kontext für die Freihandanalyse finden Sie unter:
- IInkAnalyzer::CreateAnalysisHint-Methode
- IInkAnalyzer::D eleteAnalysisHint-Methode
- IInkAnalyzer::GetAnalysisHints-Methode
- IInkAnalyzer::GetAnalysisHintsByName-Methode
Die Freihandanalyse stellt Analyseergebnisse als Zeichenfolge oder als Struktur von IContextNode-Objekten dar. Verwenden Sie die IInkAnalyzer::GetRecognizedString-Methode, um auf die erkannte Zeichenfolge zuzugreifen. Verwenden Sie die IInkAnalyzer::GetRootNode-Methode, um auf den Stamm der Kontextknotenstruktur zuzugreifen. Die Freihandanalyse verfügt über die folgenden Methoden zum Suchen nach bestimmten Kontextknoten oder Text.
- IInkAnalyzer::FindInkLeafNodes-Methode
- IInkAnalyzer::FindInkLeafNodesForStrokes-Methode
- IInkAnalyzer::FindLeafNodes-Methode
- IInkAnalyzer::FindNode-Methode
- IInkAnalyzer::FindNodesOfType-Methode
- IInkAnalyzer::FindNodesOfTypeForStrokes-Methode
- IInkAnalyzer::FindNodesOfTypeInSubTree-Methode
- IInkAnalyzer::FindNodesWithCallBack-Methode
- IInkAnalyzer::FindNodesWithCallBackInSubTree-Methode
Verwenden Sie eine der folgenden Methoden, um mit alternativen Analyseergebnissen zu arbeiten.
- IInkAnalyzer::GetAlternates-Methode
- IInkAnalyzer::GetAlternatesForContextNodes-Methode
- IInkAnalyzer::GetAlternatesForStrokes-Methode
- IInkAnalyzer::ModifyTopAlternate-Methode
- IInkAnalyzer::ModifyTopAlternateWithConfirmation-Methode
Verwenden Sie eine der folgenden Methoden, um Analyseergebnisse zu speichern.
- IInkAnalyzer::SaveResults-Methode
- IInkAnalyzer::SaveResultsForNodes-Methode
- IInkAnalyzer::SaveResultsForStrokes-Methode
Verwenden Sie zum Laden gespeicherter Ergebnisse die IInkAnalyzer::LoadResults-Methode.
Weitere Informationen zur Verwendung von IInkAnalyzer zum Analysieren von Freihand finden Sie unter Übersicht über die Freihandanalyse.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|