CoerceValueCallback CoerceValueCallback CoerceValueCallback CoerceValueCallback Delegate

Определение

Предоставляет шаблон для метода, вызываемого при оценке значения свойства зависимостей и запросе запрета изменения значения.Provides a template for a method that is called whenever a dependency property value is being re-evaluated, or coercion is specifically requested.

public delegate System::Object ^ CoerceValueCallback(DependencyObject ^ d, System::Object ^ baseValue);
public delegate object CoerceValueCallback(DependencyObject d, object baseValue);
type CoerceValueCallback = delegate of DependencyObject * obj -> obj
Public Delegate Function CoerceValueCallback(d As DependencyObject, baseValue As Object) As Object 

Параметры

d
DependencyObject DependencyObject DependencyObject DependencyObject

Объект, содержащий свойство.The object that the property exists on. При вызове ответа, система свойств передает это значение.When the callback is invoked, the property system will pass this value.

baseValue
Object Object Object Object

Новое значение свойства до применения операции запрета изменения значения.The new value of the property, prior to any coercion attempt.

Возвращаемое значение

System.Object

Запрещенное значение (с соответствующим типом).The coerced value (with appropriate type).

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

Примеры

Следующий пример содержит реализацию этого обратного вызова для запрета хранимого значения свойства зависимостей на основе других входных данных, например значение другого свойства.The following example includes an implementation of this callback to coerce the stored value of a dependency property based on other inputs, such as another property's value. В этом случае обратный вызов проверяет, ли ShirtType свойства соответствует типу объекта, содержащего кнопки; Если Да, она устанавливает начальный цвет по умолчанию для ButtonColor, если кнопки не типа "рубашка", он преобразует ButtonColor значение к начальному значению, что вызывает ИПUI (не показано) для удаления выпадающего меню из эффективных выборов.In this case, the callback checks to see whether the ShirtType property corresponds to a type of shirt that has buttons; if so it establishes a starting default color for the ButtonColor, if the shirt type has no buttons, it coerces the ButtonColor value back to a starting value, which causes the ИПUI (not shown) to remove that dropdown from the effective choices.

private static object CoerceButtonColor(DependencyObject d, object value)
{
	ShirtTypes newShirtType = (d as Shirt).ShirtType;
	if (newShirtType == ShirtTypes.Dress || newShirtType == ShirtTypes.Bowling)
	{
		return ButtonColors.Black;				
	}
	return ButtonColors.None;
}
Private Shared Function CoerceButtonColor(ByVal d As DependencyObject, ByVal value As Object) As Object
	Dim newShirtType As ShirtTypes = (TryCast(d, Shirt)).ShirtType
	If newShirtType = ShirtTypes.Dress OrElse newShirtType = ShirtTypes.Bowling Then
		Return ButtonColors.Black
	End If
	Return ButtonColors.None
End Function

Комментарии

На основе обратных вызовов CoerceValueCallback можно назначить свойству зависимостей через несколькими способами.Callbacks based on CoerceValueCallback can be assigned to a dependency property through several different techniques. Каждый из этих способов необходимо сначала создать объект метаданных свойств (PropertyMetadata, или производного класса, например FrameworkPropertyMetadata).Each of these techniques requires that you first create a new property metadata object (PropertyMetadata, or a derived class such as FrameworkPropertyMetadata). Создать объект метаданных, используя подпись конструктор, принимающий coerceValueCallback параметра и назначить этому параметру в обработчике обратного вызова.Create the metadata object using a constructor signature that takes the coerceValueCallback parameter, and assign that parameter to your callback handler. Или создать метаданные любые подписи, причем CoerceValueCallback свойство до помещения метаданных используется.Or construct the metadata by any signature and set the CoerceValueCallback property prior to putting the metadata in use.

Если у вас есть эти метаданные, вы можете:When you have this metadata, you can:

  • Определение нового свойства зависимости на новый класс, используя либо подпись Register, предоставляя метаданные в виде typeMetadata значение.Define a new dependency property on a new class, using either signature of Register, giving the metadata as the typeMetadata value.

  • Переопределить метаданные (вызвать OverrideMetadata(Type, PropertyMetadata)) для существующего свойства зависимости, при наследовании от класса, которому принадлежит свойство зависимостей.Override the metadata (call OverrideMetadata(Type, PropertyMetadata)) for an existing dependency property, when you derive from the class that owns the dependency property.

  • Добавление существующего свойства зависимостей в новый DependencyObject класса, с помощью новых метаданных путем вызова AddOwner(Type, PropertyMetadata).Add an existing dependency property to a new DependencyObject class, using new metadata, by calling AddOwner(Type, PropertyMetadata).

Реализации данного ответа следует проверить значение baseValue и определить на основе значения или тип ли это значение необходимо для дальнейшей привести.Implementations of this callback should check the value in baseValue and determine based on either the value or the type whether this is a value that needs to be further coerced.

CoerceValueCallback Зависимости свойство вызывается каждый раз, когда система свойств или любой вызывающий объект вызывает CoerceValue на DependencyObject экземпляр, указав идентификатор этого свойства как dp.The CoerceValueCallback for a dependency property is invoked any time that the property system or any other caller calls CoerceValue on a DependencyObject instance, specifying that property's identifier as the dp.

Изменение значения свойства могут поступать любого из членов системы свойств.Changes to the property value may have come from any possible participant in the property system. Это включает стили, изначальную, триггеры, наследование значения свойства и локальное значение параметра.This includes styles, generic invalidation, triggers, property value inheritance, and local value setting.

Обычно следует избегать, указание более одного CoerceValueCallback для любого заданного свойства зависимостей (переопределения или добавления новых метаданных свойства зависимости, которое уже есть CoerceValueCallback).Generally you should avoid specifying more than one CoerceValueCallback for any given dependency property (overriding or adding with new metadata for a dependency property that already had a CoerceValueCallback). Только один из обратных вызовов, будет действовать. Действующим ответом будет тот, который был применен к наиболее производного класса в наследовании по сравнению с DependencyObject вызывающего объекта.Only one of the callbacks will be able to act. The acting callback will be the one that was applied to the most derived class in the inheritance as compared to the DependencyObject caller. При переопределении метаданных, заменяются другие обратные вызовы, связанные с метаданными для свойства зависимостей, существовавшего выше в иерархии владельцев.Other callbacks as assigned to metadata for the dependency property as it existed higher in the owner hierarchy are replaced when the metadata is overridden.

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

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.Gets an object that represents the method represented by the specified delegate.

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

Дополнительно