diff --git a/xml/System.Windows.Diagnostics/ResourceDictionaryDiagnostics.xml b/xml/System.Windows.Diagnostics/ResourceDictionaryDiagnostics.xml index 16ae1efc6d9..37f721ac2ef 100644 --- a/xml/System.Windows.Diagnostics/ResourceDictionaryDiagnostics.xml +++ b/xml/System.Windows.Diagnostics/ResourceDictionaryDiagnostics.xml @@ -23,11 +23,11 @@ Enables enumeration of generic and themed instances, and provides a notification infrastructure for listening to the loading and unloading of instances. - @@ -242,11 +242,11 @@ Occurs when a static resource reference is resolved. - object with information about the event. - + object with information about the event. + ]]> diff --git a/xml/System.Windows.Documents.DocumentStructures/FigureStructure.xml b/xml/System.Windows.Documents.DocumentStructures/FigureStructure.xml index 89532a9403d..2c58007e06e 100644 --- a/xml/System.Windows.Documents.DocumentStructures/FigureStructure.xml +++ b/xml/System.Windows.Documents.DocumentStructures/FigureStructure.xml @@ -34,26 +34,26 @@ Represents a drawing, chart, or diagram in a document. - can be a child of any of these document structure elements: - -- - -- - -- - -- - - - -## Examples - The following example shows use of the element as part of an XPS document. - - :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage2_structure.xaml" id="Snippetdocstructstoryfragcontent2"::: - + can be a child of any of these document structure elements: + +- + +- + +- + +- + + + +## Examples + The following example shows use of the element as part of an XPS document. + + :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage2_structure.xaml" id="Snippetdocstructstoryfragcontent2"::: + ]]> @@ -208,15 +208,15 @@ The child to add. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. - . - - Only can be a child of . If there are multiple children, they should together constitute a single drawing, chart, or diagram. - + . + + Only can be a child of . If there are multiple children, they should together constitute a single drawing, chart, or diagram. + ]]> diff --git a/xml/System.Windows.Documents.DocumentStructures/ListStructure.xml b/xml/System.Windows.Documents.DocumentStructures/ListStructure.xml index 3c7678b69d0..45f2fb7cac4 100644 --- a/xml/System.Windows.Documents.DocumentStructures/ListStructure.xml +++ b/xml/System.Windows.Documents.DocumentStructures/ListStructure.xml @@ -34,19 +34,19 @@ Represents a list of items in a document. - can be a child of the following document structure elements: - -- - -- - -- - -- (when the list is nested in an outer list) - + can be a child of the following document structure elements: + +- + +- + +- + +- (when the list is nested in an outer list) + ]]> @@ -201,15 +201,15 @@ The child that is added. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. - . - - Only can be a child of and there must be at least one child. - + . + + Only can be a child of and there must be at least one child. + ]]> diff --git a/xml/System.Windows.Documents.DocumentStructures/ParagraphStructure.xml b/xml/System.Windows.Documents.DocumentStructures/ParagraphStructure.xml index 038eac947b7..142804486cc 100644 --- a/xml/System.Windows.Documents.DocumentStructures/ParagraphStructure.xml +++ b/xml/System.Windows.Documents.DocumentStructures/ParagraphStructure.xml @@ -34,26 +34,26 @@ Represents a paragraph in a document. - can be a child of any of these document structure elements: - -- - -- - -- - -- - - - -## Examples - The following example shows the `` part of an XML Paper Specification (XPS) document. - - :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage2_structure.xaml" id="Snippetdocstructparastruct2"::: - + can be a child of any of these document structure elements: + +- + +- + +- + +- + + + +## Examples + The following example shows the `` part of an XML Paper Specification (XPS) document. + + :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage2_structure.xaml" id="Snippetdocstructparastruct2"::: + ]]> @@ -208,15 +208,15 @@ The child that is added. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. - . - - Only can be a child of . - + . + + Only can be a child of . + ]]> diff --git a/xml/System.Windows.Documents.DocumentStructures/StoryFragment.xml b/xml/System.Windows.Documents.DocumentStructures/StoryFragment.xml index 9fd639909e5..0adfb4d9bf2 100644 --- a/xml/System.Windows.Documents.DocumentStructures/StoryFragment.xml +++ b/xml/System.Windows.Documents.DocumentStructures/StoryFragment.xml @@ -446,7 +446,7 @@ The child that is added. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. Represents a set of one or more rows in a table. - can only have a as a parent. - - - -## Examples - The following example shows the `` part of an XML Paper Specification (XPS) document. - - :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage1_structure.xaml" id="Snippetdocstructtablestruct1"::: - + can only have a as a parent. + + + +## Examples + The following example shows the `` part of an XML Paper Specification (XPS) document. + + :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage1_structure.xaml" id="Snippetdocstructtablestruct1"::: + ]]> @@ -200,15 +200,15 @@ The child that is added. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. - . - - Only can be a child of and there must be at least one child. - + . + + Only can be a child of and there must be at least one child. + ]]> diff --git a/xml/System.Windows.Documents.DocumentStructures/TableRowStructure.xml b/xml/System.Windows.Documents.DocumentStructures/TableRowStructure.xml index 053e6b18527..cf429808eb3 100644 --- a/xml/System.Windows.Documents.DocumentStructures/TableRowStructure.xml +++ b/xml/System.Windows.Documents.DocumentStructures/TableRowStructure.xml @@ -34,18 +34,18 @@ Represents a row of one or more cells in a table. - can be the parent of a . - - - -## Examples - The following example shows the `` part of an XML Paper Specification (XPS) document. - - :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage1_structure.xaml" id="Snippetdocstructtablestruct1"::: - + can be the parent of a . + + + +## Examples + The following example shows the `` part of an XML Paper Specification (XPS) document. + + :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage1_structure.xaml" id="Snippetdocstructtablestruct1"::: + ]]> @@ -200,15 +200,15 @@ The child that is added. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. - . - - Only can be a child of and there must be at least one child. - + . + + Only can be a child of and there must be at least one child. + ]]> diff --git a/xml/System.Windows.Documents.DocumentStructures/TableStructure.xml b/xml/System.Windows.Documents.DocumentStructures/TableStructure.xml index f1190c9548a..39473799370 100644 --- a/xml/System.Windows.Documents.DocumentStructures/TableStructure.xml +++ b/xml/System.Windows.Documents.DocumentStructures/TableStructure.xml @@ -34,26 +34,26 @@ Represents a table in a document. - can be a child of any of these document structure elements: - -- - -- - -- (when the table is nested in an outer table) - -- - - - -## Examples - The following example shows the `` part of an XML Paper Specification (XPS) document. - - :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage1_structure.xaml" id="Snippetdocstructtablestruct1"::: - + can be a child of any of these document structure elements: + +- + +- + +- (when the table is nested in an outer table) + +- + + + +## Examples + The following example shows the `` part of an XML Paper Specification (XPS) document. + + :::code language="xaml" source="~/snippets/csharp/System.Windows.Documents.DocumentStructures/FigureStructure/Overview/Content/FixedPage1_structure.xaml" id="Snippetdocstructtablestruct1"::: + ]]> @@ -209,15 +209,15 @@ The child that is added. - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This member supports the .NET infrastructure and is not intended to be used directly from your code. - . - - Only a can be a child of and there must be at least one child. - + . + + Only a can be a child of and there must be at least one child. + ]]> diff --git a/xml/System.Windows.Documents/PageContentCollection.xml b/xml/System.Windows.Documents/PageContentCollection.xml index 815373bf18b..b5ab65c7bfb 100644 --- a/xml/System.Windows.Documents/PageContentCollection.xml +++ b/xml/System.Windows.Documents/PageContentCollection.xml @@ -196,7 +196,7 @@ - This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. Use the type-safe method instead. + This member supports the .NET infrastructure and is not intended to be used directly from your code. Use the type-safe method instead. The enumerator. To be added. diff --git a/xml/System.Windows/Application.xml b/xml/System.Windows/Application.xml index 6e51fd2190c..22ac4d7572f 100644 --- a/xml/System.Windows/Application.xml +++ b/xml/System.Windows/Application.xml @@ -1774,8 +1774,6 @@ For more information about XBAP support, see [Frequently asked questions about W This property is thread safe and is available from any thread. - is introduced in the .NET Framework version 3.5. For more information, see [Versions and Dependencies](/dotnet/framework/migration-guide/versions-and-dependencies). - ]]> A WPF application has an entry assembly, or has already been set. diff --git a/xml/System.Windows/AttachedPropertyBrowsableAttribute.xml b/xml/System.Windows/AttachedPropertyBrowsableAttribute.xml index b0a22d40906..98b7c1d875b 100644 --- a/xml/System.Windows/AttachedPropertyBrowsableAttribute.xml +++ b/xml/System.Windows/AttachedPropertyBrowsableAttribute.xml @@ -24,11 +24,11 @@ Provides a base class for .NET attributes that report the use scope of attached properties. - , but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML), because an attached property is primarily a XAML concept. - + , but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML), because an attached property is primarily a XAML concept. + ]]> diff --git a/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml b/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml index ff55558a67f..349cac627e5 100644 --- a/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml +++ b/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml @@ -33,19 +33,19 @@ , but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML), because an attached property is primarily a XAML concept. + The meaning of the term `browsable` as used in descriptions for this attribute is analogous to the descriptions given for , but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML), because an attached property is primarily a XAML concept. - When this .NET Framework attribute is applied to the get accessor for an attached property, this .NET Framework attribute specifies that an attached property is browsable when the attached property owner is a parent element of other elements. + When this attribute is applied to the get accessor for an attached property, this attribute specifies that an attached property is browsable when the attached property owner is a parent element of other elements. - When interpreted by a designer that uses type descriptor information, the designer should add this property as a browsable property to all child elements in the logical tree, based on the parent element with this .NET Framework attribute applied. + When interpreted by a designer that uses type descriptor information, the designer should add this property as a browsable property to all child elements in the logical tree, based on the parent element with this attribute applied. Generally, the browsable state parallels functionality. For example, is designated browsable on elements that are child elements of a , because includes code for checking any set values of on child elements. - This .NET Framework attribute supports two types of tree detection modes for parent element positions: a shallow mode, and a deep mode. The shallow mode, which is the default mode for an applied .NET Framework attribute, requires that the immediate parent element be the owner type of the property in order for the attached property to be browsable. The deep mode is declared by applying the attribute with as `true`. The deep mode is less restrictive because it only requires that the owner type be somewhere in the ancestor direction of the logical tree, and therefore the attached property is browsable on all child elements, not just immediate child elements. The deep mode is applied for attached property usages where intervening elements in the logical tree should not be reported as the true parent element. Implicit collections (for example, the that is implicit in the of a ) are not considered to be parent elements for purposes of how this .NET Framework attribute declares the tree detection mode. + This attribute supports two types of tree detection modes for parent element positions: a shallow mode, and a deep mode. The shallow mode, which is the default mode for an applied attribute, requires that the immediate parent element be the owner type of the property in order for the attached property to be browsable. The deep mode is declared by applying the attribute with as `true`. The deep mode is less restrictive because it only requires that the owner type be somewhere in the ancestor direction of the logical tree, and therefore the attached property is browsable on all child elements, not just immediate child elements. The deep mode is applied for attached property usages where intervening elements in the logical tree should not be reported as the true parent element. Implicit collections (for example, the that is implicit in the of a ) are not considered to be parent elements for purposes of how this attribute declares the tree detection mode. - This .NET Framework attribute should only be applied on the get accessor of attached property definitions. Do not apply this .NET Framework attribute to the set accessor. Although intuitively it is the set operation that is being made browsable for XAML on child elements, it is the presence and characteristics of the get accessor on the parent element that controls the true behavior. + This attribute should only be applied on the get accessor of attached property definitions. Do not apply this attribute to the set accessor. Although intuitively it is the set operation that is being made browsable for XAML on child elements, it is the presence and characteristics of the get accessor on the parent element that controls the true behavior. - Whether an attached property is browsable on a child element is not an absolute guarantee that the attached property value is really processed by the parent element in some manner. Also, the value is not an absolute guarantee that the processing scope does or does not extend beyond the immediate parent element. All this is implementation specific. However, this .NET Framework attribute for reporting the browsable state is the best available mechanism for reporting the usage information and functional information for an attached property. Therefore, you can generally assume that the browsable state of an attached property is analogous to the behavior of how an attached property value on a child element is processed or interpreted by the relevant parent element in your application code. + Whether an attached property is browsable on a child element is not an absolute guarantee that the attached property value is really processed by the parent element in some manner. Also, the value is not an absolute guarantee that the processing scope does or does not extend beyond the immediate parent element. All this is implementation specific. However, this attribute is the best available mechanism for reporting the usage information and functional information for an attached property. Therefore, you can generally assume that the browsable state of an attached property is analogous to the behavior of how an attached property value on a child element is processed or interpreted by the relevant parent element in your application code. For general information on declaring attached properties, see [Attached Properties Overview](/dotnet/framework/wpf/advanced/attached-properties-overview). diff --git a/xml/System.Windows/FrameworkElement.xml b/xml/System.Windows/FrameworkElement.xml index ccb96989d26..3e1320ac025 100644 --- a/xml/System.Windows/FrameworkElement.xml +++ b/xml/System.Windows/FrameworkElement.xml @@ -6054,15 +6054,10 @@ Drawing objects on pixel boundaries eliminates the semi-transparent edges that are produced by anti-aliasing, when an edge falls in the middle of a device pixel. The following illustration shows the output of a single pixel-width line that falls in the middle of a device pixel. The line on the left does not use layout rounding and is anti-aliased. The line on the right uses layout rounding. - ![Anti-aliased line compared to single pixel line.](~/add/media/pixelsnaplinecompare.PNG "Anti-aliased line compared to single pixel line.") + ![Anti-aliased line compared to single pixel line.](~/add/media/pixelsnaplinecompare.PNG) When you use layout rounding and sizing, the layout system creates small variations in the column or row measurements to avoid subpixel rendering. For example, if a grid has a total width of 100 with 3 columns each of size , instead of creating three columns that have an equal width of 33.3, the layout system creates 2 columns that have a width of 33 and one that has a width of 34. -> [!NOTE] -> In .NET 4.6 changes were made to layout rounding to reduce instances of clipping in controls with borders. By default, this feature is enabled if your Target Framework is .NET Framework 4.6 or higher. Applications that target earlier versions of the framework can opt in into the new behavior by adding the following setting to an app.config file: `` The setting only takes effect when the application is running on the .NET Framework 4.6. - - - ## Examples The following example demonstrates the effect that the property has on a single pixel-width line. The line on the left does not use layout rounding and the line on the right uses layout rounding. If you slowly resize the window, you can see the difference that layout rounding makes.