InkAnalyzerBase.SetStrokesLanguageId 方法

發行項
10/29/2008

變更所指定筆劃的地區設定識別項。

命名空間： System.Windows.Ink.AnalysisCore
組件： IACore (在 IACore.dll 中)

語法

'宣告
Public Sub SetStrokesLanguageId ( _
    strokeIds As Integer(), _
    languageId As Integer _
)
'用途
Dim instance As InkAnalyzerBase
Dim strokeIds As Integer()
Dim languageId As Integer

instance.SetStrokesLanguageId(strokeIds, _
    languageId)

public void SetStrokesLanguageId(
    int[] strokeIds,
    int languageId
)

public:
void SetStrokesLanguageId(
    array<int>^ strokeIds, 
    int languageId
)

public void SetStrokesLanguageId(
    int[] strokeIds,
    int languageId
)

public function SetStrokesLanguageId(
    strokeIds : int[], 
    languageId : int
)

參數

strokeIds
型別：array<System.Int32[]
陣列，其中包含要指派其地區設定識別項之筆劃的筆劃識別項。

languageId
型別：System.Int32
要指派給所指定筆劃的語言識別項。

備註

當您呼叫 AddStroke 或 AddStrokes 加入筆劃時，會設定筆劃的地區設定。若要取得目前指派給筆劃的地區設定，請呼叫 GetStrokeLanguageId。

指定的筆劃會移到未分類的筆墨節點，該節點中包含相同語言的筆劃。如果沒有這類內容節點，這個方法會建立未分類的新筆墨節點，並在其中加入筆劃。未分類的筆墨節點是 ContextNodeBase，其 Type 屬性值為 ContextNodeTypeBase.UnclassifiedInk。

如果這個方法從不是未分類筆墨節點的內容節點移動筆劃，則這個方法也會將筆劃的週框方塊加入至筆墨分析器的 DirtyRegion。

如果 languageId 參數符合筆劃目前的語言識別項，則這個方法不會移動筆劃。

如果 strokeIds 中所識別的筆劃與筆墨分析器沒有關聯，這個方法會忽略識別項。

如果 strokeIds 中所識別的筆劃全都與筆墨分析器沒有關聯，這個方法會傳回但不會更新筆墨分析器。

當 strokeIds 為 nullNull 參照 (即 Visual Basic 中的 Nothing) 時，這個方法會擲回 System.ArgumentNullException。

範例

下列範例會將筆劃型別設定為 StrokeType 值 Writing，並且將指定的節點內所有筆劃的筆劃地區設定設為法文。InkAnalyzerBase (theInkAnalyzerBase) 包含指定的 ContextNodeBase (theNode)。

' For all strokes in the specified node or one of its descendants,
' set the stroke type to Writing and the stroke locale to French.
Dim theStrokeIds As Integer() = theNode.GetStrokeIds()
If 0 < theStrokeIds.Length Then
    theInkAnalyzerBase.SetStrokesType( _
        theStrokeIds, System.Windows.Ink.AnalysisCore.StrokeType.Writing)
    theInkAnalyzerBase.SetStrokesLanguageId(theStrokeIds, &H40C)
End If

// For all strokes in the specified node or one of its descendants,
// set the stroke type to Writing and the stroke locale to French.
int[] theStrokeIds = theNode.GetStrokeIds();
if (0 < theStrokeIds.Length)
{
    theInkAnalyzerBase.SetStrokesType(theStrokeIds,
        System.Windows.Ink.AnalysisCore.StrokeType.Writing);
    theInkAnalyzerBase.SetStrokesLanguageId(theStrokeIds, 0x040c);
}