IInkAnalyzer::GetNodesFromTextRange-Methode
Ruft eine Auflistung von IContextNode-Objekten ab, die für den angegebenen Textbereich für die angegebenen Kontextknoten relevant sind.
Syntax
HRESULT GetNodesFromTextRange(
[in, out] LONG *plStart,
[in, out] LONG *plLength,
[out] IContextNodes **ppContextNodes,
[in] IContextNodes *pNodesToSearch = defaultvalue
);
Parameter
-
plStart [in, out]
-
Ein Verweis auf den Anfang des Textbereichs im pNodesToSearch-Teil der erkannten Zeichenfolge.
-
plLength [in, out]
-
Ein Verweis auf die Länge des Textbereichs im pNodesToSearch-Teil der erkannten Zeichenfolge.
-
ppContextNodes [out]
-
Ein Zeiger auf die IContextNode-Objekte , die für den angegebenen Textbereich für die angegebenen Kontextknoten relevant sind.
-
pNodesToSearch [in]
-
Die IContextNode-Objekte , auf die die Suche beschränkt werden soll.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.
Bemerkungen
Der angegebene Textbereich sollte relativ zum pNodesToSearch-Teil der erkannten Zeichenfolge des IInkAnalyzers und nicht zur erkannten Zeichenfolge des gesamten IInkAnalyzers sein.
Diese Methode ändert die Werte der Parameter plStart und plLength , indem der Textbereich auf die nächsten Wortgrenzen erweitert wird.
Wenn die erkannte Zeichenfolge beispielsweise "Ich bin zu spät" ist und Sie diese Methode mit den Parameterwerten 6 für plStart und 1 für plLength aufrufen, die dem Buchstaben "a" in "late" entsprechen, gibt diese Methode eine Auflistung zurück, die einen einzelnen IContextNode, den InkWord- oder TextWord-Wert enthält, der dem Wort "late" entspricht. In diesem Beispiel ändert diese Methode auch den Wert von plStart in 5 und den Wert von plLength in 4, was dem Wort "late" entspricht.
Hinweis
Der plStart-Parameter ist relativ zur erkannten Zeichenfolge des pNodesToSearch-Parameters .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|