StrokeCollection Класс

Определение

Представляет коллекцию объектов Stroke.Represents a collection of Stroke objects.

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
type StrokeCollection = class
    inherit Collection<Stroke>
    interface INotifyPropertyChanged
    interface INotifyCollectionChanged
Public Class StrokeCollection
Inherits Collection(Of Stroke)
Implements INotifyCollectionChanged, INotifyPropertyChanged
Наследование
StrokeCollection
Атрибуты
Реализации

Примеры

В следующем примере показано, как скопировать рукописный ввод в один InkCanvas на другой InkCanvas.The following example demonstrates how to copy the ink in one InkCanvas onto another InkCanvas. В этом примере предполагается:This example assumes:

  • Существует два InkCanvas объектов с именами inkCanvas1 и inkCanvas2.There are two InkCanvas objects called inkCanvas1 and inkCanvas2.

  • Событие Click было подключено к обработчику событий.The Click event has been connected to the event handler.

// 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 позволяет выполнять такие функции, как проверка попадания, обрезка и стирание штрихов.The StrokeCollection enables you to perform functions such as hit testing, clipping, and erasing strokes. Элемент управления InkCanvas выполняет многие из этих функций, но если требуется больший контроль, чем предоставляемый InkCanvas, StrokeCollection предлагает больше вариантов.The InkCanvas control performs many of these functions, but if you need more control than the InkCanvas provides, the StrokeCollection offers more options.

В следующей таблице приводятся сведения об управлении цифровым рукописным вводом в пользовательском элементе управления.The following table lists where to learn about managing digital ink on a custom control.

Для этого...To do this… См. эту статьюSee this article
Создание элемента управления для сбора цифровых рукописных данныхCreate a control that collects digital ink Создание элемента управления рукописным вводомCreating an Ink Input Control
Создание элемента управления, который позволяет пользователю выбрать рукописный вводCreate a control that enables the user to select ink Как выбрать рукописный ввод из пользовательского элемента управленияHow to: Select Ink from a Custom Control
Создание элемента управления, который позволяет пользователю выполнять точечную очистку рукописного вводаCreate a control that enables the user to point-erase ink Руководство. Стирание рукописного ввода в пользовательском элементе управленияHow to: Erase Ink on a Custom Control

Использование атрибута XAMLXAML Attribute Usage

<object StrokeCollection="isfString"/>  

Использование элемента объекта XAMLXAML Object Element Usage

<object>isfString</object>  

Значения XAMLXAML Values

ТерминTerm ОпределениеDefinition
isfString Строка, представляющая штрих в формате Base-64 с закодированным рукописным вводом (ISF).A string that represents the stroke in base-64, encoded Ink Serialized Format (ISF).

Конструкторы

StrokeCollection()

Инициализация нового экземпляра класса StrokeCollection.Initializes a new instance of the StrokeCollection class.

StrokeCollection(IEnumerable<Stroke>)

Инициализирует новый экземпляр класса StrokeCollection, который содержит заданные штрихи.Initializes a new instance of the StrokeCollection class that contains the specified strokes.

StrokeCollection(Stream)

Инициализирует коллекцию StrokeCollection из заданного потока Stream объектов в формате ISF.Initializes a StrokeCollection from the specified Stream of Ink Serialized Format (ISF).

Поля

InkSerializedFormat

Отражает встроенный формат сохранения данных рукописного текста.Represents the native persistence format for ink data.

Свойства

Count

Получает число элементов, фактически содержащихся в списке Collection<T>.Gets the number of elements actually contained in the Collection<T>.

(Унаследовано от Collection<T>)
Item[Int32]

Возвращает или задает элемент по указанному индексу.Gets or sets the element at the specified index.

(Унаследовано от Collection<T>)
Items

Получает оболочку IList<T> для Collection<T>.Gets a IList<T> wrapper around the Collection<T>.

(Унаследовано от Collection<T>)

Методы

Add(StrokeCollection)

Добавляет указанные штрихи в коллекцию StrokeCollection.Adds the specified strokes to the StrokeCollection.

Add(T)

Добавляет объект в конец очереди Collection<T>.Adds an object to the end of the Collection<T>.

(Унаследовано от Collection<T>)
AddPropertyData(Guid, Object)

