Skip to content

Commit fa5b96f

Browse files
committed
delete 404 links to samples
1 parent d4a3c0c commit fa5b96f

29 files changed

+6312
-6973
lines changed

xml/System.Windows.Controls/ContentPresenter.xml

+168-169
Large diffs are not rendered by default.

xml/System.Windows.Controls/ControlTemplate.xml

+125-127
Large diffs are not rendered by default.

xml/System.Windows.Controls/FlowDocumentReaderViewingMode.xml

+15-16
Original file line numberDiff line numberDiff line change
@@ -21,25 +21,24 @@
2121
<Docs>
2222
<summary>Names viewing modes for the <see cref="T:System.Windows.Controls.FlowDocumentReader" /> control.</summary>
2323
<remarks>
24-
<format type="text/markdown"><![CDATA[
25-
26-
## Remarks
27-
The following figure provides an example of Page viewing mode. Page mode displays a single page of content at a time. Note that this mode includes page navigation controls that display the current page count and position and provide **Next** and **Previous** page buttons. This viewing mode does not display scroll bars.
28-
29-
![FlowDocReader ViewMode of Page](~/add/media/flowdocrdrviewmode-page.png "FlowDocReader ViewMode of Page")
30-
31-
The following figure provides an example of TwoPage viewing mode. TwoPage mode is similar to Page mode, except two facing pages are displayed at a time, similar to an open book. Note that this mode includes page navigation controls that display the current page count and position and provide **Next** and **Previous** page buttons; in this mode, the **Next** and **Previous** page buttons cause content to jump by two pages at a time, similar to turning a page in a book. The current page number indicates the leading page. This viewing mode does not display scroll bars.
32-
33-
![FlowDocumentReader ViewMode of Book](~/add/media/flowdocrdrviewmode-book.png "FlowDocumentReader ViewMode of Book")
34-
35-
The following figure provides an example of Scroll viewing mode. This viewing mode does not include page navigation controls; rather, the user navigates content using provided scroll bars. For the purposes of page count and navigation, Scroll viewing mode presents a single page whose number is always 1.
36-
37-
![Screenshot: FlowDocumentReader ViewMode of Scroll](~/add/media/flowdocrdrviewmode-scroll.png "Screenshot: FlowDocumentReader ViewMode of Scroll")
38-
24+
<format type="text/markdown"><![CDATA[
25+
26+
## Remarks
27+
The following figure provides an example of Page viewing mode. Page mode displays a single page of content at a time. Note that this mode includes page navigation controls that display the current page count and position and provide **Next** and **Previous** page buttons. This viewing mode does not display scroll bars.
28+
29+
![FlowDocReader ViewMode of Page](~/add/media/flowdocrdrviewmode-page.png)
30+
31+
The following figure provides an example of TwoPage viewing mode. TwoPage mode is similar to Page mode, except two facing pages are displayed at a time, similar to an open book. Note that this mode includes page navigation controls that display the current page count and position and provide **Next** and **Previous** page buttons; in this mode, the **Next** and **Previous** page buttons cause content to jump by two pages at a time, similar to turning a page in a book. The current page number indicates the leading page. This viewing mode does not display scroll bars.
32+
33+
![FlowDocumentReader ViewMode of Book](~/add/media/flowdocrdrviewmode-book.png)
34+
35+
The following figure provides an example of Scroll viewing mode. This viewing mode does not include page navigation controls; rather, the user navigates content using provided scroll bars. For the purposes of page count and navigation, Scroll viewing mode presents a single page whose number is always 1.
36+
37+
![Screenshot: FlowDocumentReader ViewMode of Scroll](~/add/media/flowdocrdrviewmode-scroll.png)
38+
3939
]]></format>
4040
</remarks>
4141
<altmember cref="P:System.Windows.Controls.FlowDocumentReader.ViewingMode" />
42-
<related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160054">WPF Layout Gallery Sample</related>
4342
</Docs>
4443
<Members>
4544
<Member MemberName="Page">

xml/System.Windows.Controls/ItemsControl.xml

+633-636
Large diffs are not rendered by default.

xml/System.Windows.Controls/ListView.xml

+66-66
Original file line numberDiff line numberDiff line change
@@ -29,41 +29,41 @@
2929
<Docs>
3030
<summary>Represents a control that displays a list of data items.</summary>
3131
<remarks>
32-
<format type="text/markdown"><![CDATA[
33-
34-
## Remarks
35-
<xref:System.Windows.Controls.ListView> is an <xref:System.Windows.Controls.ItemsControl>, which means it can contain a collection of objects of any type (such as string, image, or panel). For more information, see the <xref:System.Windows.Controls.ItemsControl> class.
36-
37-
The presentation of the data items in a <xref:System.Windows.Controls.ListView> is defined by its view mode, which is specified by the <xref:System.Windows.Controls.ListView.View%2A> property. Windows Presentation Foundation (WPF) provides a <xref:System.Windows.Controls.GridView> view mode that partitions the <xref:System.Windows.Controls.ListView> data item content into columns. The properties and methods on <xref:System.Windows.Controls.GridView> and its related classes style and specify the content of the columns.
38-
39-
The following illustration shows a <xref:System.Windows.Controls.ListView> with a <xref:System.Windows.Controls.GridView> view.
40-
41-
![ListView with GridView output](~/add/media/listviewgridview.JPG "ListView with GridView output")
42-
43-
You can also define custom views by creating a class that derives from <xref:System.Windows.Controls.ViewBase>. For more information, see [How to: Create a Custom View Mode for a ListView](/dotnet/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview).
44-
45-
If you define a custom <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> for a <xref:System.Windows.Controls.ListView> control and also define an <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>, you must include a <xref:System.Windows.Controls.ContentPresenter> in the <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>. The <xref:System.Windows.Controls.ContentPresenter> is required for the <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> to work correctly.
46-
47-
To avoid alignment issues in a <xref:System.Windows.Controls.GridView> view mode, do not add content or set properties that affect the width of an item in the <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> of a <xref:System.Windows.Controls.ListView>. To prevent alignment issues, use properties and templates that are defined for the <xref:System.Windows.Controls.GridView> view mode. This includes properties and templates that are defined for classes that are used in a <xref:System.Windows.Controls.GridView> view mode, such as <xref:System.Windows.Controls.GridViewColumn> and <xref:System.Windows.Controls.GridViewColumnHeader>.
48-
49-
Two <xref:System.Windows.Controls.ListView> controls cannot share the same view. To specify a view that can be used more than one time, use templates or styles. For an example of a <xref:System.Windows.Controls.GridView> and other custom views that are defined as reusable resources, see [ListView with Multiple Views Sample](https://go.microsoft.com/fwlink/?LinkID=160013).
50-
51-
Do not use the <xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> and <xref:System.Windows.Controls.Control.VerticalContentAlignment%2A> properties for <xref:System.Windows.Controls.ListView> content that is displayed by using a <xref:System.Windows.Controls.GridView>. To specify the alignment of content in a column of a <xref:System.Windows.Controls.GridView>, define a <xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A>.
52-
53-
Displaying a large number of items may cause performance issues. See [Optimizing Performance: Controls](/dotnet/framework/wpf/advanced/optimizing-performance-controls) for more information.
54-
55-
## Customizing the ListView Control
56-
To apply the same property settings to multiple <xref:System.Windows.Controls.ListView> controls, use the <xref:System.Windows.FrameworkElement.Style%2A> property. You can modify the default <xref:System.Windows.Controls.ControlTemplate> to give the control a unique appearance. For more information about creating a <xref:System.Windows.Controls.ControlTemplate>, see [Customizing the Appearance of an Existing Control by Creating a ControlTemplate](/dotnet/framework/wpf/controls/customizing-the-appearance-of-an-existing-control). To see the parts and states that are specific to the <xref:System.Windows.Controls.ListView>, see [ListView Styles and Templates](/dotnet/framework/wpf/controls/listview-styles-and-templates).
57-
32+
<format type="text/markdown"><![CDATA[
33+
34+
## Remarks
35+
<xref:System.Windows.Controls.ListView> is an <xref:System.Windows.Controls.ItemsControl>, which means it can contain a collection of objects of any type (such as string, image, or panel). For more information, see the <xref:System.Windows.Controls.ItemsControl> class.
36+
37+
The presentation of the data items in a <xref:System.Windows.Controls.ListView> is defined by its view mode, which is specified by the <xref:System.Windows.Controls.ListView.View%2A> property. Windows Presentation Foundation (WPF) provides a <xref:System.Windows.Controls.GridView> view mode that partitions the <xref:System.Windows.Controls.ListView> data item content into columns. The properties and methods on <xref:System.Windows.Controls.GridView> and its related classes style and specify the content of the columns.
38+
39+
The following illustration shows a <xref:System.Windows.Controls.ListView> with a <xref:System.Windows.Controls.GridView> view.
40+
41+
![ListView with GridView output](~/add/media/listviewgridview.JPG "ListView with GridView output")
42+
43+
You can also define custom views by creating a class that derives from <xref:System.Windows.Controls.ViewBase>. For more information, see [How to: Create a Custom View Mode for a ListView](/dotnet/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview).
44+
45+
If you define a custom <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> for a <xref:System.Windows.Controls.ListView> control and also define an <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>, you must include a <xref:System.Windows.Controls.ContentPresenter> in the <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>. The <xref:System.Windows.Controls.ContentPresenter> is required for the <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> to work correctly.
46+
47+
To avoid alignment issues in a <xref:System.Windows.Controls.GridView> view mode, do not add content or set properties that affect the width of an item in the <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> of a <xref:System.Windows.Controls.ListView>. To prevent alignment issues, use properties and templates that are defined for the <xref:System.Windows.Controls.GridView> view mode. This includes properties and templates that are defined for classes that are used in a <xref:System.Windows.Controls.GridView> view mode, such as <xref:System.Windows.Controls.GridViewColumn> and <xref:System.Windows.Controls.GridViewColumnHeader>.
48+
49+
Two <xref:System.Windows.Controls.ListView> controls cannot share the same view. To specify a view that can be used more than one time, use templates or styles.
50+
51+
Do not use the <xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> and <xref:System.Windows.Controls.Control.VerticalContentAlignment%2A> properties for <xref:System.Windows.Controls.ListView> content that is displayed by using a <xref:System.Windows.Controls.GridView>. To specify the alignment of content in a column of a <xref:System.Windows.Controls.GridView>, define a <xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A>.
52+
53+
Displaying a large number of items may cause performance issues. See [Optimizing Performance: Controls](/dotnet/framework/wpf/advanced/optimizing-performance-controls) for more information.
54+
55+
## Customizing the ListView Control
56+
To apply the same property settings to multiple <xref:System.Windows.Controls.ListView> controls, use the <xref:System.Windows.FrameworkElement.Style%2A> property. You can modify the default <xref:System.Windows.Controls.ControlTemplate> to give the control a unique appearance. For more information about creating a <xref:System.Windows.Controls.ControlTemplate>, see [Customizing the Appearance of an Existing Control by Creating a ControlTemplate](/dotnet/framework/wpf/controls/customizing-the-appearance-of-an-existing-control). To see the parts and states that are specific to the <xref:System.Windows.Controls.ListView>, see [ListView Styles and Templates](/dotnet/framework/wpf/controls/listview-styles-and-templates).
57+
5858
Dependency properties for this control might be set by the control's default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running.
59-
60-
[!INCLUDE[setting-a-visual-property](~/includes/visual-property-note.md)]
61-
62-
## Examples
63-
The following example shows how to create a <xref:System.Windows.Controls.ListView> control that implements a <xref:System.Windows.Controls.GridView> as its <xref:System.Windows.Controls.ListView.View%2A>. The illustration in the Remarks section is taken from this example.
64-
65-
:::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/GridView/Overview/Window1.xaml" id="Snippetlistviewemployee":::
66-
59+
60+
[!INCLUDE[setting-a-visual-property](~/includes/visual-property-note.md)]
61+
62+
## Examples
63+
The following example shows how to create a <xref:System.Windows.Controls.ListView> control that implements a <xref:System.Windows.Controls.GridView> as its <xref:System.Windows.Controls.ListView.View%2A>. The illustration in the Remarks section is taken from this example.
64+
65+
:::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/GridView/Overview/Window1.xaml" id="Snippetlistviewemployee":::
66+
6767
]]></format>
6868
</remarks>
6969
<altmember cref="T:System.Windows.Controls.ListViewItem" />
@@ -247,11 +247,11 @@
247247
<param name="e">The event arguments.</param>
248248
<summary>Responds to an <see cref="M:System.Windows.Controls.ItemsControl.OnItemsChanged(System.Collections.Specialized.NotifyCollectionChangedEventArgs)" />.</summary>
249249
<remarks>
250-
<format type="text/markdown"><![CDATA[
251-
252-
## Remarks
253-
This method is called when there is a change in the items collection of a <xref:System.Windows.Controls.ListView> control.
254-
250+
<format type="text/markdown"><![CDATA[
251+
252+
## Remarks
253+
This method is called when there is a change in the items collection of a <xref:System.Windows.Controls.ListView> control.
254+
255255
]]></format>
256256
</remarks>
257257
</Docs>
@@ -286,11 +286,11 @@
286286
<param name="item">The object to use to create the <see cref="T:System.Windows.Controls.ListViewItem" />.</param>
287287
<summary>Sets the styles, templates, and bindings for a <see cref="T:System.Windows.Controls.ListViewItem" />.</summary>
288288
<remarks>
289-
<format type="text/markdown"><![CDATA[
290-
291-
## Remarks
292-
This method prepares a <xref:System.Windows.Controls.ListViewItem> control for display according to the specified <xref:System.Windows.Controls.ListView.View%2A>.
293-
289+
<format type="text/markdown"><![CDATA[
290+
291+
## Remarks
292+
This method prepares a <xref:System.Windows.Controls.ListViewItem> control for display according to the specified <xref:System.Windows.Controls.ListView.View%2A>.
293+
294294
]]></format>
295295
</remarks>
296296
</Docs>
@@ -320,31 +320,31 @@
320320
<summary>Gets or sets an object that defines how the data is styled and organized in a <see cref="T:System.Windows.Controls.ListView" /> control.</summary>
321321
<value>A <see cref="T:System.Windows.Controls.ViewBase" /> object that specifies how to display information in the <see cref="T:System.Windows.Controls.ListView" />.</value>
322322
<remarks>
323-
<format type="text/markdown"><![CDATA[
324-
325-
## Remarks
326-
The .NET Framework environment includes the configurable view mode named <xref:System.Windows.Controls.GridView>. You can also create a custom view that inherits from <xref:System.Windows.Controls.ViewBase>. For more information, see [How to: Create a Custom View Mode for a ListView](/dotnet/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview).
327-
328-
<a name="dependencyPropertyInfo_View"></a>
329-
## Dependency Property Information
330-
331-
|||
332-
|-|-|
333-
|Identifier field|<xref:System.Windows.Controls.ListView.ViewProperty>|
334-
|Metadata properties set to `true`|None|
335-
323+
<format type="text/markdown"><![CDATA[
324+
325+
## Remarks
326+
The .NET Framework environment includes the configurable view mode named <xref:System.Windows.Controls.GridView>. You can also create a custom view that inherits from <xref:System.Windows.Controls.ViewBase>. For more information, see [How to: Create a Custom View Mode for a ListView](/dotnet/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview).
327+
328+
<a name="dependencyPropertyInfo_View"></a>
329+
## Dependency Property Information
330+
331+
|||
332+
|-|-|
333+
|Identifier field|<xref:System.Windows.Controls.ListView.ViewProperty>|
334+
|Metadata properties set to `true`|None|
335+
336336
> [!NOTE]
337-
> The type of property metadata for this property is <xref:System.Windows.PropertyMetadata>, not <xref:System.Windows.FrameworkPropertyMetadata>.
338-
339-
340-
341-
## Examples
342-
The following example shows how to specify a <xref:System.Windows.Controls.GridView> object as the <xref:System.Windows.Controls.ListView.View%2A> for a <xref:System.Windows.Controls.ListView> control.
343-
337+
> The type of property metadata for this property is <xref:System.Windows.PropertyMetadata>, not <xref:System.Windows.FrameworkPropertyMetadata>.
338+
339+
340+
341+
## Examples
342+
The following example shows how to specify a <xref:System.Windows.Controls.GridView> object as the <xref:System.Windows.Controls.ListView.View%2A> for a <xref:System.Windows.Controls.ListView> control.
343+
344344
:::code language="csharp" source="~/snippets/csharp/System.Windows.Controls/GridView/Overview/Window1.xaml.cs" id="Snippetlistviewview":::
345345
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/ListViewCode/visualbasic/window1.xaml.vb" id="Snippetlistviewview":::
346-
:::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/GridView/Overview/Window1.xaml" id="Snippetlistviewview":::
347-
346+
:::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/GridView/Overview/Window1.xaml" id="Snippetlistviewview":::
347+
348348
]]></format>
349349
</remarks>
350350
<altmember cref="T:System.Windows.Controls.ViewBase" />

0 commit comments

Comments
 (0)