diff --git a/dotnet-desktop-guide/net/wpf/properties/attached-properties-overview.md b/dotnet-desktop-guide/net/wpf/properties/attached-properties-overview.md index d1690430a7..12323bd191 100644 --- a/dotnet-desktop-guide/net/wpf/properties/attached-properties-overview.md +++ b/dotnet-desktop-guide/net/wpf/properties/attached-properties-overview.md @@ -15,6 +15,8 @@ helpviewer_keywords: An attached property is a Extensible Application Markup Language (XAML) concept. Attached properties enable extra property/value pairs to be set on any XAML element, even though the element doesn't define those extra properties in its object model. The extra properties are globally accessible. Attached properties are typically defined as a specialized form of dependency property that doesn't have a conventional property wrapper. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Prerequisites The article assumes a basic knowledge of dependency properties, and that you've read [Dependency properties overview](dependency-properties-overview.md). To follow the examples in this article, it helps if you're familiar with XAML and know how to write Windows Presentation Foundation (WPF) applications. diff --git a/dotnet-desktop-guide/net/wpf/properties/collection-type-dependency-properties.md b/dotnet-desktop-guide/net/wpf/properties/collection-type-dependency-properties.md index 2a0e88f8d9..d7d1de9775 100644 --- a/dotnet-desktop-guide/net/wpf/properties/collection-type-dependency-properties.md +++ b/dotnet-desktop-guide/net/wpf/properties/collection-type-dependency-properties.md @@ -17,6 +17,12 @@ helpviewer_keywords: This article provides guidance and suggested patterns for implementing a dependency property that's a collection type. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + +## Prerequisites + +The article assumes a basic knowledge of dependency properties, and that you've read [Dependency properties overview](dependency-properties-overview.md). To follow the examples in this article, it helps if you're familiar with Extensible Application Markup Language (XAML) and know how to write WPF applications. + ## Implement a collection-type dependency property In general, the implementation pattern for a dependency property is a CLR property wrapper backed by a identifier instead of a field or other construct. You can follow the same pattern when you implement a collection-type dependency property. The pattern is more complex if the collection element type is a or a derived class. diff --git a/dotnet-desktop-guide/net/wpf/properties/custom-dependency-properties.md b/dotnet-desktop-guide/net/wpf/properties/custom-dependency-properties.md index 9aec98d447..7743be0610 100644 --- a/dotnet-desktop-guide/net/wpf/properties/custom-dependency-properties.md +++ b/dotnet-desktop-guide/net/wpf/properties/custom-dependency-properties.md @@ -22,6 +22,8 @@ helpviewer_keywords: Windows Presentation Foundation (WPF) application developers and component authors can create custom dependency properties to extend the functionality of their properties. Unlike a common language runtime (CLR) [property](/dotnet/standard/base-types/common-type-system#properties), a dependency property adds support for styling, data binding, inheritance, animations, and default values. , , and are examples of existing dependency properties in WPF classes. This article describes how to implement custom dependency properties, and presents options for improving performance, usability, and versatility. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Prerequisites The article assumes a basic knowledge of dependency properties, and that you've read [Dependency properties overview](dependency-properties-overview.md). To follow the examples in this article, it helps if you're familiar with Extensible Application Markup Language (XAML) and know how to write WPF applications. diff --git a/dotnet-desktop-guide/net/wpf/properties/dependency-property-callbacks-and-validation.md b/dotnet-desktop-guide/net/wpf/properties/dependency-property-callbacks-and-validation.md index d7b77b8e45..2b158a2a91 100644 --- a/dotnet-desktop-guide/net/wpf/properties/dependency-property-callbacks-and-validation.md +++ b/dotnet-desktop-guide/net/wpf/properties/dependency-property-callbacks-and-validation.md @@ -18,6 +18,8 @@ helpviewer_keywords: This article describes how to define a dependency property and implement dependency property callbacks. The callbacks support value validation, value coercion, and other logic that's needed when a property value changes. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Prerequisites The article assumes a basic knowledge of dependency properties, and that you've read [Dependency properties overview](dependency-properties-overview.md). To follow the examples in this article, it helps if you're familiar with Extensible Application Markup Language (XAML) and know how to write WPF applications. diff --git a/dotnet-desktop-guide/net/wpf/properties/dependency-property-metadata.md b/dotnet-desktop-guide/net/wpf/properties/dependency-property-metadata.md index bff2d7f424..07acb4396b 100644 --- a/dotnet-desktop-guide/net/wpf/properties/dependency-property-metadata.md +++ b/dotnet-desktop-guide/net/wpf/properties/dependency-property-metadata.md @@ -14,6 +14,8 @@ helpviewer_keywords: The Windows Presentation Foundation (WPF) property system includes a dependency property metadata reporting system. The information available through the metadata reporting system exceeds what is available through reflection or general common language runtime (CLR) characteristics. When you register a dependency property, you have the option to create and assign metadata to it. If you derive from a class that defines a dependency property, you can override the metadata for the inherited dependency property. And, if you add your class as an owner of a dependency property, you can override the metadata of the inherited dependency property. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Prerequisites The article assumes a basic knowledge of dependency properties, and that you've read [Dependency properties overview](dependency-properties-overview.md). To follow the examples in this article, it helps if you're familiar with Extensible Application Markup Language (XAML) and know how to write WPF applications. diff --git a/dotnet-desktop-guide/net/wpf/properties/dependency-property-value-precedence.md b/dotnet-desktop-guide/net/wpf/properties/dependency-property-value-precedence.md index 88ffa804aa..c5b956cb08 100644 --- a/dotnet-desktop-guide/net/wpf/properties/dependency-property-value-precedence.md +++ b/dotnet-desktop-guide/net/wpf/properties/dependency-property-value-precedence.md @@ -14,6 +14,8 @@ helpviewer_keywords: The workings of the Windows Presentation Foundation (WPF) property system affect the value of a dependency property. This article explains how the precedence of different property-based inputs within the WPF property system determines the effective value of a dependency property. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Prerequisites The article assumes a basic knowledge of dependency properties, and that you've read [Dependency properties overview](dependency-properties-overview.md). To follow the examples in this article, it helps if you're familiar with Extensible Application Markup Language (XAML) and know how to write WPF applications. diff --git a/dotnet-desktop-guide/net/wpf/properties/how-to-implement-a-dependency-property.md b/dotnet-desktop-guide/net/wpf/properties/how-to-implement-a-dependency-property.md index afe80eb6fc..6476b49af0 100644 --- a/dotnet-desktop-guide/net/wpf/properties/how-to-implement-a-dependency-property.md +++ b/dotnet-desktop-guide/net/wpf/properties/how-to-implement-a-dependency-property.md @@ -14,7 +14,9 @@ helpviewer_keywords: # How to implement a dependency property (WPF .NET) This article describes how to implement a dependency property by using a field to back a common language runtime (CLR) property. Dependency properties support several advanced Windows Presentation Foundation (WPF) property system features. These features include styles, data binding, inheritance, animation, and default values. If you want properties that you define to support those features, then implement your properties as a dependency property. - + +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Example The following example shows how to register a dependency property, by calling the method. The `Register` method returns a instance called a *dependency property identifier*. The identifier is stored in a `static readonly` field, and holds the name and characteristics of a dependency property. diff --git a/dotnet-desktop-guide/net/wpf/properties/how-to-override-metadata-for-a-dependency-property.md b/dotnet-desktop-guide/net/wpf/properties/how-to-override-metadata-for-a-dependency-property.md index 6bbb81dd88..913d22be2f 100644 --- a/dotnet-desktop-guide/net/wpf/properties/how-to-override-metadata-for-a-dependency-property.md +++ b/dotnet-desktop-guide/net/wpf/properties/how-to-override-metadata-for-a-dependency-property.md @@ -16,6 +16,8 @@ helpviewer_keywords: When you derive from a class that defines a dependency property, you inherit the dependency property and its metadata. This article describes how you can override the metadata of an inherited dependency property by calling the method. Overriding the metadata lets you modify characteristics of the inherited dependency property to match subclass-specific requirements. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Background A class that defines a dependency property can specify its characteristics in or one of its derived types, such as . One of those characteristics is the default value of a dependency property. Many classes that define dependency properties, specify property metadata during dependency property registration. When metadata isn't specified during registration, the WPF property system assigns a `PropertyMetadata` object with default values. Derived classes that inherit dependency properties through class inheritance have the option to override the original metadata of any dependency property. In this way, derived classes can selectively modify dependency property characteristics to meet class requirements. When calling , a derived class specifies its own type as the first parameter, and a metadata instance as the second parameter. diff --git a/dotnet-desktop-guide/net/wpf/properties/how-to-register-an-attached-property.md b/dotnet-desktop-guide/net/wpf/properties/how-to-register-an-attached-property.md index 94396cdb6c..1a7cd74815 100644 --- a/dotnet-desktop-guide/net/wpf/properties/how-to-register-an-attached-property.md +++ b/dotnet-desktop-guide/net/wpf/properties/how-to-register-an-attached-property.md @@ -15,6 +15,8 @@ helpviewer_keywords: This article describes how to register an attached property and provide public accessors that let you access the attached property through Extensible Application Markup Language (XAML) and code. Attached properties enable extra property/value pairs to be set on any XAML element, even though the element doesn't define those extra properties in its object model. The extra properties are globally accessible. Attached properties are typically defined as a specialized form of dependency property that doesn't have a conventional property wrapper. Most attached properties for Windows Presentation Foundation (WPF) types are also implemented as dependency properties. You can create dependency properties on any derived type. +[!INCLUDE [desktop guide under construction](../../includes/desktop-guide-preview-note.md)] + ## Example The following example shows how to register an attached property as a dependency property, by using the method. The provider class has the option of specifying a default value in property metadata. For more information on property metadata, see [Property metadata for a new dependency property](/dotnet/desktop/wpf/advanced/custom-dependency-properties?view=netframeworkdesktop-4.8&preserve-view=true#property-metadata-for-a-new-dependency-property). In this example, the `HasFish` property has a value type, with its default value set to `false`.