Добавляет настраиваемое свойство в коллекцию StrokeCollection.Adds a custom property to the StrokeCollection.

Clear()

Удаляет все элементы из коллекции Collection<T>.Removes all elements from the Collection<T>.

(Унаследовано от Collection<T>)
ClearItems()

Очищает все штрихи из коллекции StrokeCollection.Clears all strokes from the StrokeCollection.

Clip(IEnumerable<Point>)

Удаляет из коллекции StrokeCollection все штрихи, которые выходят за границы заданного массива Point.Removes all strokes in the StrokeCollection that are outside the bounds of the specified Point array.

Clip(Rect)

Заменяет все штрихи, обрезанные заданным прямоугольником, новыми штрихами, которые не выходят за границы заданного прямоугольника.Replaces all strokes that are clipped by the specified rectangle with new strokes that do not extend beyond the specified rectangle.

Clone()

Копирует коллекцию StrokeCollection.Copies the StrokeCollection.

Contains(T)

Определяет, входит ли элемент в коллекцию Collection<T>.Determines whether an element is in the Collection<T>.

(Унаследовано от Collection<T>)
ContainsPropertyData(Guid)

Возвращает значение, которое указывает, содержится ли заданный идентификатор настраиваемого свойства в коллекции StrokeCollection.Returns whether the specified custom property identifier is in the StrokeCollection.

CopyTo(T[], Int32)

Копирует целый массив Collection<T> в совместимый одномерный массив Array, начиная с заданного индекса целевого массива.Copies the entire Collection<T> to a compatible one-dimensional Array, starting at the specified index of the target array.

(Унаследовано от Collection<T>)
Draw(DrawingContext)

Рисует штрихи, содержащиеся в коллекции StrokeCollection.Draws the strokes in the StrokeCollection.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Erase(IEnumerable<Point>)

Удаляет рукописный текст, который находится в границах заданной области.Removes the ink that is within the bounds of the specified area.

Erase(IEnumerable<Point>, StylusShape)

Заменяет все штрихи, обрезанные в области, которая была создана в результате перемещения заданного объекта StylusShape по указанному пути, новыми штрихами, которые не попадают в эту область.Replaces all strokes that are clipped by the region created by the specified StylusShape along the specified path with new Strokes that are not clipped by the region.

Erase(Rect)

Заменяет все штрихи, обрезанные заданным прямоугольником, на новые штрихи, которые не входят в границы заданного прямоугольника.Replaces all strokes that are clipped by the specified rectangle with new strokes that do not enter the bounds of the specified rectangle.

GetBounds()

Возвращает границы штрихов в коллекции.Returns the bounds of the strokes in the collection.

GetEnumerator()

Возвращает перечислитель, выполняющий итерацию Collection<T>.Returns an enumerator that iterates through the Collection<T>.

(Унаследовано от Collection<T>)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetIncrementalLassoHitTester(Int32)

Создает объект IncrementalLassoHitTester, который выполняет проверку касания для коллекции StrokeCollection с использованием пути, определенного лассо (произвольной линией).Creates an IncrementalLassoHitTester that hit tests the StrokeCollection with a lasso (freehand) path.

GetIncrementalStrokeHitTester(StylusShape)

Создает объект IncrementalStrokeHitTester, который выполняет проверку касания для коллекции StrokeCollection с использованием пути стирания.Creates an IncrementalStrokeHitTester that hit tests the StrokeCollection with an erasing path.

GetPropertyData(Guid)

Возвращает значение настраиваемого свойства, сопоставленного указанному идентификатору Guid.Returns the value of the custom property associated with the specified Guid.

GetPropertyDataIds()

Возвращает идентификаторы GUID всех пользовательских свойств, связанных с StrokeCollection.Returns the GUIDs of any custom properties associated with the StrokeCollection.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HitTest(IEnumerable<Point>, Int32)

Возвращает коллекцию штрихов, которые по меньшей мере частично попадают в указанную область.Returns a collection of strokes that have at least the specified percentage of length within the specified area.

HitTest(IEnumerable<Point>, StylusShape)

Возвращает коллекцию штрихов, пересекающих указанный путь.Returns a collection of strokes that intersect with the specified path.

HitTest(Point)

