[C++] [propget] HRESULT get_WordList([out,retval]IInkWordList** WordList); [propputref] HRESULT putref_WordList([in]IInkWordList* WordList);
[Microsoft® Visual Basic® 6.0]
[Visual Basic] Public Property Get WordList() As InkWordList Public Property Let WordList( _ ByVal WordList As InkWordList)
InkWordList The word list that is used in the recognition process to improve the recognition results, or
Nothing in Visual Basic 6.0) for the user dictionary.
This property is read/write.
|E_FAIL||An unspecified error occurred.|
|E_INK_EXCEPTION||An exception occurred inside method.|
|E_POINTER||The parameter is an invalid out pointer.|
|TPC_E_OUT_OF_ORDER_CALL||This property cannot be assigned after strokes have been added to the Strokes property.|
Setting this property succeeds only if the Strokes property is
NULL. You must set the WordList property before you attach a InkStrokes collection to the Strokes property of the InkRecognizerContext or you must set the Strokes property to
null and then set the WordList property (and possibly reattach the InkStrokes collection).
To remove the current word list and use the user dictionary, set this property to
NULL. Any subsequent modification of the InkWordList object does not modify the recognition outcome. If you want to change the word list later, change it and then reassign it to the WordList property.
If a string is added to a word list, its capitalized versions are also implicitly added. For instance, adding "hello" implicitly adds "Hello" and "HELLO".
[Visual Basic 6.0]
This Visual Basic 6.0 example shows an example of creating an InkWordList object, theUserWordList, from a Variant array of String, theUserDictionary, and then merging it into the word list of the recognizer context, theRecognizerContext.
[Visual Basic] '... Dim theUserWordList As New InkWordList Dim theUserDictionary() As String ... Dim theString As String For Each theString In theUserDictionary theUserWordList.AddWord theString Next theUserWordList.Merge theRecognizerContext.WordList ' Note: there should be no strokes in the Strokes property of the ' Recognizer Context when setting the WordList property Set theRecognizerContext.WordList = theUserWordList