InkAnalyzerBase.Search Method (String, Int32)

Article
12/08/2012

Provides a fuzzy, case-insensitive phrase based search for analyzed writing strokes and analyzed drawing strokes that have recognized types.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

'Declaration
Public Function Search ( _
    phraseToSearch As String, _
    languageId As Integer _
) As Integer()()
'Usage
Dim instance As InkAnalyzerBase 
Dim phraseToSearch As String 
Dim languageId As Integer 
Dim returnValue As Integer()()

returnValue = instance.Search(phraseToSearch, _
    languageId)

public int[][] Search(
    string phraseToSearch,
    int languageId
)

public:
array<array<int>^>^ Search(
    String^ phraseToSearch, 
    int languageId
)

public function Search(
    phraseToSearch : String, 
    languageId : int
) : int[][]

Parameters

phraseToSearch
Type: System.String

The phrase that may be found in the alternates for the currently analyzed strokes.

languageId
Type: System.Int32

The locale identifier (LCID) to use when doing the search.

Return Value

Type: array<array<System.Int32[][]
A two-dimensional array of integers that contains the sets of strokes that represent the found phrase. No two arrays may have exactly the same strokes in them, but strokes can appear in more than one set due to alternate segmentations or multiple matches.

Remarks

This search finds multi-word and single-word substrings. Both alternate recognition results and alternate segmentations are searched.

All incoming strings convert to a single casing for comparison. This utilizes the Locale Identifier, LCID, of the current thread for the conversion while applying cultural case conventions.

The string passed is treated as a phrase. Words and characters must appear in the alternates for the strokes in the order specified. The first and last words of the phrase may be matched as substrings. When this happens, the first word appears at the end of an alternate and the last word appears at the beginning. Other words, located inside the phrase, must appear as whole words.

If the string passed in has no white space in between characters, the substring may be found anywhere inside of a single word inside an alternate.

Only the presence or absence of white space between characters changes the results of search. White space that is not surrounded by characters is ignored. The type of the white space is ignored (a tab or a space between characters will give the same result). The amount of white space does not matter - one space or two spaces in between characters will give the same result.

Search does not generate PopulateContextNodeBase events. Only the strokes that have already been populated will be searched.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via