StrokeCollection 類別

定義

命名空間:

System.Windows.Ink

組件:

PresentationCore.dll

表示 Stroke 物件的集合。

public ref class StrokeCollection : System::Collections::ObjectModel::Collection<System::Windows::Ink::Stroke ^>, System::Collections::Specialized::INotifyCollectionChanged, System::ComponentModel::INotifyPropertyChanged

[System.ComponentModel.TypeConverter(typeof(System.Windows.StrokeCollectionConverter))]
public class StrokeCollection : System.Collections.ObjectModel.Collection<System.Windows.Ink.Stroke>, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.INotifyPropertyChanged

[<System.ComponentModel.TypeConverter(typeof(System.Windows.StrokeCollectionConverter))>]
type StrokeCollection = class
    inherit Collection<Stroke>
    interface INotifyCollectionChanged
    interface INotifyPropertyChanged

Public Class StrokeCollection
Inherits Collection(Of Stroke)
Implements INotifyCollectionChanged, INotifyPropertyChanged

繼承

Object

Collection<Stroke>

StrokeCollection

屬性

TypeConverterAttribute

實作

INotifyCollectionChanged INotifyPropertyChanged

範例

下列範例示範如何將中的筆跡複製到另一 InkCanvas 個 InkCanvas 。 此範例假設：

• 有兩 InkCanvas 個物件稱為 inkCanvas1 和 inkCanvas2 。

• 事件 Click 已連線至事件處理常式。

// Copy the strokes from one InkCanvas to another InkCanvas.
private void CopyStrokes_Click(object sender, RoutedEventArgs e) 
{
    StrokeCollection strokes = inkCanvas1.Strokes.Clone();
    inkCanvas2.Strokes.Clear();
    inkCanvas2.Strokes.Add(strokes);
}

' Copy the strokes from one InkCanvas to another InkCanvas.
Private Sub CopyStrokes_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)

    Dim strokes As StrokeCollection = inkCanvas1.Strokes.Clone()
    inkCanvas2.Strokes.Clear()
    inkCanvas2.Strokes.Add(strokes)

End Sub

備註

StrokeCollection可讓您執行叫用測試、裁剪和清除筆劃等函式。 控制項 InkCanvas 會執行許多這些函式，但如果您需要比 提供的更多控制權 InkCanvas ，則 StrokeCollection 提供更多選項。

下表列出在自訂控制項上管理數位筆跡的位置。

若要進行此動作...	請參閱此文章
建立可收集數位筆跡的控制項	建立筆墨輸入控制項
建立可讓使用者選取筆跡的控制項	如何：從自訂控制項選取筆墨
建立可讓使用者點清除筆跡的控制項	如何：清除自訂控制項上的筆墨

XAML Attribute Usage

<object StrokeCollection="isfString"/>  

XAML 物件項目用法

<object>isfString</object>  

XAML 值

詞彙	定義
isfString	字串，表示 base-64、編碼的筆跡序列化格式 (ISF) 。

建構函式

StrokeCollection()	初始化 StrokeCollection 類別的新執行個體。
StrokeCollection(IEnumerable<Stroke>)	初始化包含指定筆劃之 StrokeCollection 類別的新執行個體。
StrokeCollection(Stream)	從 Ink Serialized Format (ISF) 的指定 StrokeCollection 初始化 Stream。

欄位

InkSerializedFormat

表示筆墨資料的原生保存格式。

屬性

Count	取得 Collection<T> 中實際包含的項目數目。 (繼承來源 Collection<T>)
Item[Int32]	在指定的索引位置上取得或設定項目。 (繼承來源 Collection<T>)
Items	取得 IList<T> 周圍的 Collection<T> 包裝函式。 (繼承來源 Collection<T>)

方法

