IInkAnalyzer::Search-Methode

Stellt eine unscharfe, von Groß- und Kleinschreibung unabhängige, ausdrucksbasierte Suche nach analysierten Schreibstrichen und analysierten Zeichnungsstrichen bereit, die erkannte Typen aufweisen.

Syntax

HRESULT Search(
  [in]      BSTR  bstrPhraseToMatch,
  [in, out] ULONG *pulSearchResultCount,
  [out]     ULONG **ppulStrokeCountPerResult,
  [in, out] ULONG *pulStrokeIdsCount,
  [out]     ULONG **ppulStrokeIds
);

Parameter

bstrPhraseToMatch [in]

Der Ausdruck, der in den Alternativen für die aktuell analysierten Striche gefunden wird.

pulSearchResultCount [in, out]

Die maximale Anzahl der von der Suche zurückgegebenen Ergebnisse.

ppulStrokeCountPerResult [out]

Zeiger auf ein Array der Anzahl der Striche in jedem Suchergebnis.

pulStrokeIdsCount [in, out]

Die Anzahl der Strich-IDs in ppulStrokeIds.

ppulStrokeIds [out]

Zeiger auf ein Array von Strich-IDs, die eine Reihe von Strichgruppen darstellen.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.

Hinweise

Bei dieser Suche werden Teilzeichenfolgen mit mehreren Wörter und einzelnen Wörtern gefunden. Es werden sowohl alternative Erkennungsergebnisse als auch alternative Segmentierungen gesucht.

Alle eingehenden Zeichenfolgen werden in Groß- oder Kleinbuchstaben konvertiert, wobei die Gebietsschema-ID (LCID) des aktuellen Threads verwendet wird, um diese Konvertierung entsprechend den Konventionen der jeweiligen Kultur in Bezug auf Groß-/Kleinschreibung durchzuführen.

Die übergebene Zeichenfolge wird als Ausdruck behandelt. Wörter und Zeichen müssen in den Alternativen für die Striche in der angegebenen Reihenfolge angezeigt werden. Das erste und das letzte Wort des Ausdrucks können als Teilzeichenfolgen (das erste Wort am Ende einer Alternative und das letzte Wort am Anfang einer Alternative) abgeglichen werden, aber alle anderen Wörter (innerhalb des Ausdrucks) müssen als ganze Wörter erscheinen.

Wenn die übergebene Zeichenfolge kein Leerzeichen zwischen Zeichen enthält, kann die Teilzeichenfolge an jeder beliebigen Stelle innerhalb eines einzelnen Wortes in einer Alternative gefunden werden.

Nur das Vorhandensein oder Fehlen von Leerzeichen zwischen Zeichen ändert die Suchergebnisse. Leerzeichen, die nicht von Zeichen umgeben sind, werden ignoriert. Der Typ des Leerzeichens wird ignoriert (ein Tabstopp oder ein Leerzeichen zwischen Zeichen ergibt dasselbe Ergebnis). Die Menge an Leerzeichen spielt keine Rolle – ein oder zwei Leerzeichen zwischen Zeichen ergeben dasselbe Ergebnis.

Die Suche generiert keine PopulateContextNode-Ereignisse. Nur die bereits ausgefüllten Striche werden durchsucht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Header	IACom.h (erfordert auch IACom_i.c)
DLL	IACom.dll

Siehe auch

IInkAnalyzer