GradientStopCollection Класс

Определение

Пространство имен:

System.Windows.Media

Сборка:

PresentationCore.dll

Представляет коллекцию объектов, к которым можно получить отдельный GradientStop доступ по индексу.

public ref class GradientStopCollection sealed : System::Windows::Media::Animation::Animatable, IFormattable, System::Collections::Generic::ICollection<System::Windows::Media::GradientStop ^>, System::Collections::Generic::IEnumerable<System::Windows::Media::GradientStop ^>, System::Collections::Generic::IList<System::Windows::Media::GradientStop ^>, System::Collections::IList

public sealed class GradientStopCollection : System.Windows.Media.Animation.Animatable, IFormattable, System.Collections.Generic.ICollection<System.Windows.Media.GradientStop>, System.Collections.Generic.IEnumerable<System.Windows.Media.GradientStop>, System.Collections.Generic.IList<System.Windows.Media.GradientStop>, System.Collections.IList

type GradientStopCollection = class
    inherit Animatable
    interface ICollection<GradientStop>
    interface seq<GradientStop>
    interface IEnumerable
    interface IList<GradientStop>
    interface ICollection
    interface IList
    interface IFormattable

Public NotInheritable Class GradientStopCollection
Inherits Animatable
Implements ICollection(Of GradientStop), IEnumerable(Of GradientStop), IFormattable, IList, IList(Of GradientStop)

Наследование

Object

DispatcherObject

DependencyObject

Freezable

Animatable

GradientStopCollection

Реализации

ICollection<GradientStop> ICollection<T> IEnumerable<GradientStop> IEnumerable<T> IList<GradientStop> ICollection IEnumerable IList IFormattable

Комментарии

GradientStopCollection используется классами GradientBrush для хранения GradientStop информации.

Кроме того, как отмечалось, члены этого класса ведут себя точно так же, как описано в IList<T>разделе , ICollection<T>и IEnumerable<T> документации.

Функции, доступные для освобождения: Так как он наследует от Freezable класса, класс предоставляет несколько специальных функций: GradientStopCollectionGradientStopCollection объекты можно объявлять как ресурсы, совместно используемые для нескольких объектов, сделать доступными только для чтения, чтобы повысить производительность, клонировать и сделать потокобезопасной. Дополнительные сведения о различных функциях, предоставляемых Freezable объектами, см. в обзоре объектов Freezable.

Использование неявной коллекции XAML

<object>
  <object.property>
    oneOrMoreGradientStopObjectElements
  </object.property>
</object>

Значения XAML

oneOrMoreGradientStopObjectElements Один или несколько GradientStop объектов, объявленных с помощью синтаксиса элемента объекта.

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

Имя	Описание
GradientStopCollection()	Инициализирует новый экземпляр класса GradientStopCollection.
GradientStopCollection(IEnumerable<GradientStop>)	Инициализирует новый экземпляр GradientStopCollection класса, который содержит элементы в указанной коллекции.
GradientStopCollection(Int32)	Инициализирует новый экземпляр GradientStopCollection класса, который изначально способен хранить указанное количество элементов.

Свойства

Имя	Описание
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
Count	Возвращает количество элементов, содержащихся в объекте GradientStopCollection.
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Item[Int32]	Возвращает или задает заданный GradientStop отсчитываемый от нуля индекс.

Методы

Имя	Описание
Add(GradientStop)	Добавляет коллекцию GradientStop стоп-градиентов.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClockDependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClockDependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
Clear()	Удаляет все элементы из списка стоп-градиентов.
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает модификаторный клон этого GradientStopCollectionобъекта, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения.
CloneCore(Freezable)	Делает экземпляр клоном (глубокой копией) указанных Freezable значений свойств с использованием базовых (не анимированных) значений свойств. (Унаследовано от Freezable)
CloneCurrentValue()	Создает модификаторный клон этого объекта, делая глубокие копии текущих значений этого GradientStopCollection объекта. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения.
CloneCurrentValueCore(Freezable)	Делает экземпляр модификируемым клоном (глубокой копией) указанного Freezable с использованием текущих значений свойств. (Унаследовано от Freezable)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
Contains(GradientStop)	Определяет, содержит ли коллекция указанный GradientStopобъект.
CopyTo(GradientStop[], Int32)	Копирует весь GradientStopCollection в совместимую одномерную Array, начиная с указанного индекса целевого массива.
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozentrue. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает этот Animatable объект неизменяемым или определяет, может ли он быть изменен. (Унаследовано от Animatable)
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает экземпляр замороженным клоном указанных Freezable значений свойств (не анимированных). (Унаследовано от Freezable)
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает текущий экземпляр замороженным клоном указанного Freezable. Если объект имеет анимированные свойства зависимостей, их текущие анимированные значения копируются. (Унаследовано от Freezable)
GetEnumerator()	Возвращает перечислитель, который может выполнять итерацию по коллекции.
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
IndexOf(GradientStop)	Возвращает отсчитываемый от нуля индекс указанного GradientStop.
Insert(Int32, GradientStop)	Вставляет значение GradientStop в указанное положение в списке стоп-градиентов.
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
OnChanged()	Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
Parse(String)	String Преобразует представление GradientStopCollection в эквивалентGradientStopCollection.
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)
Remove(GradientStop)	Удаляет первое вхождение указанного GradientStop из этого GradientStopCollectionпараметра.
RemoveAt(Int32)	GradientStop Удаляет из этого GradientStopCollectionуказанного индекса.
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	String Создает представление этого GradientStopCollectionобъекта.
ToString(IFormatProvider)	String Создает представление этого GradientStopCollectionобъекта.
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)

События

Имя	Описание
Changed	Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable)

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

Имя	Описание
ICollection.CopyTo(Array, Int32)	Описание этого элемента см. в разделе CopyTo(Array, Int32).
ICollection.IsSynchronized	Описание этого элемента см. в разделе IsSynchronized.
ICollection.SyncRoot	Описание этого элемента см. в разделе SyncRoot.
ICollection<GradientStop>.IsReadOnly	Описание этого элемента см. в разделе IsSynchronized.
IEnumerable.GetEnumerator()	Описание этого элемента см. в разделе GetEnumerator().
IEnumerable<GradientStop>.GetEnumerator()	Описание этого элемента см. в разделе GetEnumerator().
IFormattable.ToString(String, IFormatProvider)	Описание этого элемента см. в разделе ToString(String, IFormatProvider).
IList.Add(Object)	Описание этого элемента см. в разделе Add(Object).
IList.Contains(Object)	Описание этого элемента см. в разделе Contains(Object).
IList.IndexOf(Object)	Описание этого элемента см. в разделе IndexOf(Object).
IList.Insert(Int32, Object)	Описание этого элемента см. в разделе Insert(Int32, Object).
IList.IsFixedSize	Описание этого элемента см. в разделе IsFixedSize.
IList.IsReadOnly	Описание этого элемента см. в разделе IsReadOnly.
IList.Item[Int32]	Описание этого элемента см. в разделе Item[Int32].
IList.Remove(Object)	Описание этого элемента см. в разделе Remove(Object).

См. также раздел

• LinearGradientBrush
• RadialGradientBrush
• GradientStops
• IList<T>
• ICollection<T>
• IEnumerable<T>
• Пример кистей