From 5da537e30353b3658be8ed3ddc26d665317f5c35 Mon Sep 17 00:00:00 2001 From: Terry Jin Date: Mon, 30 Jul 2018 22:51:06 -0700 Subject: [PATCH 1/6] migrate missing API --- includes/crdefault-md.md | 1 + xml/Microsoft.Windows.Themes/ScrollChrome.xml | 20 +- .../DesignerView.xml | 4 +- .../ObservableCollection`1.xml | 4 +- .../ReadOnlyObservableCollection`1.xml | 24 +- .../DesignerProperties.xml | 23 +- .../AnnouncementClient.xml | 12 +- .../DiscoveryClient.xml | 12 +- .../ClientBase`1+ChannelBase`1.xml | 14 +- xml/System.ServiceModel/ClientBase`1.xml | 57 +- .../SiteMapDataSourceDesigner.xml | 28 +- .../XmlDataSourceDesigner.xml | 30 +- .../EntityDataSource.xml | 21 +- xml/System.Web.UI.WebControls/ImageButton.xml | 14 +- .../LinqDataSource.xml | 13 +- xml/System.Web.UI.WebControls/ListView.xml | 5 +- .../ModelDataSource.xml | 13 +- .../SiteMapDataSource.xml | 20 +- .../XmlDataSource.xml | 14 +- xml/System.Web.UI/DataSourceControl.xml | 13 +- .../HierarchicalDataSourceControl.xml | 16 +- .../AutomationProperties.xml | 238 +++++- .../DocumentViewerBase.xml | 25 +- .../SelectiveScrollingGrid.xml | 4 +- .../Selector.xml | 91 ++- .../RibbonControlService.xml | 451 +++++++++-- .../RibbonQuickAccessToolBar.xml | 4 +- .../RibbonTwoLineText.xml | 38 +- xml/System.Windows.Controls/Canvas.xml | 94 ++- .../ContextMenuService.xml | 287 ++++++- xml/System.Windows.Controls/DockPanel.xml | 35 +- xml/System.Windows.Controls/Grid.xml | 117 ++- xml/System.Windows.Controls/GridView.xml | 21 +- xml/System.Windows.Controls/InkCanvas.xml | 202 ++++- xml/System.Windows.Controls/ItemsControl.xml | 36 +- xml/System.Windows.Controls/KeyTipService.xml | 62 +- xml/System.Windows.Controls/Panel.xml | 32 +- xml/System.Windows.Controls/TextSearch.xml | 56 +- xml/System.Windows.Controls/ToolBar.xml | 49 +- .../ToolTipService.xml | 418 +++++++++- xml/System.Windows.Controls/Validation.xml | 124 ++- .../VirtualizingPanel.xml | 97 ++- .../VirtualizingStackPanel.xml | 22 +- xml/System.Windows.Data/Binding.xml | 63 +- xml/System.Windows.Documents/FixedPage.xml | 111 ++- xml/System.Windows.Forms/PropertyGrid.xml | 4 +- xml/System.Windows.Input/AccessKeyManager.xml | 15 +- xml/System.Windows.Input/CommandManager.xml | 82 +- xml/System.Windows.Input/FocusManager.xml | 62 +- .../InputLanguageManager.xml | 46 +- xml/System.Windows.Input/InputMethod.xml | 80 +- xml/System.Windows.Input/Keyboard.xml | 276 ++++++- .../KeyboardNavigation.xml | 131 ++- xml/System.Windows.Input/Mouse.xml | 383 ++++++++- xml/System.Windows.Input/Stylus.xml | 748 ++++++++++++++++-- .../TextCompositionManager.xml | 92 ++- .../XmlAttributeProperties.xml | 86 +- .../Storyboard.xml | 58 +- xml/System.Windows.Media/RenderOptions.xml | 203 ++++- xml/System.Windows.Media/TextOptions.xml | 23 +- .../JournalEntry.xml | 28 +- .../JournalEntryUnifiedViewConverter.xml | 20 +- xml/System.Windows.Shell/WindowChrome.xml | 20 +- xml/System.Windows/DataObject.xml | 62 +- xml/System.Windows/DragDrop.xml | 353 ++++++++- xml/System.Windows/NameScope.xml | 22 +- xml/System.Windows/VisualStateManager.xml | 13 +- 67 files changed, 5267 insertions(+), 575 deletions(-) create mode 100644 includes/crdefault-md.md diff --git a/includes/crdefault-md.md b/includes/crdefault-md.md new file mode 100644 index 00000000000..91e09afbc37 --- /dev/null +++ b/includes/crdefault-md.md @@ -0,0 +1 @@ +For more information, see \ No newline at end of file diff --git a/xml/Microsoft.Windows.Themes/ScrollChrome.xml b/xml/Microsoft.Windows.Themes/ScrollChrome.xml index 3f364bed180..b6ce59583b8 100644 --- a/xml/Microsoft.Windows.Themes/ScrollChrome.xml +++ b/xml/Microsoft.Windows.Themes/ScrollChrome.xml @@ -1,4 +1,4 @@ - + @@ -618,8 +618,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the color of the for the . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + diff --git a/xml/System.Activities.Presentation.View/DesignerView.xml b/xml/System.Activities.Presentation.View/DesignerView.xml index 1f0f507cd7d..b2e0dc4071e 100644 --- a/xml/System.Activities.Presentation.View/DesignerView.xml +++ b/xml/System.Activities.Presentation.View/DesignerView.xml @@ -1,4 +1,4 @@ - + @@ -145,7 +145,7 @@ 4.0.0.0 - To be added. + Indicates the command menu mode. To be added. diff --git a/xml/System.Collections.ObjectModel/ObservableCollection`1.xml b/xml/System.Collections.ObjectModel/ObservableCollection`1.xml index 21749346cf6..c65d1316e6c 100644 --- a/xml/System.Collections.ObjectModel/ObservableCollection`1.xml +++ b/xml/System.Collections.ObjectModel/ObservableCollection`1.xml @@ -1,4 +1,4 @@ - + @@ -808,7 +808,7 @@ System.ComponentModel.PropertyChangedEventHandler - To be added. + Occurs when a property value changes. To be added. diff --git a/xml/System.Collections.ObjectModel/ReadOnlyObservableCollection`1.xml b/xml/System.Collections.ObjectModel/ReadOnlyObservableCollection`1.xml index 240ccec235e..22a30ce7bb2 100644 --- a/xml/System.Collections.ObjectModel/ReadOnlyObservableCollection`1.xml +++ b/xml/System.Collections.ObjectModel/ReadOnlyObservableCollection`1.xml @@ -1,4 +1,4 @@ - + @@ -304,8 +304,15 @@ System.Collections.Specialized.NotifyCollectionChangedEventHandler - To be added. - To be added. + Occurs when the collection changes. + + instance is cast to an interface. + + ]]> + @@ -341,8 +348,15 @@ System.ComponentModel.PropertyChangedEventHandler - To be added. - To be added. + Occurs when a property value changes. + + instance is cast to an interface. + + ]]> + diff --git a/xml/System.ComponentModel/DesignerProperties.xml b/xml/System.ComponentModel/DesignerProperties.xml index a57de0bbdf3..fa6fa630be6 100644 --- a/xml/System.ComponentModel/DesignerProperties.xml +++ b/xml/System.ComponentModel/DesignerProperties.xml @@ -1,4 +1,4 @@ - + @@ -73,8 +73,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets whether a is running in the context of a designer. + + method and update their state if their **IsInDesignMode** property value changes. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|, | + + ]]> + diff --git a/xml/System.ServiceModel.Discovery/AnnouncementClient.xml b/xml/System.ServiceModel.Discovery/AnnouncementClient.xml index 4f6d8298c52..0d092f5e275 100644 --- a/xml/System.ServiceModel.Discovery/AnnouncementClient.xml +++ b/xml/System.ServiceModel.Discovery/AnnouncementClient.xml @@ -1,4 +1,4 @@ - + @@ -887,7 +887,7 @@ System.EventHandler - To be added. + Occurs when the communication object completes its transition from the closing state into the closed state. To be added. @@ -908,7 +908,7 @@ System.EventHandler - To be added. + Occurs when the communication object first enters the closing state. To be added. @@ -981,7 +981,7 @@ System.EventHandler - To be added. + Occurs when the communication object first enters the faulted state. To be added. @@ -1060,7 +1060,7 @@ System.EventHandler - To be added. + Occurs when the communication object completes its transition from the opening state into the opened state. To be added. @@ -1081,7 +1081,7 @@ System.EventHandler - To be added. + Occurs when the communication object first enters the opening state. To be added. diff --git a/xml/System.ServiceModel.Discovery/DiscoveryClient.xml b/xml/System.ServiceModel.Discovery/DiscoveryClient.xml index 01fcb6c44be..163cf3c486e 100644 --- a/xml/System.ServiceModel.Discovery/DiscoveryClient.xml +++ b/xml/System.ServiceModel.Discovery/DiscoveryClient.xml @@ -1,4 +1,4 @@ - + @@ -931,7 +931,7 @@ System.EventHandler - To be added. + Occurs when the communication object completes its transition from the closing state into the closed state. To be added. @@ -952,7 +952,7 @@ System.EventHandler - To be added. + Occurs when the communication object first enters the closing state. To be added. @@ -1025,7 +1025,7 @@ System.EventHandler - To be added. + Occurs when the communication object first enters the faulted state. To be added. @@ -1104,7 +1104,7 @@ System.EventHandler - To be added. + Occurs when the communication object completes its transition from the opening state into the opened state. To be added. @@ -1125,7 +1125,7 @@ System.EventHandler - To be added. + Occurs when the communication object first enters the opening state. To be added. diff --git a/xml/System.ServiceModel/ClientBase`1+ChannelBase`1.xml b/xml/System.ServiceModel/ClientBase`1+ChannelBase`1.xml index 28b7e49ab0d..3d1b9267d59 100644 --- a/xml/System.ServiceModel/ClientBase`1+ChannelBase`1.xml +++ b/xml/System.ServiceModel/ClientBase`1+ChannelBase`1.xml @@ -1,4 +1,4 @@ - + @@ -1282,7 +1282,7 @@ System.EventHandler<System.ServiceModel.UnknownMessageReceivedEventArgs> - To be added. + The event handler that is invoked when the ClientBase object receives an unknown message. To be added. @@ -1611,7 +1611,7 @@ System.EventHandler - To be added. + The event handler that is invoked when the ClientBase object has transitioned from its current state to the closed state. To be added. @@ -1639,7 +1639,7 @@ System.EventHandler - To be added. + The event handler that is invoked when the ClientBase object transitions from its current state to the closed state. To be added. @@ -1733,7 +1733,7 @@ System.EventHandler - To be added. + The event handler that is invoked when fault occurs while performing an operation on the ClientBase object. To be added. @@ -1834,7 +1834,7 @@ System.EventHandler - To be added. + The event handler that is invoked when the ClientBase object has transitioned from the created state to the opened state. To be added. @@ -1862,7 +1862,7 @@ System.EventHandler - To be added. + The event handler that is invoked when the ClientBase object transitions from the created state to the opened state. To be added. diff --git a/xml/System.ServiceModel/ClientBase`1.xml b/xml/System.ServiceModel/ClientBase`1.xml index 8b0e782ea6e..0175fd71452 100644 --- a/xml/System.ServiceModel/ClientBase`1.xml +++ b/xml/System.ServiceModel/ClientBase`1.xml @@ -1,4 +1,4 @@ - + @@ -1355,8 +1355,15 @@ System.EventHandler - To be added. - To be added. + The event handler that is invoked when the object has transitioned from its current state to the closed state. + + . + + ]]> + @@ -1384,8 +1391,15 @@ System.EventHandler - To be added. - To be added. + The event handler that is invoked when the object transitions from its current state to the closed state. + + . + + ]]> + @@ -1495,8 +1509,15 @@ System.EventHandler - To be added. - To be added. + The event handler that is invoked when a fault occurs while performing an operation on the object. + + . + + ]]> + @@ -1590,8 +1611,15 @@ System.EventHandler - To be added. - To be added. + The event handler that is invoked when the object transitions from the created state to the opened state. + + . + + ]]> + @@ -1619,8 +1647,15 @@ System.EventHandler - To be added. - To be added. + The event handler that is invoked when the object transitions from the created state to the opened state. + + . + + ]]> + diff --git a/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml b/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml index db4abddb6eb..e944d08f114 100644 --- a/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml +++ b/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml @@ -1,4 +1,4 @@ - + @@ -330,8 +330,17 @@ System.EventHandler - To be added. - To be added. + For a description of this member, see . + + instance is cast to an interface. + + ]]> + + Extending Design-Time Support + ASP.NET Site Maps @@ -488,8 +497,17 @@ System.EventHandler - To be added. - To be added. + For a description of this member, see . + + instance is cast to an interface. + + ]]> + + ASP.NET Site Maps + Extending Design-Time Support diff --git a/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml b/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml index db7c01d79a9..4445f99ad11 100644 --- a/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml +++ b/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml @@ -1,4 +1,4 @@ - + @@ -425,8 +425,18 @@ System.EventHandler - To be added. - To be added. + For a description of this member, see . + + instance is cast to an interface. + + ]]> + + Extending Design-Time Support + How to: Extend the Appearance and Behavior of Controls in Design Mode + @@ -583,8 +593,18 @@ System.EventHandler - To be added. - To be added. + For a description of this member, see . + + instance is cast to an interface. + + ]]> + + Extending Design-Time Support + How to: Extend the Appearance and Behavior of Controls in Design Mode + diff --git a/xml/System.Web.UI.WebControls/EntityDataSource.xml b/xml/System.Web.UI.WebControls/EntityDataSource.xml index 7c12788de9e..f3ad7ee29d0 100644 --- a/xml/System.Web.UI.WebControls/EntityDataSource.xml +++ b/xml/System.Web.UI.WebControls/EntityDataSource.xml @@ -1,4 +1,4 @@ - + @@ -1991,8 +1991,23 @@ ObjectQuery products = context.Product System.EventHandler<System.Web.DynamicData.DynamicValidatorEventArgs> - To be added. - To be added. + Occurs when validation fails in a partial methods or when an exception is raised. + + event is implemented to provide for compatibility with ASP.NET Dynamic Data. This event, defined by the interface, is explicitly implemented by the . A handler for this event cannot be registered in markup. It can be used only when the instance is cast to an interface. + + The event provides an object that returns the . The event may be raised in the following cases: + +- When an object is created. This enables the partial methods on the object to raise exceptions during validation of property settings. + +- When an exception occurs during the execution of the query. + +- When an exception occurs during the execution of any INSERT, UPDATE, or DELETE operation. + + ]]> + diff --git a/xml/System.Web.UI.WebControls/ImageButton.xml b/xml/System.Web.UI.WebControls/ImageButton.xml index a20687745ef..bc081fa7771 100644 --- a/xml/System.Web.UI.WebControls/ImageButton.xml +++ b/xml/System.Web.UI.WebControls/ImageButton.xml @@ -1,4 +1,4 @@ - + @@ -1192,8 +1192,16 @@ End Sub System.EventHandler - To be added. - To be added. + For a description of this member, see the event. + + member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. + + ]]> + + Button Web Server Controls Overview diff --git a/xml/System.Web.UI.WebControls/LinqDataSource.xml b/xml/System.Web.UI.WebControls/LinqDataSource.xml index 8fb3ca7c17f..8beefa0aa02 100644 --- a/xml/System.Web.UI.WebControls/LinqDataSource.xml +++ b/xml/System.Web.UI.WebControls/LinqDataSource.xml @@ -1,4 +1,4 @@ - + @@ -2130,8 +2130,15 @@ protected void LinqDataSource_Selecting(object sender, System.EventHandler<System.Web.DynamicData.DynamicValidatorEventArgs> - To be added. - To be added. + For a description of this member, see . + + instance is cast to an interface. + + ]]> + diff --git a/xml/System.Web.UI.WebControls/ListView.xml b/xml/System.Web.UI.WebControls/ListView.xml index 00d2a04ed53..56d343633d5 100644 --- a/xml/System.Web.UI.WebControls/ListView.xml +++ b/xml/System.Web.UI.WebControls/ListView.xml @@ -1,4 +1,4 @@ - + @@ -6312,8 +6312,9 @@ System.EventHandler<System.Web.UI.WebControls.PageEventArgs> - To be added. + For a description of this member, see . To be added. + ListView Web Server Control diff --git a/xml/System.Web.UI.WebControls/ModelDataSource.xml b/xml/System.Web.UI.WebControls/ModelDataSource.xml index 0cc4ff841a5..9356b074730 100644 --- a/xml/System.Web.UI.WebControls/ModelDataSource.xml +++ b/xml/System.Web.UI.WebControls/ModelDataSource.xml @@ -1,4 +1,4 @@ - + @@ -187,8 +187,15 @@ System.EventHandler - To be added. - To be added. + Occurs when the underlying data source has changed. The change may be due to a change in the control's properties, or a change in the data due to an edit action performed by the data source control. + + instance is cast to an interface. + + ]]> + diff --git a/xml/System.Web.UI.WebControls/SiteMapDataSource.xml b/xml/System.Web.UI.WebControls/SiteMapDataSource.xml index a488f255d78..0a1fe807ca5 100644 --- a/xml/System.Web.UI.WebControls/SiteMapDataSource.xml +++ b/xml/System.Web.UI.WebControls/SiteMapDataSource.xml @@ -1,4 +1,4 @@ - + @@ -699,8 +699,22 @@ System.EventHandler - To be added. - To be added. + Occurs when a data source control has changed in some way that affects data-bound controls. + + instance is cast to an interface. + + ]]> + + ASP.NET Site Navigation + SiteMapPath Web Server Control + Securing ASP.NET Site Navigation + ASP.NET Data Access Overview + SiteMapDataSource Web Server Control Overview + + diff --git a/xml/System.Web.UI.WebControls/XmlDataSource.xml b/xml/System.Web.UI.WebControls/XmlDataSource.xml index 0a6622542d6..1283fbeab17 100644 --- a/xml/System.Web.UI.WebControls/XmlDataSource.xml +++ b/xml/System.Web.UI.WebControls/XmlDataSource.xml @@ -1,4 +1,4 @@ - + @@ -1032,8 +1032,16 @@ System.EventHandler - To be added. - To be added. + For a description of this member, see . + + instance is cast to the interface. + + ]]> + + diff --git a/xml/System.Web.UI/DataSourceControl.xml b/xml/System.Web.UI/DataSourceControl.xml index 39bb2ee8dfa..fdaf1777237 100644 --- a/xml/System.Web.UI/DataSourceControl.xml +++ b/xml/System.Web.UI/DataSourceControl.xml @@ -1,4 +1,4 @@ - + @@ -692,8 +692,15 @@ System.EventHandler - To be added. - To be added. + Occurs when a data source control has changed in a way that affects data-bound controls. + + . + + ]]> + diff --git a/xml/System.Web.UI/HierarchicalDataSourceControl.xml b/xml/System.Web.UI/HierarchicalDataSourceControl.xml index 513cefa9802..096594d34a5 100644 --- a/xml/System.Web.UI/HierarchicalDataSourceControl.xml +++ b/xml/System.Web.UI/HierarchicalDataSourceControl.xml @@ -1,4 +1,4 @@ - + @@ -557,8 +557,18 @@ System.EventHandler - To be added. - To be added. + Occurs when the has changed in some way that affects data-bound controls. + + instance is cast to an interface. + + The event is raised when the properties of a data-bound control or the underlying data has changed in some way that affects the data bindings between a data-bound control and its data. + + ]]> + + diff --git a/xml/System.Windows.Automation/AutomationProperties.xml b/xml/System.Windows.Automation/AutomationProperties.xml index bf344be794d..e931e5d34ea 100644 --- a/xml/System.Windows.Automation/AutomationProperties.xml +++ b/xml/System.Windows.Automation/AutomationProperties.xml @@ -1,4 +1,4 @@ - + @@ -32,8 +32,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the accelerator key for the specified element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview @@ -70,8 +85,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the access key for the specified element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview @@ -108,8 +138,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or set the string that uniquely identifies the specified element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview @@ -494,8 +539,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the help text for the specified element. The help text generally is the same text that is provided in the tooltip for the control. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Support for the ToolTip Control Type + UI Automation Properties Overview @@ -532,8 +593,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value indicating whether the specified element is a column header. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + Expose the Content of a Table Using UI Automation + Implementing the UI Automation Table Control Pattern + UI Automation Properties Overview @@ -569,8 +647,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that specifies how the property is determined. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -606,8 +698,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether the specified element is required to be filled out on a form. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview + @@ -644,8 +752,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value indicating whether the specified element is a row header. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview @@ -682,8 +805,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a description of the status of an item within an element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview + @@ -720,8 +860,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a description of the type of the specified element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview @@ -758,8 +914,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the element that contains the text label for the specified element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview + UI Automation Support for the Edit Control Type + @@ -832,8 +1005,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the name of the element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + UI Automation Properties Overview diff --git a/xml/System.Windows.Controls.Primitives/DocumentViewerBase.xml b/xml/System.Windows.Controls.Primitives/DocumentViewerBase.xml index 82c374d26aa..8b1a0d67b1c 100644 --- a/xml/System.Windows.Controls.Primitives/DocumentViewerBase.xml +++ b/xml/System.Windows.Controls.Primitives/DocumentViewerBase.xml @@ -1,4 +1,4 @@ - + @@ -571,8 +571,27 @@ 4.0.0.0 - To be added. - To be added. + Gets a value that indicates whether or not a child element in the viewer should be used as a master page. + + in the collection represents master page. The master page corresponds to the page that is currently active (being displayed) in the viewer. + + Typically, no more than one member of the collection is marked as the master page. If more than one member of the collection is marked as the master page, then the first indicated in the logical tree (depth-first) is designated the active master. If no members of the collection are marked as the master page, then the master page defaults to the first member of the collection. + + Use the method to set and attach this property to a specified element (dependency object). Use the method to read the value of this attached property from a specified element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + diff --git a/xml/System.Windows.Controls.Primitives/SelectiveScrollingGrid.xml b/xml/System.Windows.Controls.Primitives/SelectiveScrollingGrid.xml index e080148ff73..93bbb821b9c 100644 --- a/xml/System.Windows.Controls.Primitives/SelectiveScrollingGrid.xml +++ b/xml/System.Windows.Controls.Primitives/SelectiveScrollingGrid.xml @@ -1,4 +1,4 @@ - + @@ -79,7 +79,7 @@ 4.0.0.0 - To be added. + Gets or sets the direction that cells can scroll. To be added. diff --git a/xml/System.Windows.Controls.Primitives/Selector.xml b/xml/System.Windows.Controls.Primitives/Selector.xml index 665298d663c..4a918dda0c8 100644 --- a/xml/System.Windows.Controls.Primitives/Selector.xml +++ b/xml/System.Windows.Controls.Primitives/Selector.xml @@ -1,4 +1,4 @@ - + @@ -213,8 +213,35 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether an item is selected. + + attached property to select an item in the when you do not explicitly create the item container. An item container is a class that represents an item in the . , , and are item containers for the controls that inherit from , and each defines an **IsSelected** property. + + If you do not explicitly create an item container, [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] implicitly creates one and sets the **IsSelected** property on the item container to the value of . This is the only time is read. is not updated if the selection on the item changes. + + If you explicitly create an item container, you should use the **IsSelected** property on that class. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|, registered as Attached| +|Metadata properties set to `true`|| + + + +## Examples + The follow example creates a that contains two controls. The example does not explicitly create a for either , so it sets directly on each . To illustrate that is not updated, the example binds the property of the first checkbox to . When the user unselects the item in the , the remains checked. Likewise, checking or unchecking the does not affect whether the is selected in the . The example binds of the second to . In this case, unselecting the item in the causes the checkbox to be unchecked, and unchecking the checkbox also unselects the item. + + [!code-xml[Selector#1](~/samples/snippets/csharp/VS_Snippets_Wpf/Selector/CS/Window1.xaml#1)] + [!code-xml[Selector#1](~/samples/snippets/xaml/VS_Snippets_Wpf/Selector/XAML/Window1.xaml#1)] + + ]]> + @@ -567,8 +594,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an item is selected. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following examples show how to use the event with a control. The first example raises the event and the second shows how to handle the event. + + [!code-xml[ListBoxItems_snip#SelectorEvents](~/samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems_snip/CSharp/Window1.xaml#selectorevents)] + + [!code-csharp[ListBoxItems_snip#SelectorSelected](~/samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems_snip/CSharp/Window1.xaml.cs#selectorselected)] + [!code-vb[ListBoxItems_snip#SelectorSelected](~/samples/snippets/visualbasic/VS_Snippets_Wpf/ListBoxItems_snip/visualbasic/window1.xaml.vb#selectorselected)] + + ]]> + @@ -1033,8 +1085,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an item is unselected. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following examples show how to use the event with a control and how to create an event handler. + + [!code-xml[ListBoxItems_snip#SelectorEvents](~/samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems_snip/CSharp/Window1.xaml#selectorevents)] + + [!code-csharp[ListBoxItems_snip#SelectorUnselected](~/samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems_snip/CSharp/Window1.xaml.cs#selectorunselected)] + [!code-vb[ListBoxItems_snip#SelectorUnselected](~/samples/snippets/visualbasic/VS_Snippets_Wpf/ListBoxItems_snip/visualbasic/window1.xaml.vb#selectorunselected)] + + ]]> + diff --git a/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml b/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml index 3797bb2da43..4d541307b93 100644 --- a/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml +++ b/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml @@ -1,4 +1,4 @@ - + @@ -56,8 +56,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether this control can be added directly to the Quick Access Toolbar. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -92,8 +106,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the background of the control when it is in the Checked state. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -128,8 +156,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the outer border of the control when it in the Checked state. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -164,8 +206,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the for this control. + + contains properties that specify size and visibility information for the image and label associated with a control. For the default property values, see . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + Ribbon Layout and Resizing @@ -200,8 +258,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates the amount that the corners of a ribbon button are rounded. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -236,8 +308,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the default for this control. + + contains properties that specify size and visibility information for the image and label associated with a control. If the property is not set for a ribbon control, the property is used instead. The default control size definition is based on the control’s property settings. If a is specified, it is the default. If is `null`, and a is specified, the is the default. If both the and are `null`, the image is set to by default. If the property is null or empty, it is hidden by default. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + Ribbon Layout and Resizing @@ -272,7 +360,7 @@ 4.0.0.0 - To be added. + Occurs when a ribbon popup is closed. To be added. @@ -308,8 +396,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the background of the control when it has focus. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -344,8 +446,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the outer border of the control when it has focus. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -1122,8 +1238,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the text that is displayed next to or below the control. + + property on the to control the visibility of the label. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -1158,8 +1289,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the image that is displayed on the control when the image size is set to . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + Ribbon Layout and Resizing @@ -1194,8 +1340,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the background of the control when the mouse pointer is over it. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -1230,8 +1390,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the outer border of the control when the mouse pointer is over it. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -1266,8 +1440,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the background of the control when it is pressed. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -1302,8 +1490,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the brush that is used to draw the outer border of the control when it is pressed. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -1338,8 +1540,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the for this control when it is hosted in the Quick Access Toolbar. + + contains properties that specify size and visibility information for the image and label associated with a control. This property specifies how the image and label will appear when this control is hosted in the Quick Access Toolbar. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -1374,8 +1592,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a unique identifier that links a ribbon control to a corresponding control in the Quick Access Toolbar. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -2097,8 +2329,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the image that is displayed on the control when the image size is set to . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + Ribbon Layout and Resizing @@ -2133,8 +2380,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the descriptive text that is displayed in the ToolTip for this control. + + [!WARNING] +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -2169,8 +2434,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the descriptive text that is displayed in the footer of the ToolTip for this control. + + [!WARNING] +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -2205,8 +2488,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the image that is displayed in the footer of the ToolTip for this control. + + [!WARNING] +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -2241,8 +2542,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the title text that is displayed in the footer of the ToolTip for this control. + + [!WARNING] +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -2277,8 +2596,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the image that is displayed in the ToolTip for this control. + + [!WARNING] +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -2313,8 +2650,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the title text that is displayed in the ToolTip for this control. + + [!WARNING] +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + diff --git a/xml/System.Windows.Controls.Ribbon/RibbonQuickAccessToolBar.xml b/xml/System.Windows.Controls.Ribbon/RibbonQuickAccessToolBar.xml index 95133bff91e..9323e441bd0 100644 --- a/xml/System.Windows.Controls.Ribbon/RibbonQuickAccessToolBar.xml +++ b/xml/System.Windows.Controls.Ribbon/RibbonQuickAccessToolBar.xml @@ -1,4 +1,4 @@ - + @@ -158,7 +158,7 @@ 4.0.0.0 - To be added. + Occurs when an element in the Quick Access Toolbar is cloned. To be added. diff --git a/xml/System.Windows.Controls.Ribbon/RibbonTwoLineText.xml b/xml/System.Windows.Controls.Ribbon/RibbonTwoLineText.xml index 87582b757d8..e90ccd22a32 100644 --- a/xml/System.Windows.Controls.Ribbon/RibbonTwoLineText.xml +++ b/xml/System.Windows.Controls.Ribbon/RibbonTwoLineText.xml @@ -1,4 +1,4 @@ - + @@ -167,8 +167,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether this control layout can extend to two lines or if it is restricted to one line. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + @@ -451,8 +465,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the geometry data that defines the shape that is displayed with the label. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|, | + + ]]> + diff --git a/xml/System.Windows.Controls/Canvas.xml b/xml/System.Windows.Controls/Canvas.xml index 32b6e56e952..ee7d3c9ace1 100644 --- a/xml/System.Windows.Controls/Canvas.xml +++ b/xml/System.Windows.Controls/Canvas.xml @@ -1,4 +1,4 @@ - + @@ -105,8 +105,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that represents the distance between the bottom of an element and the bottom of its parent . + + offset of a child element does not affect the size of a parent . + + If you specify them, the attached properties or take priority over the or properties. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -311,8 +330,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that represents the distance between the left side of an element and the left side of its parent . + + offset of a child element does not affect the size of a parent . + + If you specify them, the attached properties or take priority over or properties. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -377,8 +415,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that represents the distance between the right side of an element and the right side of its parent . + + offset of a child element does not affect the size of a parent . + + If you specify them, the attached properties or take priority over or properties. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -528,8 +585,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that represents the distance between the top of an element and the top of its parent . + + offset of a child element does not affect the size of a parent . + + If you specify them, the attached properties or take priority over or . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + diff --git a/xml/System.Windows.Controls/ContextMenuService.xml b/xml/System.Windows.Controls/ContextMenuService.xml index 20e53666caf..d735f466faf 100644 --- a/xml/System.Windows.Controls/ContextMenuService.xml +++ b/xml/System.Windows.Controls/ContextMenuService.xml @@ -1,4 +1,4 @@ - + @@ -117,8 +117,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the content of a . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -133,7 +148,7 @@ 4.0.0.0 - To be added. + Occurs when the closes. To be added. @@ -170,7 +185,7 @@ 4.0.0.0 - To be added. + Occurs when the opens. To be added. @@ -514,8 +529,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether the has the drop shadow effect enabled. + + opens, the value is set to the value of . Setting this property to `true` has no effect if the property is `false`. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example assigns the same to two buttons and sets the , , , , and properties to set the to different positions for each button. + + [!code-xml[ContextMenuService_snip#SharedContextMenu](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#sharedcontextmenu)] + + ]]> + + @@ -552,8 +590,58 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates where along the x-direction to place the with respect to the parent control. + + by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Attribute Usage + +``` + +- or – + +``` + + +## XAML Values + *double* + + + A string representation of a value. This is interpreted as a [!INCLUDE[TLA#tla_dipixel](~/includes/tlasharptla-dipixel-md.md)] measurement. Strings need not explicitly include decimal points. For instance a value of `1` is acceptable. + + *qualifiedDouble* + A *double* value as described above, followed by one of the following unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + + +## Examples + The following example assigns the same to two buttons and sets the , , , , and properties to set the to different positions for each button. + + [!code-xml[ContextMenuService_snip#SharedContextMenu](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#sharedcontextmenu)] + + ]]> + + @@ -590,8 +678,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether the can be shown. + + property is `false` the context menu does not appear when the user right-clicks the parent control. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to disable a context menu by setting the property to false. + + [!code-xml[ContextMenuService_snip#ContextMenuServiceIsEnabled](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#contextmenuserviceisenabled)] + + ]]> + + @@ -628,8 +739,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that specifies the placement of the relative to the or . + + by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example assigns the same to two buttons and sets the , , , , and properties to set the to different positions for each button. + + [!code-xml[ContextMenuService_snip#SharedContextMenu](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#sharedcontextmenu)] + + ]]> + + @@ -666,8 +800,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the area relative to which the context menu is positioned when it opens. + + by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example assigns the same to two buttons and sets the , , , , and properties to set the to different positions for each button. + + [!code-xml[ContextMenuService_snip#SharedContextMenu](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#sharedcontextmenu)] + + ]]> + + @@ -704,8 +861,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the parent control of the . + + by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + @@ -1037,8 +1210,30 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether the should be shown when its parent is grayed out. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + This example creates and displays a on a disabled button. + + [!code-xml[ContextMenuService_snip#ContextMenuServiceShowOnDisabled](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#contextmenuserviceshowondisabled)] + + ]]> + + @@ -1075,8 +1270,58 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates where along the y-direction to place the with respect to the parent control. + + by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Attribute Usage + +``` + +- or – + +``` + + +## XAML Values + *double* + + + A string representation of a value. This is interpreted as a [!INCLUDE[TLA#tla_dipixel](~/includes/tlasharptla-dipixel-md.md)] measurement. Strings need not explicitly include decimal points. For instance a value of `1` is acceptable. + + *qualifiedDouble* + A *double* value as described above, followed by one of the following unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + + +## Examples + The following example assigns the same to two buttons and sets the , , , , and properties to set the to different positions for each button. + + [!code-xml[ContextMenuService_snip#SharedContextMenu](~/samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuService_snip/CSharp/Pane1.xaml#sharedcontextmenu)] + + ]]> + + diff --git a/xml/System.Windows.Controls/DockPanel.xml b/xml/System.Windows.Controls/DockPanel.xml index d8d470b96b8..89ba4f895f5 100644 --- a/xml/System.Windows.Controls/DockPanel.xml +++ b/xml/System.Windows.Controls/DockPanel.xml @@ -1,4 +1,4 @@ - + @@ -92,8 +92,37 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates the position of a child element within a parent . + + property to `true`, which is the default setting, the last child element of a always fills the remaining space, regardless of any other dock value that you set on the last child element. To.dock a child element in another direction, you must set the property to `false` and must also specify an explicit dock direction on the last child element. + + **Note:** The position of child elements of a on the screen is determined by the property of the respective child elements *and* the relative order of those child elements under the . Therefore, a set of child elements with the same Dock property values can be positioned differently on the screen depending on the order of these children under the . Child ordering effects positioning because the iterates through its child elements in order, setting the position of each element depending on remaining space. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the attached property by using [!INCLUDE[TLA#tla_xaml](~/includes/tlasharptla-xaml-md.md)]. + + [!code-cpp[DockPanelOvwSample#1](~/samples/snippets/cpp/VS_Snippets_Wpf/DockPanelOvwSample/CPP/DockPanel_Ovw_Sample.cpp#1)] + [!code-csharp[DockPanelOvwSample#1](~/samples/snippets/csharp/VS_Snippets_Wpf/DockPanelOvwSample/CSharp/DockPanel_Ovw_Sample.cs#1)] + [!code-vb[DockPanelOvwSample#1](~/samples/snippets/visualbasic/VS_Snippets_Wpf/DockPanelOvwSample/VisualBasic/dockpanel_vb.vb#1)] + [!code-xml[DockPanelOvwSample#1](~/samples/snippets/xaml/VS_Snippets_Wpf/DockPanelOvwSample/XAML/default.xaml#1)] + + ]]> + + + diff --git a/xml/System.Windows.Controls/Grid.xml b/xml/System.Windows.Controls/Grid.xml index d3881630ed4..76d8626f7b3 100644 --- a/xml/System.Windows.Controls/Grid.xml +++ b/xml/System.Windows.Controls/Grid.xml @@ -1,4 +1,4 @@ - + @@ -116,8 +116,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates which column child content within a should appear in. + + are defined using the element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -206,8 +221,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates the total number of columns that child content spans within a . + + are defined using the element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -430,8 +460,43 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates that multiple elements are sharing size information. + + sizing. In this scenario, sizing is treated as . + + Grid size sharing does not work if is set to `true` within a resource template, and a is defined outside of that template. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following code examples demonstrate how to use the property in [!INCLUDE[TLA#tla_xaml](~/includes/tlasharptla-xaml-md.md)] and code. + + [!code-xml[gridIssharedsizescopeProp#1](~/samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml#1)] + + ... + + [!code-xml[gridIssharedsizescopeProp#2](~/samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml#2)] + + ... + + Events defined in [!INCLUDE[TLA#tla_xaml](~/includes/tlasharptla-xaml-md.md)] are handled using code. + + [!code-csharp[gridIssharedsizescopeProp#3](~/samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml.cs#3)] + [!code-vb[gridIssharedsizescopeProp#3](~/samples/snippets/visualbasic/VS_Snippets_Wpf/gridIssharedsizescopeProp/VisualBasic/Window1.xaml.vb#3)] + + ]]> + @@ -546,8 +611,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates which row child content within a should appear in. + + are defined using the element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -635,8 +715,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates the total number of rows that child content spans within a . + + are defined using the element. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + diff --git a/xml/System.Windows.Controls/GridView.xml b/xml/System.Windows.Controls/GridView.xml index 3e3d249b068..d593e2ddb1b 100644 --- a/xml/System.Windows.Controls/GridView.xml +++ b/xml/System.Windows.Controls/GridView.xml @@ -1,4 +1,4 @@ - + @@ -273,8 +273,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the attached property that contains the . + + , such as the control. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + diff --git a/xml/System.Windows.Controls/InkCanvas.xml b/xml/System.Windows.Controls/InkCanvas.xml index b4e5ed12841..ead8a52c11b 100644 --- a/xml/System.Windows.Controls/InkCanvas.xml +++ b/xml/System.Windows.Controls/InkCanvas.xml @@ -1,4 +1,4 @@ - + @@ -317,8 +317,54 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the bottom of an element and the bottom of its parent . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Attribute Usage + +``` + +- or – + +``` + + +## XAML Values + *double* + String representation of a value. This is interpreted as a [!INCLUDE[TLA#tla_dipixel](~/includes/tlasharptla-dipixel-md.md)] measurement. Strings need not explicitly include decimal points. For instance, a value of `1` is acceptable. + + *qualifiedDouble* + A *double* value as described above, followed by one of the following unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + + +## Examples + The following example demonstrates how to set the position of a on an . + + [!code-xml[InkCanvasSamples#35](~/samples/snippets/visualbasic/VS_Snippets_Wpf/InkCanvasSamples/VisualBasic/Window1.xaml#35)] + + ]]> + @@ -1601,8 +1647,54 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the left side of an element and the left side of its parent . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Attribute Usage + +``` + +- or – + +``` + + +## XAML Values + *double* + String representation of a value. This is interpreted as a [!INCLUDE[TLA#tla_dipixel](~/includes/tlasharptla-dipixel-md.md)] measurement. Strings need not explicitly include decimal points. For instance, a value of `1` is acceptable. + + *qualifiedDouble* + A *double* value as described above, followed by one of the following unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + + +## Examples + The following example demonstrates how to set the position of a on an . + + [!code-xml[InkCanvasSamples#35](~/samples/snippets/visualbasic/VS_Snippets_Wpf/InkCanvasSamples/VisualBasic/Window1.xaml#35)] + + ]]> + @@ -2423,8 +2515,54 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the right side of an element and the right side of its parent . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Attribute Usage + +``` + +- or – + +``` + + +## XAML Values + *double* + String representation of a value. This is interpreted as a [!INCLUDE[TLA#tla_dipixel](~/includes/tlasharptla-dipixel-md.md)] measurement. Strings need not explicitly include decimal points. For instance, a value of `1` is acceptable. + + *qualifiedDouble* + A *double* value as described above, followed by one of the following unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + + +## Examples + The following example demonstrates how to set the position of a on an . + + [!code-xml[InkCanvasSamples#35](~/samples/snippets/visualbasic/VS_Snippets_Wpf/InkCanvasSamples/VisualBasic/Window1.xaml#35)] + + ]]> + @@ -3388,8 +3526,54 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the top of an element and the top of its parent . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Attribute Usage + +``` + +- or – + +``` + + +## XAML Values + *double* + String representation of a value. This is interpreted as a [!INCLUDE[TLA#tla_dipixel](~/includes/tlasharptla-dipixel-md.md)] measurement. Strings need not explicitly include decimal points. For instance a value of `1` is acceptable. + + *qualifiedDouble* + A *double* value as described above, followed by one of the following unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + + +## Examples + The following example demonstrates how to set the position of a on an . + + [!code-xml[InkCanvasSamples#35](~/samples/snippets/visualbasic/VS_Snippets_Wpf/InkCanvasSamples/VisualBasic/Window1.xaml#35)] + + ]]> + diff --git a/xml/System.Windows.Controls/ItemsControl.xml b/xml/System.Windows.Controls/ItemsControl.xml index 3a21fbeb7a3..dbe47f99cb6 100644 --- a/xml/System.Windows.Controls/ItemsControl.xml +++ b/xml/System.Windows.Controls/ItemsControl.xml @@ -1,4 +1,4 @@ - + @@ -294,8 +294,38 @@ ListBox that contains multiple types of objects 4.0.0.0 - To be added. - To be added. + Gets the assigned value of the item container when alternating item containers are used. + + and properties enable you to specify the appearance for two or more alternating item containers. For example, you can specify alternating background colors for every third item in an . The is assigned to each item container in the . begins at 0, increments until it is minus 1, and then restarts at 0. For example, if is 3 and there are seven items in the , the following table lists the for each item. + +|Position of Item in the || +|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| +|1|0| +|2|1| +|3|2| +|4|0| +|5|1| +|6|2| +|7|0| + + There are several methods you can use to specify different appearances for the alternating item containers. One method is to bind properties of the items container to the . You can then use an to specify which value should be applied to the item container that has a certain value. You can also use triggers to change the value of an item container's property depending on the value of its . + + + +## Examples + The following example specifies that the (which inherits from ) has alternating item containers (which are of type ) and specifies a different background and foreground for each one. The example binds the and properties to the and provides an for each property. + + [!code-xml[AlternationIndexSnippets#2](~/samples/snippets/csharp/VS_Snippets_Wpf/AlternationIndexSnippets/CS/Window1.xaml#2)] + + The following example does the same as the previous example by using objects. + + [!code-xml[AlternationIndexSnippets#1](~/samples/snippets/csharp/VS_Snippets_Wpf/AlternationIndexSnippets/CS/Window1.xaml#1)] + + ]]> + diff --git a/xml/System.Windows.Controls/KeyTipService.xml b/xml/System.Windows.Controls/KeyTipService.xml index 5aaee8e6fbf..b554deb61ef 100644 --- a/xml/System.Windows.Controls/KeyTipService.xml +++ b/xml/System.Windows.Controls/KeyTipService.xml @@ -1,4 +1,4 @@ - + @@ -30,7 +30,7 @@ 4.0.0.0 - To be added. + Occurs when the KeyTip is activated. To be added. @@ -243,8 +243,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether the element that this property is attached to is in KeyTip scope. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -279,8 +293,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the text to use for the KeyTip. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -295,7 +323,7 @@ 4.0.0.0 - To be added. + Occurs when the KeyTip is accessed. To be added. @@ -351,8 +379,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the style to use with the KeyTip. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -387,7 +429,7 @@ 4.0.0.0 - To be added. + Occurs when the KeyTip is accessed. To be added. diff --git a/xml/System.Windows.Controls/Panel.xml b/xml/System.Windows.Controls/Panel.xml index 027289d4acd..11ae054364c 100644 --- a/xml/System.Windows.Controls/Panel.xml +++ b/xml/System.Windows.Controls/Panel.xml @@ -1,4 +1,4 @@ - + @@ -778,8 +778,34 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that represents the order on the z-plane in which an element appears. + + collection that have equal values are rendered in the order in which they appear in the visual tree. You can determine the index position of a child by iterating the members of the collection. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example demonstrates how to set the value of the property by using [!INCLUDE[TLA#tla_xaml](~/includes/tlasharptla-xaml-md.md)] and code. + + [!code-cpp[canvasz-order#1](~/samples/snippets/cpp/VS_Snippets_Wpf/CanvasZ-Order/CPP/CanvasZ-Order.cpp#1)] + [!code-csharp[canvasz-order#1](~/samples/snippets/csharp/VS_Snippets_Wpf/CanvasZ-Order/Csharp/CanvasZ-Order.cs#1)] + [!code-xml[canvasz-order#1](~/samples/snippets/xaml/VS_Snippets_Wpf/CanvasZ-Order/XAML/default.xaml#1)] + + ]]> + diff --git a/xml/System.Windows.Controls/TextSearch.xml b/xml/System.Windows.Controls/TextSearch.xml index fab65c28026..b0651ad4d61 100644 --- a/xml/System.Windows.Controls/TextSearch.xml +++ b/xml/System.Windows.Controls/TextSearch.xml @@ -1,4 +1,4 @@ - + @@ -187,8 +187,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the string that identifies an item in a control's collection. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + + +## Examples + The following example creates a that contains images as items instead of text. The property is set to `true`, so text is displayed when one of the images is selected. + + [!code-xml[ComboBoxProps_snip#2](~/samples/snippets/csharp/VS_Snippets_Wpf/ComboBoxProps_snip/CS/pane1.xaml#2)] + + ]]> + + @@ -204,8 +227,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the name of the items' property that identifies each item in a control's collection. + + . If you set the property on a control's collection item, the property will be ignored. If you set the property to a value that is not the name of an actual property, is ignored. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example creates a that contains images as items instead of text. The property is set to `true`, so text is displayed when one of the images is selected. + + [!code-xml[ComboBoxProps_snip#1](~/samples/snippets/csharp/VS_Snippets_Wpf/ComboBoxProps_snip/CS/pane1.xaml#1)] + + ]]> + + diff --git a/xml/System.Windows.Controls/ToolBar.xml b/xml/System.Windows.Controls/ToolBar.xml index 5878c064a34..e76b73c0aef 100644 --- a/xml/System.Windows.Controls/ToolBar.xml +++ b/xml/System.Windows.Controls/ToolBar.xml @@ -1,4 +1,4 @@ - + @@ -472,8 +472,30 @@ 4.0.0.0 - To be added. - To be added. + Gets a value that indicates whether the item is an overflow item. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + +## XAML Text Usage + See Remarks. + + ]]> + + + + @@ -838,8 +860,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates when an item should be placed in the overflow panel instead of in the main panel. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + + diff --git a/xml/System.Windows.Controls/ToolTipService.xml b/xml/System.Windows.Controls/ToolTipService.xml index 205b6fcb40e..cb4a3ae4e24 100644 --- a/xml/System.Windows.Controls/ToolTipService.xml +++ b/xml/System.Windows.Controls/ToolTipService.xml @@ -1,4 +1,4 @@ - + @@ -117,8 +117,29 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay. + + property. However, after a tooltip is displayed there is a period of time during which another tooltip can be displayed without waiting for the time to pass. You specify this time period by using the property. When the user moves the mouse within this time period from one element that has a visible tooltip to another element that has a tooltip, the value of the property for the second tooltip is not applied and the second tooltip appears immediately. + + For information about how to get or set this property, see the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + The value of the property is less than zero (0). + + + @@ -719,8 +740,37 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets whether the tooltip displays a drop shadow effect. + + property, the property value is `false` until the first time the tooltip is displayed. The default tooltip style is applied when a tooltip is displayed and the style sets the property to `true`. + + If the tooltip is a object and both the property and the property are specified, the value of the property is used. + + For information about how to get or set this property in code, see the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the attached property of the class. + + [!code-xml[ToolTipService#NoToolTip](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#notooltip)] + + ]]> + + + + @@ -757,8 +807,57 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the offset from the left of the area that is specified for the tooltip by the and properties. + + property and the property values provide additional adjustment to the position of a tooltip that is defined by the property and the property values. + + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## XAML Attribute Usage + +``` + +- or - + +``` + + +## XAML Values + `double` + + + A string representation of a value that is equal to or greater than 0.0 but that is smaller than . This is interpreted as a device-independent unit (1/96th of an inch per unit) measurement. Strings do not have to explicitly include decimal points. + + `qualifiedDouble` + A value that is followed by one of these unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + For information about how to get or set this property in code, see the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + + @@ -795,8 +894,37 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the length of time before a tooltip opens. + + property. However, after a tooltip is displayed there is a period of time during which another tooltip can be displayed without waiting for the time to pass. You specify this time period by using the property. When the user moves the mouse within this time period from one element that has a visible tooltip to another element that has a tooltip, the value of the property for the second tooltip is not applied and the second tooltip appears immediately. + + For information about how to get or set this property in code, see the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the timing properties. + + [!code-xml[ToolTipService#NoToolTip](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#notooltip)] + + ]]> + + The value of the property is less than zero (0). + + + + @@ -833,8 +961,37 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets whether a tooltip appears. + + property. + + For information about how to get or set this property in code, see the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the property. + + [!code-xml[ToolTipService#NoToolTip](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#notooltip)] + + [!code-csharp[ToolTipService#SetIsEnabled](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml.cs#setisenabled)] + [!code-vb[ToolTipService#SetIsEnabled](~/samples/snippets/visualbasic/VS_Snippets_Wpf/ToolTipService/visualbasic/pane1.xaml.vb#setisenabled)] + + ]]> + + + @@ -908,8 +1065,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries. + + and methods. + + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -946,8 +1122,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the rectangular area relative to which the tooltip is positioned. + + property specifies a structure relative to which the control is positioned when it opens. If is not `null`, the structure is defined relative to the object. Otherwise, the specified structure is defined relative to the upper-left corner of the screen. + + If the property is set to , the tooltip is displayed relative to the location of the mouse, and the value of the property has no effect. + + This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. + + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -984,8 +1183,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the object relative to which the tooltip is positioned. + + does not have to be the object on which the tooltip is defined. For example, a that describes an could specify its tooltip to appear over the when the user pauses the mouse pointer on the . + + If you do not specify a and the tooltip has a visual parent, the visual parent acts as the . If the tooltip does not have a visual parent and the value of the property is `null`, the tooltip control is positioned relative to the upper-left corner of the screen. + + This property is an attached property. For information about how to get or set this property in code, see the and methods. + + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -1547,8 +1769,40 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the amount of time that a tooltip remains visible. + + and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the property for a tooltip. + + [!code-xml[ToolTipService#NoToolTip](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#notooltip)] + + [!code-csharp[ToolTipService#SetShowDuration](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml.cs#setshowduration)] + [!code-vb[ToolTipService#SetShowDuration](~/samples/snippets/visualbasic/VS_Snippets_Wpf/ToolTipService/visualbasic/pane1.xaml.vb#setshowduration)] + + ]]> + + The value of the property is less than zero (0). + + + + @@ -1585,8 +1839,32 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets whether a tooltip appears for an object that is not enabled. + + and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the property. + + [!code-xml[ToolTipSimple#ShowOnDisabled](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipSimple/CSharp/Pane1.xaml#showondisabled)] + + ]]> + + + @@ -1623,8 +1901,49 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the content of a tooltip. + + element that has embedded controls and images. However, tooltip content cannot take focus. For example, a inside a tooltip cannot receive a event. + + [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] provides a control that defines a tooltip and provides properties that you can use to specify tooltip behavior. However, a tooltip can be any element, such as a or an . + + This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. + + The [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] syntax shown here is appropriate if the object that fills the tooltip is a primitive with native type conversion, such as a string. If the object does not support native type conversion or support its own type converter, you might need to specify a verbose form of attached property syntax as follows: + +``` + + + + + +``` + + The placeholder element *objectThatFillsTheToolTip* could also have child elements, if that object permits them. However, the need for this usage should be relatively rare, because most [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] usages will instead use practical control implementations of the service that are exposed by . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to specify a tooltip by using the . + + [!code-xml[ToolTipAssign#ToolTipServiceToolTip](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipAssign/CSharp/Pane1.xaml#tooltipservicetooltip)] + + ]]> + + + + @@ -1639,7 +1958,7 @@ 4.0.0.0 - To be added. + Occurs when the closes. To be added. @@ -1705,7 +2024,7 @@ 4.0.0.0 - To be added. + Occurs when the opens. To be added. @@ -1793,8 +2112,53 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance from the top of the area that is specified for the tooltip by the and properties. + + and methods. behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + + +## XAML Attribute Usage + +``` + +- or - + +``` + + +## XAML Values + `double` + + + The string representation of a value that is equal to or greater than 0.0 but smaller than . This is interpreted as a device-independent unit (1/96th inch) measurement. Strings do not have to explicitly include decimal points. + + `qualifiedDouble` + A value that is followed by one of these unit declaration strings: `px`, `in`, `cm`, `pt`. + + `px` (default) is [!INCLUDE[TLA#tla_dipixel#plural](~/includes/tlasharptla-dipixelsharpplural-md.md)] + + `in` is inches; 1in==96px + + `cm` is centimeters; 1cm==(96/2.54) px + + `pt` is points; 1pt==(96/72) px + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + + diff --git a/xml/System.Windows.Controls/Validation.xml b/xml/System.Windows.Controls/Validation.xml index 0a87c4d056e..c00b6e7fcbb 100644 --- a/xml/System.Windows.Controls/Validation.xml +++ b/xml/System.Windows.Controls/Validation.xml @@ -1,4 +1,4 @@ - + @@ -101,8 +101,38 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the bound element runs into a validation error, but only for bindings with the value set to . + + with your object. Validation occurs during binding target-to-binding source value transfer before the converter is called. The following describes the validation process: + +1. When a value is being transferred from the target property to the source property, the data binding engine first removes any that may have been added to the attached property of the bound element. It then checks if there are any custom s defined for that , in which case it calls the method on each of the s until one of them runs into an error or until all of them pass. + +2. Once there is a custom rule that does not pass, the binding engine creates a object and adds it to the collection of the bound element. When is not empty, the attached property of the element is set to `true`. Also, if the property of the is set to `true`, then the binding engine raises the attached event on the element. + +3. If all of the rules pass, the binding engine then calls the converter, if one exists. + +4. If the converter passes, the binding engine calls the setter of the source property. + +5. If the binding has an associated with it and an exception is thrown during step 4, the binding engine checks to see if there is a . You have the option to use the callback to provide a custom handler for handling exceptions. If an is not specified on the , the binding engine creates a with the exception and adds it to the collection of the bound element. + + Also note that a valid value transfer in either direction (target-to-source or source-to-target) clears the .attached property. + + For more information, see "Data Validation" in [Data Binding Overview](../Topic/Data%20Binding%20Overview.md). + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|, constrained by | + + ]]> + @@ -160,8 +190,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the used to generate validation error feedback on the adorner layer. + + with your object. If the user enters an invalid value, you may want to provide some feedback about the error on the application [!INCLUDE[TLA#tla_ui](~/includes/tlasharptla-ui-md.md)]. One way to provide such feedback is to set the . attached property to a custom . + + For a detailed discussion of validation, see the Data Validation section of the [Data Binding Overview](../Topic/Data%20Binding%20Overview.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + + @@ -510,8 +558,37 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the element that appears to indicate that a validation error occurred on the bound element where this property is set. + + and attached properties reference each other, and you can set either one. For example, suppose that a displays validation errors that occur on a data-bound . You can do one of the following to establish that relationship: + +- Set for the to the . + +- Set for the to the . + +- When you set one of the properties, the other property is set to the element on which you set the attached property; regardless of which of the previous options you choose, the for the is the and the for the is the . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + + +## Examples + The following example uses a as the adorner site for the validation errors that occur on items in an . The example sets the for each item container in the to the label. The example uses the property to get the item container that has the error and binds the of the to the first that is reported. + + [!code-xml[BindingGroupSnippets#ItemBindingGroup](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#itembindinggroup)] +[!code-xml[BindingGroupSnippets#ValidationAdornerSiteFor](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#validationadornersitefor)] + + ]]> + @@ -527,8 +604,37 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the element for which this element appears to indicate that an error occurred. + + and attached properties reference each other, and you can set either one. For example, suppose that a displays validation errors that occur on a data bound . You can do one of the following to establish that relationship: + +- Set for the to the . + +- Set for the to the . + + When you set one of the properties, the other property is set to the element on which you set the attached property; regardless of which of the previous options you choose, the for the is the and the for the is the . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + + +## Examples + The following example uses a as the adorner site for the validation errors that occur on items in an . The example sets the for each item container in the to the label. The example uses the property to get the item container that has the error and binds the of the to the first that is reported. + + [!code-xml[BindingGroupSnippets#ItemBindingGroup](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#itembindinggroup)] +[!code-xml[BindingGroupSnippets#ValidationAdornerSiteFor](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#validationadornersitefor)] + + ]]> + diff --git a/xml/System.Windows.Controls/VirtualizingPanel.xml b/xml/System.Windows.Controls/VirtualizingPanel.xml index c1b66ac4d41..8b341462994 100644 --- a/xml/System.Windows.Controls/VirtualizingPanel.xml +++ b/xml/System.Windows.Controls/VirtualizingPanel.xml @@ -1,4 +1,4 @@ - + @@ -153,8 +153,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the size of the cache before and after the viewport when the is virtualizing. + + property determines the unit of measurement that is used by . + + ]]> + @@ -189,8 +196,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the type of unit that is used by the property. + + enumeration. + + ]]> + @@ -593,8 +607,15 @@ 4.0.0.0 - To be added. - To be added. + Get or sets a value that indicates whether this should virtualize an item. + + + @@ -629,8 +650,30 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates that this is virtualizing its child collection. + + calculates the number of visible items and works with the from an (such as or ) to create [!INCLUDE[TLA2#tla_ui](~/includes/tla2sharptla-ui-md.md)] elements only for visible items. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to bind to an XML data source and virtualize the items displayed in a element by using [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)]. Notice that the attached property is explicitly set to `true`. + + [!code-xml[VirtualizingStackPanel_Intro#2](~/samples/snippets/csharp/VS_Snippets_Wpf/VirtualizingStackPanel_Intro/CS/default.xaml#2)] + + ]]> + @@ -665,8 +708,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether this virtualizes the items in its collection when it displays groups. + + + @@ -806,7 +856,7 @@ 4.0.0.0 - To be added. + Gets a value that indicates whether scrolling is measured as items in the collection or as pixels. To be added. @@ -1092,8 +1142,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets how a panel in an virtualizes its child items. + + creates an item container for each visible item and discards it when it is no longer needed (such as when the item is scrolled out of view). When an contains a lot of items, the process of creating and discarding item containers can negatively affect performance. When is set to , the reuses item containers instead of creating a new one each time. + + + +## Examples + The following example creates a and sets the attached property to . + + [!code-xml[RecycleItemContainerShippets#VirtualizationMode](~/samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml#virtualizationmode)] + + The following example shows the data used in the previous example. + + [!code-csharp[RecycleItemContainerShippets#ListBoxData](~/samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml.cs#listboxdata)] + [!code-vb[RecycleItemContainerShippets#ListBoxData](~/samples/snippets/visualbasic/VS_Snippets_Wpf/RecycleItemContainerShippets/visualbasic/window1.xaml.vb#listboxdata)] + + ]]> + diff --git a/xml/System.Windows.Controls/VirtualizingStackPanel.xml b/xml/System.Windows.Controls/VirtualizingStackPanel.xml index 2f743d1c90c..d4577e086c6 100644 --- a/xml/System.Windows.Controls/VirtualizingStackPanel.xml +++ b/xml/System.Windows.Controls/VirtualizingStackPanel.xml @@ -1,4 +1,4 @@ - + @@ -263,8 +263,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an item is being re-virtualized by the that is associated with this instance of . + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Direct| +|Delegate|| + + ]]> + + diff --git a/xml/System.Windows.Data/Binding.xml b/xml/System.Windows.Data/Binding.xml index 95d8747f74b..54a2185c0f5 100644 --- a/xml/System.Windows.Data/Binding.xml +++ b/xml/System.Windows.Data/Binding.xml @@ -1,4 +1,4 @@ - + @@ -1062,8 +1062,25 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a value is transferred from the binding target to the binding source, but only for bindings with the value set to . + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|, constrained to .| + + ]]> + + + @@ -1100,8 +1117,25 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a value is transferred from the binding source to the binding target, but only for bindings with the value set to . + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|, constrained to .| + + ]]> + + + @@ -1416,8 +1450,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the used to perform namespace-aware queries in XML bindings. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + diff --git a/xml/System.Windows.Documents/FixedPage.xml b/xml/System.Windows.Documents/FixedPage.xml index 2adc9f01e90..f17a214eb6b 100644 --- a/xml/System.Windows.Documents/FixedPage.xml +++ b/xml/System.Windows.Documents/FixedPage.xml @@ -1,4 +1,4 @@ - + @@ -248,8 +248,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the bottom of the page and the bottom of the parent . + + returns . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + + + + @@ -653,8 +671,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the left edge of the page and the left edge of the parent . + + returns . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + + + + @@ -739,8 +775,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the URI associated with the page. + + returns `null`. When you set the on one of the objects listed, the application attempts to navigate to the value specified when the object is clicked. + + You can use the attached property from the following objects: , , , and . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -936,8 +989,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the right edge of the page and the right edge of the parent . + + returns . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + + + + @@ -1275,8 +1346,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the distance between the top of the page and the top of the parent . + + returns . + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + + + + diff --git a/xml/System.Windows.Forms/PropertyGrid.xml b/xml/System.Windows.Forms/PropertyGrid.xml index b76430d63d9..0deb697117f 100644 --- a/xml/System.Windows.Forms/PropertyGrid.xml +++ b/xml/System.Windows.Forms/PropertyGrid.xml @@ -1,4 +1,4 @@ - + @@ -3212,7 +3212,7 @@ System.ComponentModel.Design.ComponentRenameEventHandler - To be added. + Occurs when the control is browsing a COM object and the user renames the object. To be added. diff --git a/xml/System.Windows.Input/AccessKeyManager.xml b/xml/System.Windows.Input/AccessKeyManager.xml index 32ddbc497fb..2d182c8004e 100644 --- a/xml/System.Windows.Input/AccessKeyManager.xml +++ b/xml/System.Windows.Input/AccessKeyManager.xml @@ -1,4 +1,4 @@ - + @@ -48,8 +48,17 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the access key is pressed. + + field will never be raised; it is used to identify classes that define new scopes. + + ]]> + diff --git a/xml/System.Windows.Input/CommandManager.xml b/xml/System.Windows.Input/CommandManager.xml index e9676905a0e..6f695363aec 100644 --- a/xml/System.Windows.Input/CommandManager.xml +++ b/xml/System.Windows.Input/CommandManager.xml @@ -1,4 +1,4 @@ - + @@ -269,8 +269,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the method on the is called and the event was not handled. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + ]]> + + @@ -307,8 +323,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the method on the is called and the event was not handled. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + ]]> + + @@ -382,8 +414,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the method on the is called. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + ]]> + + @@ -420,8 +468,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the method on the is called. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + ]]> + + diff --git a/xml/System.Windows.Input/FocusManager.xml b/xml/System.Windows.Input/FocusManager.xml index 07f6cbdcfda..bbdd4ccb6b7 100644 --- a/xml/System.Windows.Input/FocusManager.xml +++ b/xml/System.Windows.Input/FocusManager.xml @@ -1,4 +1,4 @@ - + @@ -105,8 +105,32 @@ 4.0.0.0 - To be added. - To be added. + Determines whether the element this property is attached to has logical focus. + + is the element which has logical focus for a specific focus scope. This object may or may not have keyboard focus. Keyboard focus refers to the element that receives keyboard input. For more information on focus, keyboard focus, and logical focus, see the [Input Overview](../Topic/Input%20Overview.md). + + and can be used to get and set the focused element within the specified focus scope. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + + +## Examples + The following example shows how to make a the focused element. + + [!code-xml[markupsnippets#MarkupFocusManagerFocusedElementXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml#markupfocusmanagerfocusedelementxaml)] + + ]]> + @@ -269,7 +293,7 @@ 4.0.0.0 - To be added. + Occurs when an element gets focus. To be added. @@ -307,8 +331,32 @@ 4.0.0.0 - To be added. - To be added. + Determines whether the element this property is attached to is a focus scope. + + within its scope. By default, the class is a focus scope as are the , , and classes. An element which is a focus scope has set to `true`. + + For more information on focus, keyboard focus, and logical focus, see the [Input Overview](../Topic/Input%20Overview.md). + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + + +## Examples + The following example makes a a focus scope. + + [!code-xml[markupsnippets#MarkupIsFocusScopeXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml#markupisfocusscopexaml)] + + ]]> + @@ -355,7 +403,7 @@ 4.0.0.0 - To be added. + Occurs when an element loses focus. To be added. diff --git a/xml/System.Windows.Input/InputLanguageManager.xml b/xml/System.Windows.Input/InputLanguageManager.xml index 61b37e39bc9..ae15df6d6ff 100644 --- a/xml/System.Windows.Input/InputLanguageManager.xml +++ b/xml/System.Windows.Input/InputLanguageManager.xml @@ -1,4 +1,4 @@ - + @@ -243,8 +243,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the preferred input language for the associated dependency object. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + When the associated dependency object receives the input focus, the input language specified by this attached property is selected automatically. + + ]]> + + + @@ -412,8 +430,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether or not the previously active input language should be restored when the associated dependency object looses the input focus. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + This property has no effect if the attached property is not available on the associated dependency object. + + ]]> + + + diff --git a/xml/System.Windows.Input/InputMethod.xml b/xml/System.Windows.Input/InputMethod.xml index 06401d2cedc..f2947160fc2 100644 --- a/xml/System.Windows.Input/InputMethod.xml +++ b/xml/System.Windows.Input/InputMethod.xml @@ -1,4 +1,4 @@ - + @@ -495,8 +495,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the input scope for a specified dependency object. + + and methods to set or read this attached property on a specified dependency object. + + ]]> + @@ -533,8 +540,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether this input method is enabled. + + and methods to set or read this attached property on a specified dependency object. + + ]]> + @@ -571,8 +585,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether this input method is suspended. + + and methods to set or read this attached property on a specified dependency object. + + ]]> + @@ -644,8 +665,19 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a preferred value for a specified dependency object. + + and methods to set or read this attached property on a specified dependency object. + + When this property is attached to a , the input method automatically switches to the preferred conversion mode when that **UIElement** gets the focus. + + ]]> + + + @@ -682,8 +714,19 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a preferred value for a specified dependency object. + + and methods to set or read this attached property on a specified dependency object. + + When this property is attached to a , the input method automatically switches to the preferred sentence mode when that gets the focus. + + ]]> + + + @@ -720,8 +763,19 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a preferred input method state for a specified dependency object. + + and methods to set or read this attached property on a specified dependency object. + + When this property is attached to a , the input method automatically switches to the preferred state (usually **On** or **Off**) when that **UIElement** gets the focus. + + ]]> + + + diff --git a/xml/System.Windows.Input/Keyboard.xml b/xml/System.Windows.Input/Keyboard.xml index 25608c2b5c7..52e9c9e52fd 100644 --- a/xml/System.Windows.Input/Keyboard.xml +++ b/xml/System.Windows.Input/Keyboard.xml @@ -1,4 +1,4 @@ - + @@ -576,8 +576,43 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element receives keyboard focus. + + set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + + If the event or the event is handled, keyboard focus does change. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + + +## Examples + The following example creates a and attaches event handlers for the event and the event. When the obtains keyboard focus, the background color is changed and the text of the is cleared. When the loses keyboard focus, the background color is changed and a method is called which resets variables used in the sample. + + [!code-xml[keyboardsample#KeyboardSampleXAMLHandlerHookup](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml#keyboardsamplexamlhandlerhookup)] + + [!code-csharp[keyboardsample#KeyboardSampleGotFocus](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml.cs#keyboardsamplegotfocus)] + [!code-vb[keyboardsample#KeyboardSampleGotFocus](~/samples/snippets/visualbasic/VS_Snippets_Wpf/KeyboardSample/visualbasic/window1.xaml.vb#keyboardsamplegotfocus)] + + [!code-csharp[keyboardsample#KeyboardSampleLostFocus](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml.cs#keyboardsamplelostfocus)] + [!code-vb[keyboardsample#KeyboardSampleLostFocus](~/samples/snippets/visualbasic/VS_Snippets_Wpf/KeyboardSample/visualbasic/window1.xaml.vb#keyboardsamplelostfocus)] + + ]]> + @@ -749,8 +784,26 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the keyboard input provider acquires focus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + ]]> + @@ -793,8 +846,37 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a key on the keyboard is pressed. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + + +## Examples + The following example creates that attaches an event handler for the event. When the is pressed, the event handler displays the text in the in a . + + [!code-xml[keydown#KeyDownUI](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyDown/CSharp/Window1.xaml#keydownui)] + + [!code-csharp[keydown#KeyDownSample](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyDown/CSharp/Window1.xaml.cs#keydownsample)] + [!code-vb[keydown#KeyDownSample](~/samples/snippets/visualbasic/VS_Snippets_Wpf/KeyDown/VisualBasic/Window1.xaml.vb#keydownsample)] + + ]]> + + @@ -838,8 +920,27 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a key on the keyboard is released. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + ]]> + + @@ -883,8 +984,43 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element loses keyboard focus. + + set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + + If the event or the event is handled, keyboard focus does not change. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + + +## Examples + The following example creates a and attaches event handlers for the event and the event. When the obtains keyboard focus, the background color is changed and the text of the is cleared. When the loses keyboard focus, the background color is changed and a method is called that resets variables used in the sample. + + [!code-xml[keyboardsample#KeyboardSampleXAMLHandlerHookup](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml#keyboardsamplexamlhandlerhookup)] + + [!code-csharp[keyboardsample#KeyboardSampleGotFocus](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml.cs#keyboardsamplegotfocus)] + [!code-vb[keyboardsample#KeyboardSampleGotFocus](~/samples/snippets/visualbasic/VS_Snippets_Wpf/KeyboardSample/visualbasic/window1.xaml.vb#keyboardsamplegotfocus)] + + [!code-csharp[keyboardsample#KeyboardSampleLostFocus](~/samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml.cs#keyboardsamplelostfocus)] + [!code-vb[keyboardsample#KeyboardSampleLostFocus](~/samples/snippets/visualbasic/VS_Snippets_Wpf/KeyboardSample/visualbasic/window1.xaml.vb#keyboardsamplelostfocus)] + + ]]> + @@ -965,8 +1101,30 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element is in the process of acquiring keyboard focus. + + event or the event is handled, keyboard focus does not change. + + Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1009,8 +1167,26 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the keyboard input provider is in the process of acquiring focus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1053,8 +1229,26 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a key on the keyboard is pressed. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1098,8 +1292,26 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a key on the keyboard is released. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1143,8 +1355,30 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element is in the process of losing keyboard focus. + + event or the event is handled, keyboard focus does not change. + + Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + diff --git a/xml/System.Windows.Input/KeyboardNavigation.xml b/xml/System.Windows.Input/KeyboardNavigation.xml index 92f3916443d..9ebbf0de835 100644 --- a/xml/System.Windows.Input/KeyboardNavigation.xml +++ b/xml/System.Windows.Input/KeyboardNavigation.xml @@ -1,4 +1,4 @@ - + @@ -54,8 +54,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value indicating whether the Return character is accepted by a control. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + ]]> + + @@ -92,8 +107,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the logical control tab navigation behavior for the children of the element that this property is set on. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + ]]> + + @@ -135,8 +168,24 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the directional navigation behavior for the children of the element that this property is set on. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + ]]> + + @@ -382,8 +431,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value indicating whether the element that this property is set on is a tab stop. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + ]]> + + @@ -600,8 +664,23 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the tab index for the element that this property is set on. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + ]]> + + @@ -638,8 +717,34 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the logical tab navigation behavior for the children of the element that this property is set on. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to **true**|None| + + + +## Examples + The following example creates a with a number of objects. The attached property is set to on the . This means that when focus is changed using the tab key within the , focus will move from each element and when the last element is reached focus will return to the first element. + + [!code-xml[MarkupSnippets#MarkupKeyboardNavigationTabNavigationXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml#markupkeyboardnavigationtabnavigationxaml)] + + [!code-csharp[MarkupSnippets#MarkupKeyboardNavigationTabNavigationCODE](~/samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml.cs#markupkeyboardnavigationtabnavigationcode)] + [!code-vb[MarkupSnippets#MarkupKeyboardNavigationTabNavigationCODE](~/samples/snippets/visualbasic/VS_Snippets_Wpf/MarkupSnippets/visualbasic/window1.xaml.vb#markupkeyboardnavigationtabnavigationcode)] + + ]]> + + diff --git a/xml/System.Windows.Input/Mouse.xml b/xml/System.Windows.Input/Mouse.xml index 84674131315..062cd61d3aa 100644 --- a/xml/System.Windows.Input/Mouse.xml +++ b/xml/System.Windows.Input/Mouse.xml @@ -1,4 +1,4 @@ - + @@ -719,8 +719,30 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element captures the mouse. + + in the event arguments to determine the actual element that has mouse capture. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- There is no defined corresponding tunneling event. + + ]]> + @@ -797,8 +819,30 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element loses mouse capture. + + in the event arguments to determine the actual element that lost capture. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- There is no defined corresponding tunneling event. + + ]]> + @@ -875,8 +919,41 @@ 4.0.0.0 - To be added. - To be added. + Occurs when any mouse button is depressed. + + property in the passed to the handler. + + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + + The [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] framework builds on this attached event by surfacing it as two different [!INCLUDE[TLA#tla_clr](~/includes/tlasharptla-clr-md.md)] events on and : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For a three-button mouse, there is no framework-level event support for the center button. You should use the event and check the state in the event arguments. + +> [!IMPORTANT] +> A few derived classes that have control-like behavior, for example, , might have inherent class handling for mouse button events. The left mouse button down event is the most likely event to have class handling in a control. The class handling often marks the underlying class event as handled. Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Any other class or instance handlers that are attached to elements in the bubbling direction towards the root in the UI tree are also not ordinarily raised. + + You can resolve the issue that is outlined in the preceding Important note and still receive events for left mouse button down events on a derived class that has class handling by using either of these solutions: + +- Attach handlers for the event, which is not marked as handled by the controls. Notice that because this is a preview event, the route starts at the root and tunnels down to the control. + +- Register a handler on the control procedurally by calling and choosing the signature option that enables handlers to listen for events even if they are already marked as handled in the routed event data. + + For routed events that relate to the mouse, be careful about how or when you mark them handled. The difficulty in making the appropriate choices about whether parent elements should also be informed about any given mouse action is in fact why the [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] framework chose the model of having the underlying mouse routed event be surfaced as [!INCLUDE[TLA2#tla_clr](~/includes/tla2sharptla-clr-md.md)] events along the route. Similar issues exist with tunneling mouse events. Should you handle the event and not have it be handled by further children toward the source, and how would that affect compositing a control where the compositing pieces might have expected mouse behaviors? + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + ]]> + @@ -920,8 +997,28 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the mouse pointer enters the boundaries of an element. + + property has changed from `false` to `true` on this element. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Direct| +|Delegate|| + + ]]> + @@ -965,8 +1062,27 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the mouse pointer leaves the boundaries of an element. + + property value has changed from `true` to `false` on this element. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Direct| +|Delegate|| + + ]]> + @@ -1010,8 +1126,25 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the mouse pointer moves. + + | +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + ]]> + @@ -1055,8 +1188,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when any mouse button is released. + + : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For three-button, there is no framework-level event support for the center button, and you should use the event and check for the center button condition in the event arguments. + + For routed events that relate to the mouse, be careful about how or when you mark them handled. The difficulty in making the appropriate choices about whether parent elements should also be informed about any given mouse action is in fact why the [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] framework chose the model of having the underlying routed event be surfaced as [!INCLUDE[TLA2#tla_clr](~/includes/tla2sharptla-clr-md.md)] events all along the route. + + Similar issues exist with tunneling mouse events. Should you handle the event and not have it be handled by children further towards the source, and how would that affect compositing in a control where the compositing pieces might have expected mouse behaviors? + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + ]]> + @@ -1100,8 +1258,28 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the mouse wheel is rotated. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + +- The corresponding tunneling event is . + + ]]> + @@ -1216,8 +1394,32 @@ 4.0.0.0 - To be added. - To be added. + Occurs when any mouse button is depressed. + + : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For three-button, there is no framework-level event support for the center button, and you should use the event and check for the center button condition in the event arguments. + + For routed events that relate to the mouse, be careful about how or when you mark them handled. Handling the event near the root and handling it by a child further toward the source may not be appropriate for composited controls, where the compositing pieces might have expected mouse behaviors. The difficulty in making the appropriate choices about whether other elements should also be informed about any given mouse action is in fact why the [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] framework chose the model of having the underlying routed event be surfaced as [!INCLUDE[TLA2#tla_clr](~/includes/tla2sharptla-clr-md.md)] events along the route. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1261,8 +1463,26 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the primary mouse button is pressed outside the element that is capturing mouse events. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + ]]> + @@ -1306,8 +1526,28 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the mouse moves over an element. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1351,8 +1591,31 @@ 4.0.0.0 - To be added. - To be added. + Occurs when any mouse button is released. + + : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For three-button, there is no framework-level event support for the center button, and you should use the event and check for the center button condition in the event arguments. + + For routed events that relate to the mouse, be careful about how or when you mark them handled. Handling the event near the root and not handling by a child further toward the source may not be appropriate for composited controls, where the compositing pieces might have expected mouse behaviors. The difficulty in making the appropriate choices about whether other elements should also be informed about any given mouse action is in fact why the [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] framework chose the model of having the underlying routed event be surfaced as [!INCLUDE[TLA2#tla_clr](~/includes/tla2sharptla-clr-md.md)] events along the route. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1396,8 +1659,28 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the primary mouse button is released outside the element that is capturing mouse events. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- There is no corresponding bubbling event. + + ]]> + @@ -1441,8 +1724,28 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the mouse wheel rotates. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + +- The corresponding bubbling event is . + + ]]> + @@ -1521,8 +1824,26 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element queries for the current mouse cursor. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + There is no defined corresponding tunneling event. + + ]]> + diff --git a/xml/System.Windows.Input/Stylus.xml b/xml/System.Windows.Input/Stylus.xml index f1eec47eb97..e9e6a57420e 100644 --- a/xml/System.Windows.Input/Stylus.xml +++ b/xml/System.Windows.Input/Stylus.xml @@ -1,4 +1,4 @@ - + @@ -1008,8 +1008,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element captures the stylus events. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to change the background color of a when the captures and releases stylus events. This example assumes that there is a textbox called `textBox1`, and that the and events are connected to event handlers. + + [!code-csharp[StylusSamples#10](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#10)] + [!code-vb[StylusSamples#10](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#10)] + + ]]> + + @@ -1046,8 +1071,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value indicating whether flicks are enabled. + + , , and . Flicks are enabled on all other controls. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example demonstrates how to disable flicks on a . + + [!code-xml[StylusXAML#1](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window1.xaml#1)] + [!code-xml[StylusXAML#1](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window1.xaml#1)] + + ]]> + @@ -1084,8 +1132,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a values indicating whether press and hold is enabled. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example demonstrates how to enable press and hold on a . + + [!code-xml[StylusXAML#3](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window1.xaml#3)] + [!code-xml[StylusXAML#3](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window1.xaml#3)] + + ]]> + @@ -1122,8 +1193,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets whether a value indicating whether tap feedback is enabled. + + . It is enabled on all other controls. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example disables tap feedback on a . + + [!code-xml[StylusXAML#2](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window2.xaml#2)] + [!code-xml[StylusXAML#2](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window2.xaml#2)] + + ]]> + @@ -1160,8 +1254,31 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets whether a value indicating whether touch feedback is enabled. + + . It is enabled on all other controls. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example enables touch feedback on an . + + [!code-xml[StylusXAML#4](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window1.xaml#4)] + [!code-xml[StylusXAML#4](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window1.xaml#4)] + + ]]> + @@ -1198,8 +1315,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an element releases stylus events. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to change the background color of a when the captures and releases stylus events. This example assumes that there is a textbox called `textBox1`, and that the and events are connected to the event handlers in the example. + + [!code-csharp[StylusSamples#10](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#10)] + [!code-vb[StylusSamples#10](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#10)] + + ]]> + + @@ -1236,8 +1378,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user presses one of the buttons on the stylus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine which button raised the event. This example assumes that there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#13](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#13)] + [!code-vb[StylusSamples#13](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#13)] + + ]]> + + @@ -1274,8 +1441,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user releases one of the buttons on the stylus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine which button raised the event. This example assumes that there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#14](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#14)] + [!code-vb[StylusSamples#14](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#14)] + + ]]> + + @@ -1312,8 +1504,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when user touches the tip of the stylus to the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to ensure that the stylus is not captured when the user touches the stylus to the tablet. This example assumes that the event is connected to the event handler. + + [!code-csharp[StylusSamples#5](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#5)] + [!code-vb[StylusSamples#5](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#5)] + + ]]> + + @@ -1350,8 +1567,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs if the stylus moves while it is within range of (but not touching) the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine which element the stylus is positioned over. This example assumes that there is a called `textBox1`, and that the event is connected to the event handler. + + [!code-csharp[StylusSamples#15](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#15)] + [!code-vb[StylusSamples#15](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#15)] + + ]]> + + @@ -1388,8 +1630,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus comes within range of the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine whether the stylus is inverted. This example assumes that there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#21](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#21)] + [!code-vb[StylusSamples#21](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#21)] + + ]]> + + @@ -1426,8 +1693,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus moves while it is touching the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The example demonstrates how to determine the position of the stylus when it moves. This example assumes that there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#16](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#16)] + [!code-vb[StylusSamples#16](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#16)] + + ]]> + + @@ -1464,8 +1756,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus goes out of range of the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine whether the stylus is inverted. This example assumes there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#20](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#20)] + [!code-vb[StylusSamples#20](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#20)] + + ]]> + + @@ -1502,8 +1819,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user makes a system gesture with this stylus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine the system gesture that raised the event. This example assumes that there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#17](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#17)] + [!code-vb[StylusSamples#17](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#17)] + + ]]> + + @@ -1540,8 +1882,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user lifts the stylus from the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine the position of the stylus when the user lifts it from the tablet. This example assumes that there is a called `textBox1` and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#22](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#22)] + [!code-vb[StylusSamples#22](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#22)] + + ]]> + + @@ -2339,8 +2706,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user presses one of the buttons on the stylus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to show a shortcut menu when the user presses the barrel button on a stylus. This example assumes that there is a called `textBox1`, and a called `textBoxContextMenu`, and that the event is connected to the event handler. + + [!code-csharp[StylusSamples#2](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#2)] + [!code-vb[StylusSamples#2](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#2)] + + ]]> + + @@ -2377,8 +2769,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user releases one of the buttons on the stylus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to copy the selected text when the user releases the barrel button on a stylus. This example assumes that there is a called `textBox1`, and that the event is connected to the event handlers. + + [!code-csharp[StylusSamples#11](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#11)] + [!code-vb[StylusSamples#11](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#11)] + + ]]> + + @@ -2415,8 +2832,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user touches the tip of the stylus to the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to record the coordinates of the stylus, even if the stylus leaves the bounds of a . This example assumes that there is a called `textBox1`, and that the , , and events are connected to the event handlers. + + [!code-csharp[StylusSamples#1](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#1)] + [!code-vb[StylusSamples#1](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#1)] + + ]]> + + @@ -2453,8 +2895,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus cursor enters the bounds of an element. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Direct| +|Delegate|| + + + +## Examples + The following example demonstrates how to change the color of a when the stylus cursor enters and leaves its bounds. This example assumes that there is a called `button1` and that the and events are connected to the event handlers. + + [!code-csharp[StylusSamples#4](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#4)] + [!code-vb[StylusSamples#4](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#4)] + + ]]> + + @@ -2491,8 +2958,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus moves while it is in range of, but not touching, the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine which element the stylus is positioned over. This example assumes that there is a called `textBox1` and that the event is connected to the event handler. + + [!code-csharp[StylusSamples#3](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#3)] + [!code-vb[StylusSamples#3](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#3)] + + ]]> + + @@ -2529,8 +3021,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus comes within range of the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to set the property of an to when the stylus is inverted. This example assumes that there is an called `inkCanvas1` and that the event is connected to the event handlers. To see the cursor change, set the property to `true` on `inkCanvas1`. + + [!code-csharp[StylusSamples#18](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window2.xaml.cs#18)] + [!code-vb[StylusSamples#18](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window2.xaml.vb#18)] + + ]]> + + @@ -2567,8 +3084,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus cursor leaves the bounds of an element. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Direct| +|Delegate|| + + + +## Examples + The following example demonstrates how to change the color of a when the stylus cursor enters and leaves its bounds. This example assumes that there is a called `button1` and that the and events are connected to event handlers. + + [!code-csharp[StylusSamples#4](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#4)] + [!code-vb[StylusSamples#4](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#4)] + + ]]> + + @@ -2605,8 +3147,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus moves while it is touching the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to record the coordinates of the stylus, even if the stylus leaves the bounds of a . This example assumes that there is a called `textBox1`, and that the , , and events are connected to event handlers. + + [!code-csharp[StylusSamples#1](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#1)] + [!code-vb[StylusSamples#1](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#1)] + + ]]> + + @@ -2643,8 +3210,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the stylus goes out of range of the tablet. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to change the cursor to an arrow when the stylus goes out of range. This example assumes that there is an called `inkCanvas1` and that the event is connected to an event handler. To see the cursor change, set the property to `true` on `inkCanvas1`. + + [!code-csharp[StylusSamples#19](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window2.xaml.cs#19)] + [!code-vb[StylusSamples#19](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window2.xaml.vb#19)] + + ]]> + + @@ -2681,8 +3273,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user makes a system gesture with this stylus. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to determine the system gesture that raised the event. This example assumes that there is a called `textBox1` and that the event is connected to an event handler. + + [!code-csharp[StylusSamples#12](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#12)] + [!code-vb[StylusSamples#12](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#12)] + + ]]> + + @@ -2719,8 +3336,33 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the user raises the stylus from the Tablet PC. + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + + +## Examples + The following example demonstrates how to record the coordinates of the stylus, even if the stylus leaves the bounds of a . This example assumes that there is a called `textBox1`, and that the , , and events are connected to event handlers. + + [!code-csharp[StylusSamples#1](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusSamples/CSharp/Window1.xaml.cs#1)] + [!code-vb[StylusSamples#1](~/samples/snippets/visualbasic/VS_Snippets_Wpf/StylusSamples/VisualBasic/Window1.xaml.vb#1)] + + ]]> + + diff --git a/xml/System.Windows.Input/TextCompositionManager.xml b/xml/System.Windows.Input/TextCompositionManager.xml index 2cb62704834..bf31c427ca7 100644 --- a/xml/System.Windows.Input/TextCompositionManager.xml +++ b/xml/System.Windows.Input/TextCompositionManager.xml @@ -1,4 +1,4 @@ - + @@ -283,8 +283,19 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a is completed. + + . + + This is an attached event identified by the field. Use the and methods to manage this event on a specified dependency object. + + ]]> + + + @@ -321,8 +332,19 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a new is started. + + . + + This is an attached event identified by the field. Use the and methods to manage this event on a specified dependency object. + + ]]> + + + @@ -359,8 +381,19 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a is updated. + + . + + This is an attached event identified by the field. Use the and methods to manage this event on a specified dependency object. + + ]]> + + + @@ -640,8 +673,19 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a is completed. + + . + + This is an attached event. Use the and methods to manage this event on a specified dependency object. + + ]]> + + + @@ -678,8 +722,19 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a new is started. + + . + + This is an attached event. Use the and methods to manage this event on a specified dependency object. + + ]]> + + + @@ -716,8 +771,19 @@ 4.0.0.0 - To be added. - To be added. + Occurs when a is updated. + + . + + This is an attached event. Use the and methods to manage this event on a specified dependency object. + + ]]> + + + diff --git a/xml/System.Windows.Markup/XmlAttributeProperties.xml b/xml/System.Windows.Markup/XmlAttributeProperties.xml index 3330bd1bae2..1ee354c7396 100644 --- a/xml/System.Windows.Markup/XmlAttributeProperties.xml +++ b/xml/System.Windows.Markup/XmlAttributeProperties.xml @@ -1,4 +1,4 @@ - + @@ -296,8 +296,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets an attached property value that stores XML namespace maps for use by the WPF XAML parser for .NET Framework 3.0 and .NET Framework 3.5. + + +## XAML Text Usage + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + @@ -339,8 +356,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the attached property value that stores definitions for use by the WPF XAML parser for .NET Framework 3.0 and .NET Framework 3.5. + + +## XAML Text Usage + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + @@ -382,8 +416,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the attached property value that stores dictionaries for use by the WPF XAML parser for .NET Framework 3.0 and .NET Framework 3.5. + + +## XAML Text Usage + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|| + + ]]> + @@ -425,8 +476,25 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the mapped value of the property. + + +## XAML Text Usage + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + diff --git a/xml/System.Windows.Media.Animation/Storyboard.xml b/xml/System.Windows.Media.Animation/Storyboard.xml index 6241d6abf9b..e95ce8d5930 100644 --- a/xml/System.Windows.Media.Animation/Storyboard.xml +++ b/xml/System.Windows.Media.Animation/Storyboard.xml @@ -1,4 +1,4 @@ - + @@ -2759,8 +2759,26 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the object that should be animated. + + [!NOTE] +> The property is not serializable, because it can be set to any . There is no guaranteed that this object can be correctly referenced in XAML. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + @@ -2776,8 +2794,38 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the name of the object to animate. The object must be a , , or . + + is not specified, a storyboard's animations are applied to one of the following: + +- If the storyboard to which the animation belongs was started using a , the element that owns the action that triggers the storyboard is targeted. + +- If the storyboard was started using the method, the or specified when the storyboard was started with the method is targeted. + + When this property is set on a timeline with children, those child timelines "inherit" the parent's unless they specify their own. + +## Making an Object Targetable + When using [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)], you perform one of the following two actions to make an object targetable by a storyboard: + +- If the object is a or a , set its property. + +- If the object is a or a custom or , assign it a name using the [x:Name Directive](../Topic/x:Name%20Directive.md) markup extension. + + When using code, you make an object targetable by using the method to assign the object a name. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + diff --git a/xml/System.Windows.Media/RenderOptions.xml b/xml/System.Windows.Media/RenderOptions.xml index d0a2fe39792..7ddb90cc4e3 100644 --- a/xml/System.Windows.Media/RenderOptions.xml +++ b/xml/System.Windows.Media/RenderOptions.xml @@ -1,4 +1,4 @@ - + @@ -40,8 +40,29 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the for a given . + + property on a or descendant that is animating a bitmap. + + When animating the scale of any bitmap, the default high-quality image re-sampling algorithm can sometimes consume sufficient system resources to cause frame rate degradation, effectively causing animations to stutter. By setting the property to , you can create a smoother animation when scaling a bitmap. + + To access this property in code, use the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + @@ -78,8 +99,41 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the cache invalidation threshold maximum value for a given . + + and its derived types. It is intended to be used with brushes that have intermediate surfaces, such as and . It only has an effect when the property is set to . + + By default, [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] does not cache the rendered contents of and objects. In static scenarios, where neither the contents nor the use of the brush in the scene is changing, not caching the content provides a benefit because it conserves video memory. When a brush with static content is used in a non-static way, the default behavior of [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] is to re-render all the content of the brush every frame, even though the content is unchanging. For example, this will happen when a static or is mapped to the surface of a rotating 3D object. Re-rendering the static content can have a negative impact on performance. + + By setting the attached property on the brush to , you can increase performance by using cached versions of the tiled brush objects. + + The and property values are relative-size values that determine when the object should be regenerated because of changes in scale. For example, when the property is set to 2.0, the cache for the needs to be regenerated only when its size exceeds two times the size of the current cache. + + To access this property in code, use the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to use the caching hint option for a . + + [!code-xml[RenderOptions#CachingXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/RenderOptions/CSharp/Window1.xaml#cachingxaml)] + + ]]> + + + + @@ -116,8 +170,41 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the cache invalidation threshold minimum value for a given . + + and its derived types. It is intended to be used with brushes that have intermediate surfaces, such as and . It only has an effect when the property is set to . + + By default, [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] does not cache the rendered contents of and objects. In static scenarios, where neither the contents nor the use of the brush in the scene is changing, not caching the content provides a benefit because it conserves video memory. When a brush with static content is used in a non-static way the default behavior of [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] is to re-render all the content of the brush every frame, even though the content is unchanging. For example, this will happen when a static or is mapped to the surface of a rotating 3D object. Re-rendering the static content can have a negative impact on performance. + + By setting the attached property on the brush to , you can increase performance by using cached versions of the tiled brush objects. + + The and property values are relative-size values that determine when the object should be regenerated because of changes in scale. For example, when the property is set to 0.5, the cache for the needs to be regenerated only when its size is reduced to less than one half the size of the current cache. + + To access this property in code, use the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to use the caching hint option for a . + + [!code-xml[RenderOptions#CachingXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/RenderOptions/CSharp/Window1.xaml#cachingxaml)] + + ]]> + + + + @@ -154,8 +241,42 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates that rendered content should be cached when possible. + + and its derived types. It is intended to be used with brushes that have intermediate surfaces, such as and . + + By default, [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] does not cache the rendered contents of and objects. In static scenarios, where neither the contents nor the use of the brush in the scene is changing, not caching provides a benefit because it conserves video memory. When a brush with static content is used in a non-static way, the default behavior of [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] is to re-render all the content of the brush every frame, even though the content is unchanging. For example, this will happen when a static or is mapped to the surface of a rotating 3D object. Re-rendering the static content can have a negative impact on performance. + + By setting the attached property of the brush to , you can increase performance by using cached versions of the tiled brush objects. + + The and property values are relative-size values that determine when the object should be regenerated because of changes in scale. For example, when the property is set to 2.0, the cache for the needs to be regenerated only when its size exceeds two times the size of the current cache. + + To access this property in code, use the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to use the caching hint option for a . + + [!code-xml[RenderOptions#CachingXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/RenderOptions/CSharp/Window1.xaml#cachingxaml)] + + ]]> + + + + + @@ -191,8 +312,45 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates to the rendering engine whether text can be rendered with ClearType. + + attached property to indicate that text can be rendered with ClearType in a specific part of the visual tree. + + ClearType text does not display correctly on a background that is not fully opaque. Intermediate render targets, such as , , , , , and , can introduce backgrounds that are not fully opaque. WPF disables ClearType when it detects that the buffer into which text is drawn could have a transparent background. + + Set the property to to indicate that a subtree is safe for ClearType text rendering. Do this only when you can be certain that the text is rendering to a fully opaque background. When an element in the subtree introduces transparency, you can enable ClearType; however, rendering issues may occur. If a portion of the subtree introduces more intermediate rendering targets, you must set again on the children of that subtree. + + The following list shows how to make sure that text to be rendered with ClearType appears correctly. + +- Do not introduce intermediate render targets between and the text to be rendered with ClearType. + +- Assign an opaque background that is as close as possible in the visual tree to the text. + +- Be aware that re-enables ClearType for a subtree; however, it does not force ClearType rendering. + +- Be aware that does not override your system settings or settings. + +> [!NOTE] +> The attached property does not affect the control; however, it does work with the control. + +> [!NOTE] +> On many controls, the attached property has no effect unless you set an opaque background behind the text. + + To access this property in code, use the and methods. + + + +## Examples + The following example shows how the property affects different branches of the visual tree. In the first text block control, text is rendered with ClearType because the text block inherits the setting from the main window. In the second text block, ClearType is not used because the parent element's property is set. In the third text block, is used, but rendering issues may occur. + + [!code-xml[ClearTypeHint#_ClearTypeHintXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/cleartypehint/CS/window1.xaml#_cleartypehintxaml)] + [!code-xml[ClearTypeHint#_ClearTypeHintXAML](~/samples/snippets/xaml/VS_Snippets_Wpf/cleartypehint/xaml/window1.xaml#_cleartypehintxaml)] + + ]]> + @@ -228,8 +386,27 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the enumeration value for a non-text primitive that determines how its edges are rendered. + + attached property to improve rendering performance by specifying that a visual object should be rendered with aliased edges. Text objects are always displayed with anti-aliasing, and are unaffected by setting the edge mode value. When you set the edge mode value of a visual object, all the descendant drawing primitives of the visual object are set to the same edge mode value. + + To access this property in code, use the and methods. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + + diff --git a/xml/System.Windows.Media/TextOptions.xml b/xml/System.Windows.Media/TextOptions.xml index de5bef2d8b1..eaf85ff534e 100644 --- a/xml/System.Windows.Media/TextOptions.xml +++ b/xml/System.Windows.Media/TextOptions.xml @@ -1,4 +1,4 @@ - + @@ -205,8 +205,10 @@ 4.0.0.0 - To be added. + Gets the for the element. This is an attached property. To be added. + + @@ -241,8 +243,10 @@ 4.0.0.0 - To be added. + Gets the for the element. This is an attached property. To be added. + + @@ -277,8 +281,17 @@ 4.0.0.0 - To be added. - To be added. + Sets the for the element. This is an attached property. + + + + + diff --git a/xml/System.Windows.Navigation/JournalEntry.xml b/xml/System.Windows.Navigation/JournalEntry.xml index 3574e74200c..3c502d4056e 100644 --- a/xml/System.Windows.Navigation/JournalEntry.xml +++ b/xml/System.Windows.Navigation/JournalEntry.xml @@ -1,4 +1,4 @@ - + @@ -209,8 +209,30 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that indicates whether the content of a journal entry is either retained or re-created when navigated to in navigation history. + + for how this property is used by pages. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + + +## Examples + The following example shows how to set the attached property for a . + + [!code-xml[JournalEntrySnippets#JEKeepAliveMARKUP](~/samples/snippets/csharp/VS_Snippets_Wpf/JournalEntrySnippets/CSharp/JEKeepAlivePage.xaml#jekeepalivemarkup)] + + ]]> + diff --git a/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml b/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml index bb87732e748..7b37e7811a7 100644 --- a/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml +++ b/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml @@ -1,4 +1,4 @@ - + @@ -220,8 +220,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets a value that specifies whether an entry is in back navigation history, forward navigation history, or is the current content of a navigator. + + object from a navigator (, ), call **RemoveBackEntry**: , , . + + To get all objects from a , enumerate the entries that are returned by and . + + To get all objects from a , enumerate the entries that are returned by and . + +## XAML Attribute Usage + Members of this class are either not typically used in [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)], or cannot be used in [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)]. + + ]]> + diff --git a/xml/System.Windows.Shell/WindowChrome.xml b/xml/System.Windows.Shell/WindowChrome.xml index 70e5bad3b4f..a016041e6ad 100644 --- a/xml/System.Windows.Shell/WindowChrome.xml +++ b/xml/System.Windows.Shell/WindowChrome.xml @@ -1,4 +1,4 @@ - + @@ -784,8 +784,22 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the instance of that is attached to a window. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + diff --git a/xml/System.Windows/DataObject.xml b/xml/System.Windows/DataObject.xml index aaa5ee7610b..3715ad10982 100644 --- a/xml/System.Windows/DataObject.xml +++ b/xml/System.Windows/DataObject.xml @@ -1,4 +1,4 @@ - + @@ -585,8 +585,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the associated dependency object has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a , and is ready to either place the on the or begin a drag-and-drop operation. + + prior to the copy operation, change, remove or add data formats, or cancel the entire copy operation by calling . + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + ]]> + @@ -1170,8 +1186,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the associated dependency object is ready to paste data. + + prior to the paste operation, change, remove or add data formats, or cancel the entire copy operation by calling . + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + ]]> + @@ -1724,8 +1756,24 @@ 4.0.0.0 - To be added. - To be added. + Occurs when the associated dependency object attempts to add a new data format to a . + + . + + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + ]]> + diff --git a/xml/System.Windows/DragDrop.xml b/xml/System.Windows/DragDrop.xml index ad4dc503d40..a70eabe45eb 100644 --- a/xml/System.Windows/DragDrop.xml +++ b/xml/System.Windows/DragDrop.xml @@ -1,4 +1,4 @@ - + @@ -571,8 +571,39 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an object is dragged into the bounds of an element that is acting as a drop target. + + property is `false`. + + Handling this event is optional for the drop target, and is not necessary for all drag-and-drop scenarios. You typically handle this event to provide a preview of the effects of the drag-and-drop operation, if appropriate for your application. Do not set the property in the event, as it will be overwritten in the event. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + + +## Examples + The following example shows the event handler for an element. This code previews the effects of the drag-and-drop operation by saving the current brush. It then checks to see if the being dragged over the ellipse contains string data that can be converted to a . If so, the is applied to the ellipse. The change is reverted in the event handler. If the data cannot be converted to a , no action is performed. + + [!code-csharp[DragDropSnippets#DragEnter](~/samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragenter)] + [!code-vb[DragDropSnippets#DragEnter](~/samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragenter)] + + ]]> + + + + + @@ -621,8 +652,39 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an object is dragged out of the bounds of an element that is acting as a drop target without being dropped. + + property is `false`. + + You typically handle this event to undo any changes that you made in the event handler. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + + +## Examples + The following example shows the event handler for an element. This code undoes the preview performed in the event handler by applying the saved to the ellipse. + + [!code-csharp[DragDropSnippets#DragLeave](~/samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragleave)] + [!code-vb[DragDropSnippets#DragLeave](~/samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragleave)] + + ]]> + + + + + @@ -671,8 +733,39 @@ 4.0.0.0 - To be added. - To be added. + Occurs continuously while an object is dragged within the bounds of an element that is acting as a drop target. + + property is `false`. + + The event is paired with the event on the drag source. In the event handler, you typically check that the transferred data is in a format that the drop target can process. You can also check whether any modifier keys are pressed, which typically indicates whether the user intends a move or a copy action. After these checks are performed, you set the property to notify the drag source what effect dropping the data will have. The drag source receives this information in the property of the event arguments, and can set an appropriate cursor to give feedback to the user. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + + +## Examples + The following example shows the event handler for an element. This code checks to see if the being dragged over the ellipse contains string data that can be converted to a . If so, it sets the property to . This indicates to the drag source that the data can be copied to the ellipse. If the data cannot be converted to a , the property is set to . This indicates to the drag source that the ellipse is not a valid drop target for the data. + + [!code-csharp[DragDropSnippets#DragOver](~/samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragover)] + [!code-vb[DragDropSnippets#DragOver](~/samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragover)] + + ]]> + + + + + @@ -721,8 +814,39 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an object is dropped within the bounds of an element that is acting as a drop target. + + event is raised once when an object is dropped within the bounds of an element that is acting as a drop target. This event is not raised if the element’s property is `false`. This event ends the drag-and-drop operation. + + In the event handler, you extract the transferred data from the and perform any processing of the data that your application requires. To notify the drag source of the effect of the drop, such as a copy or move, set the property in the event handler. The value of this property is the return value of the method that initiated the drag-and-drop operation. If the value that is returned does not match one of the `allowedEffects` specified in the call to , the drag-and-drop operation is not performed. The initial value of the property is the same as the `allowedEffects` specified in the call to the method. If you do not set the property, this initial value is returned and it is assumed that one the `allowedEffects` occurred. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + + +## Examples + The following example shows the event handler for an element. This code applies the effects of the drag-and-drop operation. It checks to see if the being dragged over the ellipse contains string data that can be converted to a . If so, the is applied to the ellipse. If the data cannot be converted to a , no action is performed. + + [!code-csharp[DragDropSnippets#Drop](~/samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#drop)] + [!code-vb[DragDropSnippets#Drop](~/samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#drop)] + + ]]> + + + + + @@ -771,8 +895,32 @@ 4.0.0.0 - To be added. - To be added. + Occurs continuously while a drag-and-drop operation is in progress, and enables the drag source to give feedback to the user. + + event is raised continuously while the drag source is being dragged. This event is paired with the event on the drop target. The default handler for this event checks whether the drag source is over a valid drop target. If it is, it checks the allowed effects of the drop target. It then gives feedback to the end user regarding the allowed drop effects. This is typically done by changing the mouse cursor to a no-drop, copy, or move cursor. You should only handle this event if you need to use custom cursors to provide feedback to the user. If you handle this event, you must mark it as handled to prevent the default behavior from overriding your handler. + +> [!CAUTION] +> This event is raised continuously during the drag-and-drop operation. Therefore, you should avoid resource-intensive tasks in the event handler. For example, use a cached cursor instead of creating a new cursor each time the event is raised. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + ]]> + + + + + @@ -821,8 +969,31 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an object is dragged into the bounds of an element that is acting as a drop target. + + property is `false`. + + For more information, see the event. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + The corresponding bubbling event is . + + ]]> + + + + + @@ -871,8 +1042,31 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an object is dragged out of the bounds of an element that is acting as a drop target without being dropped. + + property is `false`. + + For more information, see the event. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + The corresponding bubbling event is . + + ]]> + + + + + @@ -921,8 +1115,31 @@ 4.0.0.0 - To be added. - To be added. + Occurs continuously while an object is dragged within the bounds of an element that is acting as a drop target. + + property is `false`. + + For more information, see the event. + +## Routed Event Information + +||| +|-|-| +|Identifier field|| +|Routing strategy|Tunneling| +|Delegate|| + + The corresponding bubbling event is . + + ]]> + + + + + @@ -971,8 +1188,31 @@ 4.0.0.0 - To be added. - To be added. + Occurs when an object is dropped within the bounds of an element that is acting as a drop target. + + property is `false`. This event ends the drag-and-drop operation. + + For more information, see the event. + +## Routed Event Information + +||| +|-|-| +|Identifier Field|| +|Routing Strategy|Tunneling| +|Delegate|| + + The corresponding bubbling event is . + + ]]> + + + + + @@ -1021,8 +1261,29 @@ 4.0.0.0 - To be added. - To be added. + Occurs continuously while a drag-and-drop operation is in progress, and enables the drag source to give feedback to the user. + + event. + +## Routed Event Information + +||| +|-|-| +|Identifier Field|| +|Routing Strategy|Tunneling| +|Delegate|| + + The corresponding bubbling event is . + + ]]> + + + + + @@ -1071,8 +1332,29 @@ 4.0.0.0 - To be added. - To be added. + Occurs continuously while a drag-and-drop operation is in progress, and enables the drop source to end the drag-and-drop operation depending on the key/button states. + + event. + +## Routed Event Information + +||| +|-|-| +|Identifier Field|| +|Routing Strategy|Tunneling| +|Delegate|| + + The corresponding bubbling event is . + + ]]> + + + + + @@ -1121,8 +1403,29 @@ 4.0.0.0 - To be added. - To be added. + Occurs continuously while a drag-and-drop operation is in progress, and enables the drop source to end the drag-and-drop operation depending on the key/button states. + + event is raised continuously while the drag source is being dragged. You can handle this event to determine what action ends the drag-and-drop operation based on the state of the ESC, SHIFT, CTRL, and ALT keys, as well as the state of the mouse buttons. The default handler for this event cancels the drag-and-drop operation if the ESC key is pressed, and drops the data if the mouse button is released. If you handle this event to change the default behavior, be sure to provide an equivalent mechanism in your handler to end the drag-and-drop operation. Otherwise, the method will not return and your application will stop responding. If you handle this event, you must mark it as handled to prevent the default behavior from overriding your handler. + +## Routed Event Information + +||| +|-|-| +|Identifier Field|| +|Routing Strategy|Bubbling| +|Delegate|| + + The corresponding tunneling event is . + + ]]> + + + + + diff --git a/xml/System.Windows/NameScope.xml b/xml/System.Windows/NameScope.xml index 930adac4cd7..8045dbd09f1 100644 --- a/xml/System.Windows/NameScope.xml +++ b/xml/System.Windows/NameScope.xml @@ -1,4 +1,4 @@ - + @@ -488,8 +488,24 @@ 3.0.0.0 - To be added. - To be added. + Gets or sets dynamically attached instances. + + and accessors in code. Setting the namescope in XAML is not common. The attached property usage is primarily to facilitate attaching XAML namescopes to objects that do not share inheritance for XAML namescope implementations. and derived classes support this inheritance natively. + + +## Dependency Property Information + +||| +|-|-| +|Identifier field|| +|Metadata properties set to `true`|None| + + ]]> + + diff --git a/xml/System.Windows/VisualStateManager.xml b/xml/System.Windows/VisualStateManager.xml index 819f1402b51..6f7da0bcb00 100644 --- a/xml/System.Windows/VisualStateManager.xml +++ b/xml/System.Windows/VisualStateManager.xml @@ -1,4 +1,4 @@ - + @@ -72,8 +72,15 @@ 4.0.0.0 - To be added. - To be added. + Gets or sets the object that transitions between the states of a control. + + is `null`, the uses its own logic to transition between states. If you want to implement your own logic for transitioning between states, create a class that inherits from and override the method. To use the custom class, set the property to an object of your custom type. + + ]]> + From f279c7c9eebdcde122d732462302872fa1fb5f15 Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Mon, 30 Jul 2018 23:40:54 -0700 Subject: [PATCH 2/6] small fixes --- includes/crdefault-md.md | 1 - .../ProtectedConfigurationProvider.xml | 2 +- xml/System.ServiceModel/ClientBase`1.xml | 10 +++---- .../SiteMapDataSourceDesigner.xml | 8 ++--- .../XmlDataSourceDesigner.xml | 8 ++--- xml/System.Web.UI.WebControls/ImageButton.xml | 2 +- xml/System.Web.UI.WebControls/ListView.xml | 2 +- .../SiteMapDataSource.xml | 10 +++---- .../AutomationProperties.xml | 30 +++++++++---------- .../Selector.xml | 4 +-- .../RibbonControlService.xml | 20 ++++++------- xml/System.Windows.Controls/Canvas.xml | 10 +++---- .../ContextMenuService.xml | 2 +- xml/System.Windows.Controls/ItemsControl.xml | 8 ++--- .../ToolTipService.xml | 16 +++++----- xml/System.Windows.Controls/Validation.xml | 26 ++++++++-------- .../VirtualizingPanel.xml | 4 +-- xml/System.Windows.Input/FocusManager.xml | 2 +- xml/System.Windows.Media/RenderOptions.xml | 2 +- .../JournalEntryUnifiedViewConverter.xml | 6 ++-- xml/System.Windows/DragDrop.xml | 8 ++--- 21 files changed, 90 insertions(+), 91 deletions(-) delete mode 100644 includes/crdefault-md.md diff --git a/includes/crdefault-md.md b/includes/crdefault-md.md deleted file mode 100644 index 91e09afbc37..00000000000 --- a/includes/crdefault-md.md +++ /dev/null @@ -1 +0,0 @@ -For more information, see \ No newline at end of file diff --git a/xml/System.Configuration/ProtectedConfigurationProvider.xml b/xml/System.Configuration/ProtectedConfigurationProvider.xml index 39fea011b71..100252df824 100644 --- a/xml/System.Configuration/ProtectedConfigurationProvider.xml +++ b/xml/System.Configuration/ProtectedConfigurationProvider.xml @@ -158,7 +158,7 @@ providerName="System.Data.SqlClient" /> Override this method to perform custom decryption. - Encrypting and Decrypting Configuration Sections + Encrypting and Decrypting Configuration Sections diff --git a/xml/System.ServiceModel/ClientBase`1.xml b/xml/System.ServiceModel/ClientBase`1.xml index 0175fd71452..600dab2b83d 100644 --- a/xml/System.ServiceModel/ClientBase`1.xml +++ b/xml/System.ServiceModel/ClientBase`1.xml @@ -1360,7 +1360,7 @@ . +For more information, see . ]]> @@ -1396,7 +1396,7 @@ . +For more information, see . ]]> @@ -1514,7 +1514,7 @@ . +For more information, see . ]]> @@ -1616,7 +1616,7 @@ . +For more information, see . ]]> @@ -1652,7 +1652,7 @@ . +For more information, see . ]]> diff --git a/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml b/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml index e944d08f114..03945290043 100644 --- a/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml +++ b/xml/System.Web.UI.Design.WebControls/SiteMapDataSourceDesigner.xml @@ -339,8 +339,8 @@ ]]> - Extending Design-Time Support - ASP.NET Site Maps + Extending Design-Time Support + ASP.NET Site Maps @@ -506,8 +506,8 @@ ]]> - ASP.NET Site Maps - Extending Design-Time Support + ASP.NET Site Maps + Extending Design-Time Support diff --git a/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml b/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml index 4445f99ad11..7465709703e 100644 --- a/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml +++ b/xml/System.Web.UI.Design.WebControls/XmlDataSourceDesigner.xml @@ -434,8 +434,8 @@ ]]> - Extending Design-Time Support - How to: Extend the Appearance and Behavior of Controls in Design Mode + Extending Design-Time Support + How to: Extend the Appearance and Behavior of Controls in Design Mode @@ -602,8 +602,8 @@ ]]> - Extending Design-Time Support - How to: Extend the Appearance and Behavior of Controls in Design Mode + Extending Design-Time Support + How to: Extend the Appearance and Behavior of Controls in Design Mode diff --git a/xml/System.Web.UI.WebControls/ImageButton.xml b/xml/System.Web.UI.WebControls/ImageButton.xml index bc081fa7771..ad667799b7d 100644 --- a/xml/System.Web.UI.WebControls/ImageButton.xml +++ b/xml/System.Web.UI.WebControls/ImageButton.xml @@ -1201,7 +1201,7 @@ End Sub ]]> - Button Web Server Controls Overview + Button Web Server Controls Overview diff --git a/xml/System.Web.UI.WebControls/ListView.xml b/xml/System.Web.UI.WebControls/ListView.xml index 56d343633d5..b061d68f29e 100644 --- a/xml/System.Web.UI.WebControls/ListView.xml +++ b/xml/System.Web.UI.WebControls/ListView.xml @@ -6314,7 +6314,7 @@ For a description of this member, see . To be added. - ListView Web Server Control + ListView Web Server Control diff --git a/xml/System.Web.UI.WebControls/SiteMapDataSource.xml b/xml/System.Web.UI.WebControls/SiteMapDataSource.xml index 0a1fe807ca5..d06f7502061 100644 --- a/xml/System.Web.UI.WebControls/SiteMapDataSource.xml +++ b/xml/System.Web.UI.WebControls/SiteMapDataSource.xml @@ -708,11 +708,11 @@ ]]> - ASP.NET Site Navigation - SiteMapPath Web Server Control - Securing ASP.NET Site Navigation - ASP.NET Data Access Overview - SiteMapDataSource Web Server Control Overview + ASP.NET Site Navigation + SiteMapPath Web Server Control + Securing ASP.NET Site Navigation + ASP.NET Data Access Overview + SiteMapDataSource Web Server Control Overview diff --git a/xml/System.Windows.Automation/AutomationProperties.xml b/xml/System.Windows.Automation/AutomationProperties.xml index e931e5d34ea..e54e0b2a300 100644 --- a/xml/System.Windows.Automation/AutomationProperties.xml +++ b/xml/System.Windows.Automation/AutomationProperties.xml @@ -48,7 +48,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -101,7 +101,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -154,7 +154,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -555,8 +555,8 @@ ]]> - UI Automation Support for the ToolTip Control Type - UI Automation Properties Overview + UI Automation Support for the ToolTip Control Type + UI Automation Properties Overview @@ -609,9 +609,9 @@ ]]> - Expose the Content of a Table Using UI Automation - Implementing the UI Automation Table Control Pattern - UI Automation Properties Overview + Expose the Content of a Table Using UI Automation + Implementing the UI Automation Table Control Pattern + UI Automation Properties Overview @@ -714,7 +714,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -768,7 +768,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -822,7 +822,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -877,7 +877,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview @@ -930,8 +930,8 @@ ]]> - UI Automation Properties Overview - UI Automation Support for the Edit Control Type + UI Automation Properties Overview + UI Automation Support for the Edit Control Type @@ -1021,7 +1021,7 @@ ]]> - UI Automation Properties Overview + UI Automation Properties Overview diff --git a/xml/System.Windows.Controls.Primitives/Selector.xml b/xml/System.Windows.Controls.Primitives/Selector.xml index 4a918dda0c8..40c05f8ba13 100644 --- a/xml/System.Windows.Controls.Primitives/Selector.xml +++ b/xml/System.Windows.Controls.Primitives/Selector.xml @@ -220,7 +220,7 @@ ## Remarks Use the attached property to select an item in the when you do not explicitly create the item container. An item container is a class that represents an item in the . , , and are item containers for the controls that inherit from , and each defines an **IsSelected** property. - If you do not explicitly create an item container, [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] implicitly creates one and sets the **IsSelected** property on the item container to the value of . This is the only time is read. is not updated if the selection on the item changes. + If you do not explicitly create an item container, [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] implicitly creates one and sets the **IsSelected** property on the item container to the value of . This is the only time is read. is not updated if the selection on the item changes. If you explicitly create an item container, you should use the **IsSelected** property on that class. @@ -235,7 +235,7 @@ ## Examples - The follow example creates a that contains two controls. The example does not explicitly create a for either , so it sets directly on each . To illustrate that is not updated, the example binds the property of the first checkbox to . When the user unselects the item in the , the remains checked. Likewise, checking or unchecking the does not affect whether the is selected in the . The example binds of the second to . In this case, unselecting the item in the causes the checkbox to be unchecked, and unchecking the checkbox also unselects the item. + The follow example creates a that contains two controls. The example does not explicitly create a for either , so it sets directly on each . To illustrate that is not updated, the example binds the property of the first checkbox to . When the user unselects the item in the , the remains checked. Likewise, checking or unchecking the does not affect whether the is selected in the . The example binds of the second to . In this case, unselecting the item in the causes the checkbox to be unchecked, and unchecking the checkbox also unselects the item. [!code-xml[Selector#1](~/samples/snippets/csharp/VS_Snippets_Wpf/Selector/CS/Window1.xaml#1)] [!code-xml[Selector#1](~/samples/snippets/xaml/VS_Snippets_Wpf/Selector/XAML/Window1.xaml#1)] diff --git a/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml b/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml index 4d541307b93..0b1854ac56a 100644 --- a/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml +++ b/xml/System.Windows.Controls.Ribbon/RibbonControlService.xml @@ -223,7 +223,7 @@ ]]> - Ribbon Layout and Resizing + Ribbon Layout and Resizing @@ -325,7 +325,7 @@ ]]> - Ribbon Layout and Resizing + Ribbon Layout and Resizing @@ -1305,7 +1305,7 @@ ]]> - Ribbon Layout and Resizing + Ribbon Layout and Resizing @@ -2345,7 +2345,7 @@ ]]> - Ribbon Layout and Resizing + Ribbon Layout and Resizing @@ -2387,7 +2387,7 @@ ## Remarks > [!WARNING] -> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. ## Dependency Property Information @@ -2441,7 +2441,7 @@ ## Remarks > [!WARNING] -> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. ## Dependency Property Information @@ -2495,7 +2495,7 @@ ## Remarks > [!WARNING] -> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. ## Dependency Property Information @@ -2549,7 +2549,7 @@ ## Remarks > [!WARNING] -> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. ## Dependency Property Information @@ -2603,7 +2603,7 @@ ## Remarks > [!WARNING] -> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. ## Dependency Property Information @@ -2657,7 +2657,7 @@ ## Remarks > [!WARNING] -> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. +> Each ribbon control inherits a property. If the property is set, the ribbon’s enhanced ToolTip will not be shown; the standard ToolTip will be shown instead. ## Dependency Property Information diff --git a/xml/System.Windows.Controls/Canvas.xml b/xml/System.Windows.Controls/Canvas.xml index ee7d3c9ace1..4becddee7d5 100644 --- a/xml/System.Windows.Controls/Canvas.xml +++ b/xml/System.Windows.Controls/Canvas.xml @@ -112,7 +112,7 @@ ## Remarks The offset of a child element does not affect the size of a parent . - If you specify them, the attached properties or take priority over the or properties. + If you specify them, the attached properties or take priority over the or properties. ## Dependency Property Information @@ -337,7 +337,7 @@ ## Remarks The offset of a child element does not affect the size of a parent . - If you specify them, the attached properties or take priority over or properties. + If you specify them, the attached properties or take priority over or properties. ## Dependency Property Information @@ -420,9 +420,9 @@ offset of a child element does not affect the size of a parent . + The offset of a child element does not affect the size of a parent . - If you specify them, the attached properties or take priority over or properties. + If you specify them, the attached properties or take priority over or properties. ## Dependency Property Information @@ -592,7 +592,7 @@ ## Remarks The offset of a child element does not affect the size of a parent . - If you specify them, the attached properties or take priority over or . + If you specify them, the attached properties or take priority over or . ## Dependency Property Information diff --git a/xml/System.Windows.Controls/ContextMenuService.xml b/xml/System.Windows.Controls/ContextMenuService.xml index d735f466faf..f235f79f8a0 100644 --- a/xml/System.Windows.Controls/ContextMenuService.xml +++ b/xml/System.Windows.Controls/ContextMenuService.xml @@ -534,7 +534,7 @@ opens, the value is set to the value of . Setting this property to `true` has no effect if the property is `false`. + When the opens, the value is set to the value of . Setting this property to `true` has no effect if the property is `false`. ## Dependency Property Information diff --git a/xml/System.Windows.Controls/ItemsControl.xml b/xml/System.Windows.Controls/ItemsControl.xml index dbe47f99cb6..01391dd8673 100644 --- a/xml/System.Windows.Controls/ItemsControl.xml +++ b/xml/System.Windows.Controls/ItemsControl.xml @@ -299,9 +299,9 @@ ListBox that contains multiple types of objects and properties enable you to specify the appearance for two or more alternating item containers. For example, you can specify alternating background colors for every third item in an . The is assigned to each item container in the . begins at 0, increments until it is minus 1, and then restarts at 0. For example, if is 3 and there are seven items in the , the following table lists the for each item. + The and properties enable you to specify the appearance for two or more alternating item containers. For example, you can specify alternating background colors for every third item in an . The is assigned to each item container in the . begins at 0, increments until it is minus 1, and then restarts at 0. For example, if is 3 and there are seven items in the , the following table lists the for each item. -|Position of Item in the || +|Position of Item in the || |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| |1|0| |2|1| @@ -311,12 +311,12 @@ ListBox that contains multiple types of objects |6|2| |7|0| - There are several methods you can use to specify different appearances for the alternating item containers. One method is to bind properties of the items container to the . You can then use an to specify which value should be applied to the item container that has a certain value. You can also use triggers to change the value of an item container's property depending on the value of its . + There are several methods you can use to specify different appearances for the alternating item containers. One method is to bind properties of the items container to the . You can then use an to specify which value should be applied to the item container that has a certain value. You can also use triggers to change the value of an item container's property depending on the value of its . ## Examples - The following example specifies that the (which inherits from ) has alternating item containers (which are of type ) and specifies a different background and foreground for each one. The example binds the and properties to the and provides an for each property. + The following example specifies that the (which inherits from ) has alternating item containers (which are of type ) and specifies a different background and foreground for each one. The example binds the and properties to the and provides an for each property. [!code-xml[AlternationIndexSnippets#2](~/samples/snippets/csharp/VS_Snippets_Wpf/AlternationIndexSnippets/CS/Window1.xaml#2)] diff --git a/xml/System.Windows.Controls/ToolTipService.xml b/xml/System.Windows.Controls/ToolTipService.xml index cb4a3ae4e24..9aff8c47080 100644 --- a/xml/System.Windows.Controls/ToolTipService.xml +++ b/xml/System.Windows.Controls/ToolTipService.xml @@ -747,7 +747,7 @@ ## Remarks The default style for a tooltip control adds a drop shadow effect. If you do not explicitly set the property, the property value is `false` until the first time the tooltip is displayed. The default tooltip style is applied when a tooltip is displayed and the style sets the property to `true`. - If the tooltip is a object and both the property and the property are specified, the value of the property is used. + If the tooltip is a object and both the property and the property are specified, the value of the property is used. For information about how to get or set this property in code, see the and methods. @@ -814,7 +814,7 @@ ## Remarks The property and the property values provide additional adjustment to the position of a tooltip that is defined by the property and the property values. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). ## XAML Attribute Usage @@ -830,7 +830,7 @@ `double` - A string representation of a value that is equal to or greater than 0.0 but that is smaller than . This is interpreted as a device-independent unit (1/96th of an inch per unit) measurement. Strings do not have to explicitly include decimal points. + A string representation of a value that is equal to or greater than 0.0 but that is smaller than . This is interpreted as a device-independent unit (1/96th of an inch per unit) measurement. Strings do not have to explicitly include decimal points. `qualifiedDouble` A value that is followed by one of these unit declaration strings: `px`, `in`, `cm`, `pt`. @@ -1072,7 +1072,7 @@ ## Remarks This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). ## Dependency Property Information @@ -1133,7 +1133,7 @@ This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). ## Dependency Property Information @@ -1194,7 +1194,7 @@ This property is an attached property. For information about how to get or set this property in code, see the and methods. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). ## Dependency Property Information @@ -2117,7 +2117,7 @@ and methods. behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). ## XAML Attribute Usage @@ -2133,7 +2133,7 @@ `double` - The string representation of a value that is equal to or greater than 0.0 but smaller than . This is interpreted as a device-independent unit (1/96th inch) measurement. Strings do not have to explicitly include decimal points. + The string representation of a value that is equal to or greater than 0.0 but smaller than . This is interpreted as a device-independent unit (1/96th inch) measurement. Strings do not have to explicitly include decimal points. `qualifiedDouble` A value that is followed by one of these unit declaration strings: `px`, `in`, `cm`, `pt`. diff --git a/xml/System.Windows.Controls/Validation.xml b/xml/System.Windows.Controls/Validation.xml index c00b6e7fcbb..f2107bc10a0 100644 --- a/xml/System.Windows.Controls/Validation.xml +++ b/xml/System.Windows.Controls/Validation.xml @@ -108,15 +108,15 @@ ## Remarks The [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] data binding model enables you to associate with your object. Validation occurs during binding target-to-binding source value transfer before the converter is called. The following describes the validation process: -1. When a value is being transferred from the target property to the source property, the data binding engine first removes any that may have been added to the attached property of the bound element. It then checks if there are any custom s defined for that , in which case it calls the method on each of the s until one of them runs into an error or until all of them pass. +1. When a value is being transferred from the target property to the source property, the data binding engine first removes any that may have been added to the attached property of the bound element. It then checks if there are any custom s defined for that , in which case it calls the method on each of the s until one of them runs into an error or until all of them pass. -2. Once there is a custom rule that does not pass, the binding engine creates a object and adds it to the collection of the bound element. When is not empty, the attached property of the element is set to `true`. Also, if the property of the is set to `true`, then the binding engine raises the attached event on the element. +2. Once there is a custom rule that does not pass, the binding engine creates a object and adds it to the collection of the bound element. When is not empty, the attached property of the element is set to `true`. Also, if the property of the is set to `true`, then the binding engine raises the attached event on the element. 3. If all of the rules pass, the binding engine then calls the converter, if one exists. 4. If the converter passes, the binding engine calls the setter of the source property. -5. If the binding has an associated with it and an exception is thrown during step 4, the binding engine checks to see if there is a . You have the option to use the callback to provide a custom handler for handling exceptions. If an is not specified on the , the binding engine creates a with the exception and adds it to the collection of the bound element. +5. If the binding has an associated with it and an exception is thrown during step 4, the binding engine checks to see if there is a . You have the option to use the callback to provide a custom handler for handling exceptions. If an is not specified on the , the binding engine creates a with the exception and adds it to the collection of the bound element. Also note that a valid value transfer in either direction (target-to-source or source-to-target) clears the .attached property. @@ -563,13 +563,13 @@ and attached properties reference each other, and you can set either one. For example, suppose that a displays validation errors that occur on a data-bound . You can do one of the following to establish that relationship: + The and attached properties reference each other, and you can set either one. For example, suppose that a displays validation errors that occur on a data-bound . You can do one of the following to establish that relationship: -- Set for the to the . +- Set for the to the . -- Set for the to the . +- Set for the to the . -- When you set one of the properties, the other property is set to the element on which you set the attached property; regardless of which of the previous options you choose, the for the is the and the for the is the . +- When you set one of the properties, the other property is set to the element on which you set the attached property; regardless of which of the previous options you choose, the for the is the and the for the is the . ## Dependency Property Information @@ -582,7 +582,7 @@ ## Examples - The following example uses a as the adorner site for the validation errors that occur on items in an . The example sets the for each item container in the to the label. The example uses the property to get the item container that has the error and binds the of the to the first that is reported. + The following example uses a as the adorner site for the validation errors that occur on items in an . The example sets the for each item container in the to the label. The example uses the property to get the item container that has the error and binds the of the to the first that is reported. [!code-xml[BindingGroupSnippets#ItemBindingGroup](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#itembindinggroup)] [!code-xml[BindingGroupSnippets#ValidationAdornerSiteFor](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#validationadornersitefor)] @@ -609,13 +609,13 @@ and attached properties reference each other, and you can set either one. For example, suppose that a displays validation errors that occur on a data bound . You can do one of the following to establish that relationship: + The and attached properties reference each other, and you can set either one. For example, suppose that a displays validation errors that occur on a data bound . You can do one of the following to establish that relationship: -- Set for the to the . +- Set for the to the . -- Set for the to the . +- Set for the to the . - When you set one of the properties, the other property is set to the element on which you set the attached property; regardless of which of the previous options you choose, the for the is the and the for the is the . + When you set one of the properties, the other property is set to the element on which you set the attached property; regardless of which of the previous options you choose, the for the is the and the for the is the . ## Dependency Property Information @@ -628,7 +628,7 @@ ## Examples - The following example uses a as the adorner site for the validation errors that occur on items in an . The example sets the for each item container in the to the label. The example uses the property to get the item container that has the error and binds the of the to the first that is reported. + The following example uses a as the adorner site for the validation errors that occur on items in an . The example sets the for each item container in the to the label. The example uses the property to get the item container that has the error and binds the of the to the first that is reported. [!code-xml[BindingGroupSnippets#ItemBindingGroup](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#itembindinggroup)] [!code-xml[BindingGroupSnippets#ValidationAdornerSiteFor](~/samples/snippets/csharp/VS_Snippets_Wpf/BindingGroupSnippets/CSharp/Window2.xaml#validationadornersitefor)] diff --git a/xml/System.Windows.Controls/VirtualizingPanel.xml b/xml/System.Windows.Controls/VirtualizingPanel.xml index 8b341462994..7b6ef342d46 100644 --- a/xml/System.Windows.Controls/VirtualizingPanel.xml +++ b/xml/System.Windows.Controls/VirtualizingPanel.xml @@ -1147,12 +1147,12 @@ creates an item container for each visible item and discards it when it is no longer needed (such as when the item is scrolled out of view). When an contains a lot of items, the process of creating and discarding item containers can negatively affect performance. When is set to , the reuses item containers instead of creating a new one each time. + By default, a creates an item container for each visible item and discards it when it is no longer needed (such as when the item is scrolled out of view). When an contains a lot of items, the process of creating and discarding item containers can negatively affect performance. When is set to , the reuses item containers instead of creating a new one each time. ## Examples - The following example creates a and sets the attached property to . + The following example creates a and sets the attached property to . [!code-xml[RecycleItemContainerShippets#VirtualizationMode](~/samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml#virtualizationmode)] diff --git a/xml/System.Windows.Input/FocusManager.xml b/xml/System.Windows.Input/FocusManager.xml index bbdd4ccb6b7..04cbc531a27 100644 --- a/xml/System.Windows.Input/FocusManager.xml +++ b/xml/System.Windows.Input/FocusManager.xml @@ -336,7 +336,7 @@ within its scope. By default, the class is a focus scope as are the , , and classes. An element which is a focus scope has set to `true`. + A focus scope is a container element that keeps track of the within its scope. By default, the class is a focus scope as are the , , and classes. An element which is a focus scope has set to `true`. For more information on focus, keyboard focus, and logical focus, see the [Input Overview](../Topic/Input%20Overview.md). diff --git a/xml/System.Windows.Media/RenderOptions.xml b/xml/System.Windows.Media/RenderOptions.xml index 7ddb90cc4e3..fcd3ab6ce00 100644 --- a/xml/System.Windows.Media/RenderOptions.xml +++ b/xml/System.Windows.Media/RenderOptions.xml @@ -47,7 +47,7 @@ ## Remarks Use the property on a or descendant that is animating a bitmap. - When animating the scale of any bitmap, the default high-quality image re-sampling algorithm can sometimes consume sufficient system resources to cause frame rate degradation, effectively causing animations to stutter. By setting the property to , you can create a smoother animation when scaling a bitmap. + When animating the scale of any bitmap, the default high-quality image re-sampling algorithm can sometimes consume sufficient system resources to cause frame rate degradation, effectively causing animations to stutter. By setting the property to , you can create a smoother animation when scaling a bitmap. To access this property in code, use the and methods. diff --git a/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml b/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml index 7b37e7811a7..4d5d0ca8864 100644 --- a/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml +++ b/xml/System.Windows.Navigation/JournalEntryUnifiedViewConverter.xml @@ -225,11 +225,11 @@ object from a navigator (, ), call **RemoveBackEntry**: , , . + To get a single object from a navigator (, ), call **RemoveBackEntry**: , , . - To get all objects from a , enumerate the entries that are returned by and . + To get all objects from a , enumerate the entries that are returned by and . - To get all objects from a , enumerate the entries that are returned by and . + To get all objects from a , enumerate the entries that are returned by and . ## XAML Attribute Usage Members of this class are either not typically used in [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)], or cannot be used in [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)]. diff --git a/xml/System.Windows/DragDrop.xml b/xml/System.Windows/DragDrop.xml index a70eabe45eb..e1697eb41ce 100644 --- a/xml/System.Windows/DragDrop.xml +++ b/xml/System.Windows/DragDrop.xml @@ -578,7 +578,7 @@ ## Remarks This event is raised once each time an object is dragged into the bounds of an element that is acting as a drop target. This event is not raised if the element’s property is `false`. - Handling this event is optional for the drop target, and is not necessary for all drag-and-drop scenarios. You typically handle this event to provide a preview of the effects of the drag-and-drop operation, if appropriate for your application. Do not set the property in the event, as it will be overwritten in the event. + Handling this event is optional for the drop target, and is not necessary for all drag-and-drop scenarios. You typically handle this event to provide a preview of the effects of the drag-and-drop operation, if appropriate for your application. Do not set the property in the event, as it will be overwritten in the event. ## Routed Event Information @@ -740,7 +740,7 @@ ## Remarks This event is raised continuously while a dragged object is within the bounds of an element that is acting as a drop target. This event is not raised if the element’s property is `false`. - The event is paired with the event on the drag source. In the event handler, you typically check that the transferred data is in a format that the drop target can process. You can also check whether any modifier keys are pressed, which typically indicates whether the user intends a move or a copy action. After these checks are performed, you set the property to notify the drag source what effect dropping the data will have. The drag source receives this information in the property of the event arguments, and can set an appropriate cursor to give feedback to the user. + The event is paired with the event on the drag source. In the event handler, you typically check that the transferred data is in a format that the drop target can process. You can also check whether any modifier keys are pressed, which typically indicates whether the user intends a move or a copy action. After these checks are performed, you set the property to notify the drag source what effect dropping the data will have. The drag source receives this information in the property of the event arguments, and can set an appropriate cursor to give feedback to the user. ## Routed Event Information @@ -755,7 +755,7 @@ ## Examples - The following example shows the event handler for an element. This code checks to see if the being dragged over the ellipse contains string data that can be converted to a . If so, it sets the property to . This indicates to the drag source that the data can be copied to the ellipse. If the data cannot be converted to a , the property is set to . This indicates to the drag source that the ellipse is not a valid drop target for the data. + The following example shows the event handler for an element. This code checks to see if the being dragged over the ellipse contains string data that can be converted to a . If so, it sets the property to . This indicates to the drag source that the data can be copied to the ellipse. If the data cannot be converted to a , the property is set to . This indicates to the drag source that the ellipse is not a valid drop target for the data. [!code-csharp[DragDropSnippets#DragOver](~/samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragover)] [!code-vb[DragDropSnippets#DragOver](~/samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragover)] @@ -821,7 +821,7 @@ ## Remarks The event is raised once when an object is dropped within the bounds of an element that is acting as a drop target. This event is not raised if the element’s property is `false`. This event ends the drag-and-drop operation. - In the event handler, you extract the transferred data from the and perform any processing of the data that your application requires. To notify the drag source of the effect of the drop, such as a copy or move, set the property in the event handler. The value of this property is the return value of the method that initiated the drag-and-drop operation. If the value that is returned does not match one of the `allowedEffects` specified in the call to , the drag-and-drop operation is not performed. The initial value of the property is the same as the `allowedEffects` specified in the call to the method. If you do not set the property, this initial value is returned and it is assumed that one the `allowedEffects` occurred. + In the event handler, you extract the transferred data from the and perform any processing of the data that your application requires. To notify the drag source of the effect of the drop, such as a copy or move, set the property in the event handler. The value of this property is the return value of the method that initiated the drag-and-drop operation. If the value that is returned does not match one of the `allowedEffects` specified in the call to , the drag-and-drop operation is not performed. The initial value of the property is the same as the `allowedEffects` specified in the call to the method. If you do not set the property, this initial value is returned and it is assumed that one the `allowedEffects` occurred. ## Routed Event Information From 5ce8e39d307f90913d4278d29e647336aaa190fc Mon Sep 17 00:00:00 2001 From: Ron Petrusha Date: Tue, 31 Jul 2018 11:08:11 -0700 Subject: [PATCH 3/6] Replaced external code reference with inline XAML --- .../Selector.xml | 24 +++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/xml/System.Windows.Controls.Primitives/Selector.xml b/xml/System.Windows.Controls.Primitives/Selector.xml index 40c05f8ba13..5bb98d82dc5 100644 --- a/xml/System.Windows.Controls.Primitives/Selector.xml +++ b/xml/System.Windows.Controls.Primitives/Selector.xml @@ -237,9 +237,25 @@ ## Examples The follow example creates a that contains two controls. The example does not explicitly create a for either , so it sets directly on each . To illustrate that is not updated, the example binds the property of the first checkbox to . When the user unselects the item in the , the remains checked. Likewise, checking or unchecking the does not affect whether the is selected in the . The example binds of the second to . In this case, unselecting the item in the causes the checkbox to be unchecked, and unchecking the checkbox also unselects the item. - [!code-xml[Selector#1](~/samples/snippets/csharp/VS_Snippets_Wpf/Selector/CS/Window1.xaml#1)] - [!code-xml[Selector#1](~/samples/snippets/xaml/VS_Snippets_Wpf/Selector/XAML/Window1.xaml#1)] - +```xaml + + + CheckBox.IsChecked is bound to Selector.IsChecked, which is set only + once. + + + + CheckBox.IsChecked is bound to ListBoxItem.IsChecked, which is + updated throughout the duration of the application. + + +``` + ]]> @@ -1136,4 +1152,4 @@ - \ No newline at end of file + From 044f31e0b61f92a366601f9c61e3c4e197dd4f2c Mon Sep 17 00:00:00 2001 From: Ron Petrusha Date: Tue, 31 Jul 2018 11:32:47 -0700 Subject: [PATCH 4/6] Update Stylus.xml --- xml/System.Windows.Input/Stylus.xml | 34 +++++++++++++++-------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/xml/System.Windows.Input/Stylus.xml b/xml/System.Windows.Input/Stylus.xml index e9e6a57420e..68b921402f0 100644 --- a/xml/System.Windows.Input/Stylus.xml +++ b/xml/System.Windows.Input/Stylus.xml @@ -1090,10 +1090,10 @@ ## Examples The following example demonstrates how to disable flicks on a . - - [!code-xml[StylusXAML#1](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window1.xaml#1)] - [!code-xml[StylusXAML#1](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window1.xaml#1)] - + +```xaml + +``` ]]> @@ -1151,10 +1151,10 @@ ## Examples The following example demonstrates how to enable press and hold on a . - - [!code-xml[StylusXAML#3](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window1.xaml#3)] - [!code-xml[StylusXAML#3](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window1.xaml#3)] - + +```xaml + +``` ]]> @@ -1212,9 +1212,10 @@ ## Examples The following example disables tap feedback on a . - - [!code-xml[StylusXAML#2](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window2.xaml#2)] - [!code-xml[StylusXAML#2](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window2.xaml#2)] + +```xaml + +``` ]]> @@ -1273,10 +1274,11 @@ ## Examples The following example enables touch feedback on an . - - [!code-xml[StylusXAML#4](~/samples/snippets/csharp/VS_Snippets_Wpf/StylusXAML/CS/Window1.xaml#4)] - [!code-xml[StylusXAML#4](~/samples/snippets/xaml/VS_Snippets_Wpf/StylusXAML/XAML/Window1.xaml#4)] - + +```xaml + +``` + ]]> @@ -3426,4 +3428,4 @@ - \ No newline at end of file + From 1f5200b56f9e80686eb8b74f0efd34cc26973776 Mon Sep 17 00:00:00 2001 From: Ron Petrusha Date: Tue, 31 Jul 2018 11:39:09 -0700 Subject: [PATCH 5/6] Update RenderOptions.xml --- xml/System.Windows.Media/RenderOptions.xml | 32 +++++++++++++++++++--- 1 file changed, 28 insertions(+), 4 deletions(-) diff --git a/xml/System.Windows.Media/RenderOptions.xml b/xml/System.Windows.Media/RenderOptions.xml index fcd3ab6ce00..239d22ac7b2 100644 --- a/xml/System.Windows.Media/RenderOptions.xml +++ b/xml/System.Windows.Media/RenderOptions.xml @@ -346,9 +346,33 @@ ## Examples The following example shows how the property affects different branches of the visual tree. In the first text block control, text is rendered with ClearType because the text block inherits the setting from the main window. In the second text block, ClearType is not used because the parent element's property is set. In the third text block, is used, but rendering issues may occur. - [!code-xml[ClearTypeHint#_ClearTypeHintXAML](~/samples/snippets/csharp/VS_Snippets_Wpf/cleartypehint/CS/window1.xaml#_cleartypehintxaml)] - [!code-xml[ClearTypeHint#_ClearTypeHintXAML](~/samples/snippets/xaml/VS_Snippets_Wpf/cleartypehint/xaml/window1.xaml#_cleartypehintxaml)] - +```xaml + + + + + + + + + + + + + + + + +``` + ]]> @@ -978,4 +1002,4 @@ - \ No newline at end of file + From 4441159e43b8f547e545529c1c5ef47593c83025 Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Tue, 31 Jul 2018 17:18:05 -0700 Subject: [PATCH 6/6] fixed broken links --- .../ContextMenuService.xml | 10 ++--- .../ToolTipService.xml | 10 ++--- xml/System.Windows.Controls/Validation.xml | 4 +- xml/System.Windows.Data/Binding.xml | 2 +- xml/System.Windows.Input/FocusManager.xml | 4 +- xml/System.Windows.Input/Keyboard.xml | 28 ++++++------ xml/System.Windows.Input/Mouse.xml | 30 ++++++------- xml/System.Windows.Input/Stylus.xml | 44 +++++++++---------- .../Storyboard.xml | 2 +- 9 files changed, 67 insertions(+), 67 deletions(-) diff --git a/xml/System.Windows.Controls/ContextMenuService.xml b/xml/System.Windows.Controls/ContextMenuService.xml index f235f79f8a0..d2e4e037971 100644 --- a/xml/System.Windows.Controls/ContextMenuService.xml +++ b/xml/System.Windows.Controls/ContextMenuService.xml @@ -595,7 +595,7 @@ by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + You can position a by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -744,7 +744,7 @@ by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + You can position a by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -805,7 +805,7 @@ by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + You can position a by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -866,7 +866,7 @@ by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + You can position a by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -1275,7 +1275,7 @@ by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + You can position a by setting the , , , , and properties. These properties behave the same as they do for a . For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information diff --git a/xml/System.Windows.Controls/ToolTipService.xml b/xml/System.Windows.Controls/ToolTipService.xml index 9aff8c47080..f520440e3ba 100644 --- a/xml/System.Windows.Controls/ToolTipService.xml +++ b/xml/System.Windows.Controls/ToolTipService.xml @@ -814,7 +814,7 @@ ## Remarks The property and the property values provide additional adjustment to the position of a tooltip that is defined by the property and the property values. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## XAML Attribute Usage @@ -1072,7 +1072,7 @@ ## Remarks This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -1133,7 +1133,7 @@ This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -1194,7 +1194,7 @@ This property is an attached property. For information about how to get or set this property in code, see the and methods. - behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + behaves similarly to the property. For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## Dependency Property Information @@ -2117,7 +2117,7 @@ and methods. behaves similarly to the property. For more information, see [Popup Placement Behavior](../Topic/Popup%20Placement%20Behavior.md). + This property is an attached property. For information about how to get or set the value of this property in code, see the and methods. behaves similarly to the property. For more information, see [Popup Placement Behavior](~/docs/framework/wpf/controls/popup-placement-behavior.md). ## XAML Attribute Usage diff --git a/xml/System.Windows.Controls/Validation.xml b/xml/System.Windows.Controls/Validation.xml index f2107bc10a0..3493ae8fb65 100644 --- a/xml/System.Windows.Controls/Validation.xml +++ b/xml/System.Windows.Controls/Validation.xml @@ -120,7 +120,7 @@ Also note that a valid value transfer in either direction (target-to-source or source-to-target) clears the .attached property. - For more information, see "Data Validation" in [Data Binding Overview](../Topic/Data%20Binding%20Overview.md). + For more information, see "Data Validation" in [Data Binding Overview](~/docs/framework/wpf/data/data-binding-overview.md). ## Routed Event Information @@ -197,7 +197,7 @@ ## Remarks The [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] data binding model allows you to associate with your object. If the user enters an invalid value, you may want to provide some feedback about the error on the application [!INCLUDE[TLA#tla_ui](~/includes/tlasharptla-ui-md.md)]. One way to provide such feedback is to set the . attached property to a custom . - For a detailed discussion of validation, see the Data Validation section of the [Data Binding Overview](../Topic/Data%20Binding%20Overview.md). + For a detailed discussion of validation, see the Data Validation section of the [Data Binding Overview](~/docs/framework/wpf/data/data-binding-overview.md). ## Dependency Property Information diff --git a/xml/System.Windows.Data/Binding.xml b/xml/System.Windows.Data/Binding.xml index 54a2185c0f5..a24c659f12b 100644 --- a/xml/System.Windows.Data/Binding.xml +++ b/xml/System.Windows.Data/Binding.xml @@ -1455,7 +1455,7 @@ ## Dependency Property Information diff --git a/xml/System.Windows.Input/FocusManager.xml b/xml/System.Windows.Input/FocusManager.xml index 04cbc531a27..a08cce40c3c 100644 --- a/xml/System.Windows.Input/FocusManager.xml +++ b/xml/System.Windows.Input/FocusManager.xml @@ -110,7 +110,7 @@ is the element which has logical focus for a specific focus scope. This object may or may not have keyboard focus. Keyboard focus refers to the element that receives keyboard input. For more information on focus, keyboard focus, and logical focus, see the [Input Overview](../Topic/Input%20Overview.md). + The is the element which has logical focus for a specific focus scope. This object may or may not have keyboard focus. Keyboard focus refers to the element that receives keyboard input. For more information on focus, keyboard focus, and logical focus, see the [Input Overview](~/docs/framework/wpf/advanced/input-overview.md). and can be used to get and set the focused element within the specified focus scope. @@ -338,7 +338,7 @@ ## Remarks A focus scope is a container element that keeps track of the within its scope. By default, the class is a focus scope as are the , , and classes. An element which is a focus scope has set to `true`. - For more information on focus, keyboard focus, and logical focus, see the [Input Overview](../Topic/Input%20Overview.md). + For more information on focus, keyboard focus, and logical focus, see the [Input Overview](~/docs/framework/wpf/advanced/input-overview.md). ## Dependency Property Information diff --git a/xml/System.Windows.Input/Keyboard.xml b/xml/System.Windows.Input/Keyboard.xml index 52e9c9e52fd..884f655ff6b 100644 --- a/xml/System.Windows.Input/Keyboard.xml +++ b/xml/System.Windows.Input/Keyboard.xml @@ -581,9 +581,9 @@ set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](~/docs/framework/wpf/advanced/input-overview.md) and [Focus Overview](~/docs/framework/wpf/advanced/focus-overview.md). If the event or the event is handled, keyboard focus does change. @@ -789,7 +789,7 @@ ## Routed Event Information @@ -851,7 +851,7 @@ ## Routed Event Information @@ -925,7 +925,7 @@ ## Routed Event Information @@ -989,9 +989,9 @@ set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](~/docs/framework/wpf/advanced/input-overview.md) and [Focus Overview](~/docs/framework/wpf/advanced/focus-overview.md). If the event or the event is handled, keyboard focus does not change. @@ -1106,11 +1106,11 @@ event or the event is handled, keyboard focus does not change. - Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](~/docs/framework/wpf/advanced/input-overview.md) and [Focus Overview](~/docs/framework/wpf/advanced/focus-overview.md). ## Routed Event Information @@ -1172,7 +1172,7 @@ ## Routed Event Information @@ -1234,7 +1234,7 @@ ## Routed Event Information @@ -1297,7 +1297,7 @@ ## Routed Event Information @@ -1360,11 +1360,11 @@ event or the event is handled, keyboard focus does not change. - Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](../Topic/Input%20Overview.md) and [Focus Overview](../Topic/Focus%20Overview.md). + Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus has set to `true`. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see [Input Overview](~/docs/framework/wpf/advanced/input-overview.md) and [Focus Overview](~/docs/framework/wpf/advanced/focus-overview.md). ## Routed Event Information diff --git a/xml/System.Windows.Input/Mouse.xml b/xml/System.Windows.Input/Mouse.xml index 062cd61d3aa..39366a031bc 100644 --- a/xml/System.Windows.Input/Mouse.xml +++ b/xml/System.Windows.Input/Mouse.xml @@ -726,7 +726,7 @@ ## Remarks When an element captures the mouse, it receives mouse input whether or not the cursor is within its borders. - This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](~/docs/framework/wpf/advanced/attached-events-overview.md). Because of the bubbling routing, the actual element that has capture might be a child element, not necessarily the element where the event handler is actually attached. Check the in the event arguments to determine the actual element that has mouse capture. @@ -826,7 +826,7 @@ ## Remarks When an element captures the mouse, it receives mouse input whether or not the cursor is within its borders. T - This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](~/docs/framework/wpf/advanced/attached-events-overview.md). Because of the bubbling routing, the actual element that lost capture might be a child element, not necessarily the element where the event handler is actually attached. Check the in the event arguments to determine the actual element that lost capture. @@ -926,7 +926,7 @@ ## Remarks To determine which mouse button was depressed, check the property in the passed to the handler. - This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](~/docs/framework/wpf/advanced/attached-events-overview.md). The [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] framework builds on this attached event by surfacing it as two different [!INCLUDE[TLA#tla_clr](~/includes/tlasharptla-clr-md.md)] events on and : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For a three-button mouse, there is no framework-level event support for the center button. You should use the event and check the state in the event arguments. @@ -1002,7 +1002,7 @@ : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For three-button, there is no framework-level event support for the center button, and you should use the event and check for the center button condition in the event arguments. @@ -1265,7 +1265,7 @@ ## Remarks Focus or mouse capture take precedence over where the mouse pointer is. If you receive this event from a focused or captured element, the mouse pointer might in fact be over another element at the time. - This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](~/docs/framework/wpf/advanced/attached-events-overview.md). ## Routed Event Information @@ -1401,7 +1401,7 @@ ## Remarks Which mouse button was depressed is determined by checking the arguments of the event. This is an attached event (using tunneling routing strategy) that is intended through attached event syntax to be referenced by existing [!INCLUDE[TLA#tla_ui](~/includes/tlasharptla-ui-md.md)] elements that take input. - This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](~/docs/framework/wpf/advanced/attached-events-overview.md). The [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] framework builds on this attached event by surfacing it as two different [!INCLUDE[TLA#tla_clr](~/includes/tlasharptla-clr-md.md)] events on : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For three-button, there is no framework-level event support for the center button, and you should use the event and check for the center button condition in the event arguments. @@ -1468,7 +1468,7 @@ ## Routed Event Information @@ -1598,7 +1598,7 @@ ## Remarks Which mouse button was released is determined by checking the arguments of the event. - This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](../Topic/Attached%20Events%20Overview.md). + This is an attached event. [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] implements attached events as routed events. Attached events are fundamentally a [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)] language concept for referencing events that can be handled on objects that do not define that event, which [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)] expands upon by also enabling the event to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. For details, see [Attached Events Overview](~/docs/framework/wpf/advanced/attached-events-overview.md). The [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] framework builds on this attached event by surfacing it as two different [!INCLUDE[TLA#tla_clr](~/includes/tlasharptla-clr-md.md)] events on : and . These implementations handle the underlying event and read the arguments of the event to determine whether the left or right mouse button was involved. For three-button, there is no framework-level event support for the center button, and you should use the event and check for the center button condition in the event arguments. @@ -1664,7 +1664,7 @@ ## Routed Event Information @@ -1829,7 +1829,7 @@ ## Routed Event Information diff --git a/xml/System.Windows.Input/Stylus.xml b/xml/System.Windows.Input/Stylus.xml index 68b921402f0..4f80a21beb2 100644 --- a/xml/System.Windows.Input/Stylus.xml +++ b/xml/System.Windows.Input/Stylus.xml @@ -1013,7 +1013,7 @@ ## Routed Event Information @@ -1322,7 +1322,7 @@ ## Routed Event Information @@ -1385,7 +1385,7 @@ ## Routed Event Information @@ -1448,7 +1448,7 @@ ## Routed Event Information @@ -1511,7 +1511,7 @@ ## Routed Event Information @@ -1574,7 +1574,7 @@ ## Routed Event Information @@ -1637,7 +1637,7 @@ ## Routed Event Information @@ -1700,7 +1700,7 @@ ## Routed Event Information @@ -1763,7 +1763,7 @@ ## Routed Event Information @@ -1826,7 +1826,7 @@ ## Routed Event Information @@ -1889,7 +1889,7 @@ ## Routed Event Information @@ -2713,7 +2713,7 @@ ## Routed Event Information @@ -2776,7 +2776,7 @@ ## Routed Event Information @@ -2839,7 +2839,7 @@ ## Routed Event Information @@ -2902,7 +2902,7 @@ ## Routed Event Information @@ -2965,7 +2965,7 @@ ## Routed Event Information @@ -3028,7 +3028,7 @@ ## Routed Event Information @@ -3091,7 +3091,7 @@ ## Routed Event Information @@ -3154,7 +3154,7 @@ ## Routed Event Information @@ -3217,7 +3217,7 @@ ## Routed Event Information @@ -3280,7 +3280,7 @@ ## Routed Event Information @@ -3343,7 +3343,7 @@ ## Routed Event Information diff --git a/xml/System.Windows.Media.Animation/Storyboard.xml b/xml/System.Windows.Media.Animation/Storyboard.xml index e95ce8d5930..267e33ea33e 100644 --- a/xml/System.Windows.Media.Animation/Storyboard.xml +++ b/xml/System.Windows.Media.Animation/Storyboard.xml @@ -2812,7 +2812,7 @@ - If the object is a or a , set its property. -- If the object is a or a custom or , assign it a name using the [x:Name Directive](../Topic/x:Name%20Directive.md) markup extension. +- If the object is a or a custom or , assign it a name using the [x:Name Directive](~/docs/framework/xaml-services/x-name-directive.md) markup extension. When using code, you make an object targetable by using the method to assign the object a name.