Add(StrokeCollection)	將指定的筆劃加入至 StrokeCollection。
Add(T)	將物件加入至 Collection<T> 的末端。 (繼承來源 Collection<T>)
AddPropertyData(Guid, Object)	將自訂屬性加入至 StrokeCollection。
Clear()	移除 Collection<T> 中的所有項目。 (繼承來源 Collection<T>)
ClearItems()	清除 StrokeCollection 中的所有筆劃。
Clip(IEnumerable<Point>)	移除 StrokeCollection 中超出指定之 Point 陣列界限的所有筆劃。
Clip(Rect)	將以指定矩形裁剪的所有筆劃取代為未超過指定矩形的新筆劃。
Clone()	複製 StrokeCollection。
Contains(T)	判斷某項目是否在 Collection<T> 中。 (繼承來源 Collection<T>)
ContainsPropertyData(Guid)	傳回指定的自訂屬性識別碼是否存在於 StrokeCollection 中。
CopyTo(T[], Int32)	從目標陣列的指定索引開始，將整個 Collection<T> 複製到相容的一維 Array。 (繼承來源 Collection<T>)
Draw(DrawingContext)	在 StrokeCollection 中繪製筆劃。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Erase(IEnumerable<Point>)	移除所指定區域之界限內的墨水。
Erase(IEnumerable<Point>, StylusShape)	將由指定之 StylusShape 所建立區域沿著指定路徑裁剪的所有筆劃，取代為該區域未裁剪的新筆劃。
Erase(Rect)	使用未輸入指定矩形界限的新筆劃，來取代由指定矩形所裁剪的所有筆劃。
GetBounds()	傳回集合中筆劃的界限。
GetEnumerator()	傳回在 Collection<T> 中逐一查看的列舉值。 (繼承來源 Collection<T>)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetIncrementalLassoHitTester(Int32)	建立使用套索 (徒手) 路徑點擊測試 IncrementalLassoHitTester 的 StrokeCollection。
GetIncrementalStrokeHitTester(StylusShape)	建立使用清除路徑點擊測試 IncrementalStrokeHitTester 的 StrokeCollection。
GetPropertyData(Guid)	傳回與指定 Guid 關聯的自訂屬性值。
GetPropertyDataIds()	傳回 StrokeCollection 關聯之任何自訂屬性的 GUID。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
HitTest(IEnumerable<Point>, Int32)	傳回在指定區域內具有指定百分比長度以上的筆劃集合。
HitTest(IEnumerable<Point>, StylusShape)	傳回與指定路徑交集的筆劃集合。
HitTest(Point)	傳回與指定點交集的筆劃集合。
HitTest(Point, Double)	傳回與指定區域交集的筆劃集合。
HitTest(Rect, Int32)	傳回在指定矩形內具有指定百分比長度以上的筆劃集合。
IndexOf(Stroke)	傳回 Stroke 中指定 StrokeCollection 的索引。
IndexOf(T)	搜尋指定的物件，並傳回整個 Collection<T> 中第一個出現之以零為起始的索引。 (繼承來源 Collection<T>)
Insert(Int32, T)	將項目插入至 Collection<T> 中指定的索引位置。 (繼承來源 Collection<T>)
InsertItem(Int32, Stroke)	將筆劃插入至 StrokeCollection 的指定索引處。
InsertItem(Int32, T)	將項目插入至 Collection<T> 中指定的索引位置。 (繼承來源 Collection<T>)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnPropertyChanged(PropertyChangedEventArgs)	在任何 StrokeCollection 屬性變更時發生。
OnPropertyDataChanged(PropertyDataChangedEventArgs)	引發 PropertyDataChanged 事件。
OnStrokesChanged(StrokeCollectionChangedEventArgs)	引發 StrokesChanged 事件。
Remove(StrokeCollection)	從集合中移除指定的筆劃。
Remove(T)	從 Collection<T> 移除特定物件之第一個符合的元素。 (繼承來源 Collection<T>)
RemoveAt(Int32)	移除 Collection<T> 之指定索引處的項目。 (繼承來源 Collection<T>)
RemoveItem(Int32)	從 StrokeCollection 中移除指定索引處的筆劃。
RemovePropertyData(Guid)	移除與指定 Guid 關聯的自訂屬性。
Replace(Stroke, StrokeCollection)	以指定的 Stroke 取代指定的 StrokeCollection。
Replace(StrokeCollection, StrokeCollection)	以新的 StrokeCollection 取代指定的 StrokeCollection。
Save(Stream)	將 StrokeCollection 儲存至指定的 Stream。
Save(Stream, Boolean)	將 StrokeCollection 儲存至指定的 Stream，並在指定時進行壓縮。
SetItem(Int32, Stroke)	取代指定索引處的筆劃。
SetItem(Int32, T)	取代指定之索引處的項目。 (繼承來源 Collection<T>)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Transform(Matrix, Boolean)	根據指定的 StylusPoints，針對 StylusTipTransform 中的每一個筆劃修改每一個 StrokeCollection 以及選擇性的 Matrix。

事件

PropertyDataChanged	發生於當自訂屬性加入至 StrokeCollection 或從中移除時。
StrokesChanged	發生於集合中的 Stroke 變更時。

明確介面實作

INotifyCollectionChanged.CollectionChanged	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 發生於 StrokeCollection 變更時。
INotifyPropertyChanged.PropertyChanged	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 任何 StrokeCollection 屬性的值變更時發生。

擴充方法