Возвращает коллекцию штрихов, пересекающих указанную точку.Returns a collection of strokes that intersect the specified point.

HitTest(Point, Double)

Возвращает коллекцию штрихов, пересекающих указанную область.Returns a collection of strokes that intersect the specified area.

HitTest(Rect, Int32)

Возвращает коллекцию штрихов, которые по меньшей мере частично попадают в указанный прямоугольник.Returns a collection of strokes that have at least the specified percentage of length within the specified rectangle.

IndexOf(Stroke)

Возвращает индекс заданного объекта Stroke в коллекции StrokeCollection.Returns the index of the specified Stroke in the StrokeCollection.

IndexOf(T)

Осуществляет поиск указанного объекта и возвращает отсчитываемый от нуля индекс первого вхождения, найденного в пределах всего списка Collection<T>.Searches for the specified object and returns the zero-based index of the first occurrence within the entire Collection<T>.

(Унаследовано от Collection<T>)
Insert(Int32, T)

Вставляет элемент в коллекцию Collection<T> по указанному индексу.Inserts an element into the Collection<T> at the specified index.

(Унаследовано от Collection<T>)
InsertItem(Int32, Stroke)

Вставляет штрих в коллекцию StrokeCollection по указанному индексу.Inserts a stroke into the StrokeCollection at the specified index.

InsertItem(Int32, T)

Вставляет элемент в коллекцию Collection<T> по указанному индексу.Inserts an element into the Collection<T> at the specified index.

(Унаследовано от Collection<T>)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnPropertyChanged(PropertyChangedEventArgs)

Происходит при изменении любого свойства StrokeCollection.Occurs when any StrokeCollection property changes.

OnPropertyDataChanged(PropertyDataChangedEventArgs)

Порождает событие PropertyDataChanged.Raises the PropertyDataChanged event.

OnStrokesChanged(StrokeCollectionChangedEventArgs)

Порождает событие StrokesChanged.Raises the StrokesChanged event.

Remove(StrokeCollection)

Удаляет заданные штрихи из коллекции.Removes the specified strokes from the collection.

Remove(T)

Удаляет первое вхождение указанного объекта из коллекции Collection<T>.Removes the first occurrence of a specific object from the Collection<T>.

(Унаследовано от Collection<T>)
RemoveAt(Int32)

Удаляет элемент по указанному индексу из коллекции Collection<T>.Removes the element at the specified index of the Collection<T>.

(Унаследовано от Collection<T>)
RemoveItem(Int32)

Удаляет штрих с заданным индексом из коллекции StrokeCollection.Removes the stroke at the specified index from the StrokeCollection.

RemovePropertyData(Guid)

Удаляет пользовательское свойство, связанное с указанным Guid.Removes the custom property associated with the specified Guid.

Replace(Stroke, StrokeCollection)

Заменяет указанный объект Stroke указанной коллекцией StrokeCollection.Replaces the specified Stroke with the specified StrokeCollection.

Replace(StrokeCollection, StrokeCollection)

Заменяет указанную коллекцию StrokeCollection новой коллекцией StrokeCollection.Replaces the specified StrokeCollection with a new StrokeCollection.

Save(Stream)

Сохраняет коллекцию StrokeCollection в заданный поток Stream.Saves the StrokeCollection to the specified Stream.

Save(Stream, Boolean)

Сохраняет коллекцию StrokeCollection в заданный поток Stream и выполняет ее сжатие, если указан соответствующий параметр.Saves the StrokeCollection to the specified Stream and compresses it, when specified.

SetItem(Int32, Stroke)

Заменяет росчерк по указанному индексу.Replaces the stroke at the specified index.

SetItem(Int32, T)

Заменяет элемент по указанному индексу.Replaces the element at the specified index.

(Унаследовано от Collection<T>)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
Transform(Matrix, Boolean)

Изменяет каждый из объектов StylusPoints, а также свойство StylusTipTransform (необязательно) для каждого штриха в коллекции StrokeCollection в соответствии с заданным объектом Matrix.Modifies each of the StylusPoints and optionally the StylusTipTransform for each stroke in the StrokeCollection according to the specified Matrix.

События

PropertyDataChanged

