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

示例

以下示例演示如何将墨迹中的墨迹复制到另一个 InkCanvasInkCanvas。 此示例假定：

• 有两 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 属性用法

<object StrokeCollection="isfString"/>  

XAML 对象元素用法

<object>isfString</object>  

XAML 值

术语	定义
isfString	一个字符串，表示 base-64、编码的墨迹序列化格式 (ISF) 笔划。

构造函数

StrokeCollection()	初始化 StrokeCollection 类的新实例。
StrokeCollection(IEnumerable<Stroke>)	初始化包含指定笔画的 StrokeCollection 类的新实例。
StrokeCollection(Stream)	从墨迹序列化格式 (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 属性的值更改时发生。

扩展方法