IInkAnalyzer::SetStrokeLanguageId method
Changes the locale identifier for the specified stroke.
Syntax
HRESULT SetStrokeLanguageId(
[in] LONG lStrokeId,
[in] LONG lStrokeLCID
);
Parameters
-
lStrokeId [in]
-
The identifier of the stroke to which to assign the locale identifier.
-
lStrokeLCID [in]
-
The locale identifier to assign to the stroke.
Return value
For a description of the return values, see Classes and Interfaces - Ink Analysis.
Remarks
A stroke's locale is set when you add the stroke by calling IInkAnalyzer::AddStroke Method, IInkAnalyzer::AddStrokeForLanguage Method, IInkAnalyzer::AddStrokes Method, or IInkAnalyzer::AddStrokesForLanguage Method. To get the locale currently assigned to a stroke, call IInkAnalyzer::GetStrokeLanguageId Method.
The specified stroke is moved to an unclassified ink node (see IContextNode::GetType) that contains strokes of the same language. If no such IContextNode exists, this method creates a new unclassified ink node and moves the stroke to it. An unclassified ink node is an IContextNode that has a type of UnclassifiedInk.
If this method moves a stroke from an IContextNode that is not an unclassified ink node, this method also adds the stroke's bounding box to the ink analyzer's dirty region (see IInkAnalyzer::GetDirtyRegion Method).
This method does not move a stroke if the lStrokeLCID parameter matches the stroke's current language identifier.
If the specified stroke is not associated with the IInkAnalyzer, this method returns without updating the IInkAnalyzer.
For more information about language identifiers, see Language Identifier Constants and Strings.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows XP Tablet PC Edition [desktop apps only] |
| Minimum supported server |
None supported |
| Header |
|
| DLL |
|