Происходит при добавлении настраиваемого свойства в коллекцию StrokeCollection или при удалении такого свойства из нее.Occurs when custom property is added or removed from the StrokeCollection.

StrokesChanged

Происходит при изменении объекта Stroke в коллекции.Occurs when a Stroke in the collection changes.

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)

Копирует элементы коллекции ICollection в массив Array, начиная с указанного индекса массива Array.Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Унаследовано от Collection<T>)
ICollection.IsSynchronized

Возвращает значение, показывающее, является ли доступ к коллекции ICollection синхронизированным (потокобезопасным).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Унаследовано от Collection<T>)
ICollection.SyncRoot

Получает объект, с помощью которого можно синхронизировать доступ к коллекции ICollection.Gets an object that can be used to synchronize access to the ICollection.

(Унаследовано от Collection<T>)
ICollection<T>.IsReadOnly

Возвращает значение, указывающее, является ли ICollection<T> доступным только для чтения.Gets a value indicating whether the ICollection<T> is read-only.

(Унаследовано от Collection<T>)
IEnumerable.GetEnumerator()

Возвращает перечислитель для прохода по коллекции.Returns an enumerator that iterates through a collection.

(Унаследовано от Collection<T>)
IList.Add(Object)

Добавляет элемент в коллекцию IList.Adds an item to the IList.

(Унаследовано от Collection<T>)
IList.Contains(Object)

Определяет, содержит ли коллекция IList указанное значение.Determines whether the IList contains a specific value.

(Унаследовано от Collection<T>)
IList.IndexOf(Object)

Определяет индекс заданного элемента в списке IList.Determines the index of a specific item in the IList.

(Унаследовано от Collection<T>)
IList.Insert(Int32, Object)

Вставляет элемент в IList по указанному индексу.Inserts an item into the IList at the specified index.

(Унаследовано от Collection<T>)
IList.IsFixedSize

Получает значение, указывающее, имеет ли список IList фиксированный размер.Gets a value indicating whether the IList has a fixed size.

(Унаследовано от Collection<T>)
IList.IsReadOnly

Возвращает значение, указывающее, является ли IList доступным только для чтения.Gets a value indicating whether the IList is read-only.

(Унаследовано от Collection<T>)
IList.Item[Int32]

Возвращает или задает элемент по указанному индексу.Gets or sets the element at the specified index.

(Унаследовано от Collection<T>)
IList.Remove(Object)

Удаляет первое вхождение указанного объекта из коллекции IList.Removes the first occurrence of a specific object from the IList.

(Унаследовано от Collection<T>)
INotifyCollectionChanged.CollectionChanged

Происходит при изменении свойства StrokeCollection.Occurs when the StrokeCollection changes.

INotifyPropertyChanged.PropertyChanged

Происходит при изменении значения любого свойства StrokeCollection.Occurs when the value of any StrokeCollection property has changed.

Методы расширения

CopyToDataTable<T>(IEnumerable<T>)

Возвращает объект DataTable, содержащий копии объектов DataRow при заданном входном объекте IEnumerable<T> и универсальном параметре T, равном DataRow.Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр T имеет значение DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр T имеет значение DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Возвращает коллекцию элементов, содержащую предков каждого узла в исходной коллекции.Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName)

Возвращает отфильтрованную коллекцию элементов, содержащую предков каждого узла в исходной коллекции.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Возвращает коллекцию подчиненных узлов каждого документа и элемента в исходной коллекции.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Возвращает коллекцию элементов, содержащую подчиненные элементы каждого элемента и документа в исходной коллекции.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName)

Возвращает отфильтрованную коллекцию элементов, содержащую подчиненные элементы каждого элемента и документа в исходной коллекции.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Возвращает коллекцию дочерних элементов каждого элемента и документа в исходной коллекции.Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName)

Возвращает отфильтрованную коллекцию дочерних элементов каждого элемента и документа в исходной коллекции.Returns a filtered collection of the child elements of every element and document in the source collection. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Возвращает коллекцию узлов, содержащую все узлы в исходной коллекции, отсортированные в порядке следования документов.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Возвращает коллекцию дочерних узлов каждого документа и элемента в исходной коллекции.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Удаление каждого узла в исходной коллекции из родительского узла.Removes every node in the source collection from its parent node.

Применяется к