InkAnalyzerBase.SetStrokesType 方法

發行項
10/29/2008

變更所指定筆劃的型別。

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

語法

'宣告
Public Sub SetStrokesType ( _
    strokeIds As Integer(), _
    strokeType As StrokeType _
)
'用途
Dim instance As InkAnalyzerBase
Dim strokeIds As Integer()
Dim strokeType As StrokeType

instance.SetStrokesType(strokeIds, strokeType)

public void SetStrokesType(
    int[] strokeIds,
    StrokeType strokeType
)

public:
void SetStrokesType(
    array<int>^ strokeIds, 
    StrokeType strokeType
)

public void SetStrokesType(
    int[] strokeIds,
    StrokeType strokeType
)

public function SetStrokesType(
    strokeIds : int[], 
    strokeType : StrokeType
)

參數

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

strokeType
型別：System.Windows.Ink.AnalysisCore.StrokeType
要指派給筆劃的筆劃型別。

備註

如果筆劃的型別為 StrokeType 值 Unspecified，則筆墨分析器會在筆墨分析期間分類筆劃。否則，分析器會使用筆劃上設定的型別。

筆墨分析器不會在分析筆墨的過程中設定筆劃類型值。若要取得目前指派給筆劃的類型，請呼叫 GetStrokeType。

如果與筆劃相關聯的內容節點不是未分類筆墨節點，則這個方法會將筆劃移到包含相同語言之筆劃的未分類筆墨節點。如果沒有這類內容節點，這個方法會建立未分類的新筆墨節點，並在其中加入筆劃。未分類的筆墨節點是 ContextNodeBase，其 Type 屬性值為 UnclassifiedInk。

如果這個方法移動某個筆劃，則這個方法也會將該筆劃的週框方塊加入至筆墨分析器的 DirtyRegion。

如果 strokeType 參數符合筆劃目前的型別，則這個方法不會移動筆劃。

如果 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);
}