Add info about returning false from dialog window (dotnet#9769)

* Add info about returning false from dialog window

* simplify wording

Author: adegeo

xml/System.Windows/Window.xml

@@ -395,54 +395,51 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- A <xref:System.Windows.Window> can be closed using one of several, well-known, system-provided mechanisms located in its title bar, including:
 
--   ALT+F4.
+A <xref:System.Windows.Window> can be closed using one of several, well-known, system-provided mechanisms located in its title bar, including:
 
--   System menu &#124; **Close**.
+- ALT+F4.
+- System menu &#124; **Close**.
+- **Close** button.
 
--   **Close** button.
+A <xref:System.Windows.Window> can also be closed using one of several well-known mechanisms within the client area that are provided by developers, including:
 
- A <xref:System.Windows.Window> can also be closed using one of several well-known mechanisms within the client area that are provided by developers, including:
-
--   **File** &#124; **Exit** on a main window.
-
--   **File** &#124; **Close** or a **Close** button on a child window.
+- **File** > **Exit** on a main window.
+- **File** > **Close** or a **Close** button on a child window.
 
 > [!NOTE]
->  **OK** and **Cancel** buttons on a dialog box are also developer-provided, although will likely set <xref:System.Windows.Window.DialogResult%2A>, which automatically closes a window that was opened by calling <xref:System.Windows.Window.ShowDialog%2A>.
+> **OK** and **Cancel** buttons on a dialog box are also developer-provided, although will likely set <xref:System.Windows.Window.DialogResult%2A>, which automatically closes a window that was opened by calling <xref:System.Windows.Window.ShowDialog%2A>.
 
- These mechanisms require you to explicitly call <xref:System.Windows.Window.Close%2A> to close a window.
+These mechanisms require you to explicitly call <xref:System.Windows.Window.Close%2A> to close a window.
 
 > [!NOTE]
->  If a window, opened by calling <xref:System.Windows.Window.ShowDialog%2A>, and with a <xref:System.Windows.Controls.Button> with its <xref:System.Windows.Controls.Button.IsCancel%2A> property set to true, will automatically close when the button is either clicked, or ESC is pressed. If the window was opened using <xref:System.Windows.Window.Show%2A>, however, <xref:System.Windows.Window.Close%2A> must be explicitly called, such as from <xref:System.Windows.Controls.Primitives.ButtonBase.Click> event handler for the <xref:System.Windows.Controls.Button>.
+> If a window, opened by calling <xref:System.Windows.Window.ShowDialog%2A>, and with a <xref:System.Windows.Controls.Button> with its <xref:System.Windows.Controls.Button.IsCancel%2A> property set to true, will automatically close when the button is either clicked, or ESC is pressed. If the window was opened using <xref:System.Windows.Window.Show%2A>, however, <xref:System.Windows.Window.Close%2A> must be explicitly called, such as from <xref:System.Windows.Controls.Primitives.ButtonBase.Click> event handler for the <xref:System.Windows.Controls.Button>.
 
- Closing a window causes the <xref:System.Windows.Window.Closing> event to be raised. If the <xref:System.Windows.Window.Closing> event isn't canceled, the following occurs:
+Closing a window causes the <xref:System.Windows.Window.Closing> event to be raised. If the <xref:System.Windows.Window.Closing> event isn't canceled, the following occurs:
 
--   The <xref:System.Windows.Window> is removed from <xref:System.Windows.Application.Windows%2A?displayProperty=nameWithType> (if an <xref:System.Windows.Application> object exists).
+- The <xref:System.Windows.Window> is removed from <xref:System.Windows.Application.Windows%2A?displayProperty=nameWithType> (if an <xref:System.Windows.Application> object exists).
 
--   The <xref:System.Windows.Window> is removed from the owner <xref:System.Windows.Window> if the owner/owned relationship was established before the owned <xref:System.Windows.Window> was shown and after the owner <xref:System.Windows.Window> was opened.
+- The <xref:System.Windows.Window> is removed from the owner <xref:System.Windows.Window> if the owner/owned relationship was established before the owned <xref:System.Windows.Window> was shown and after the owner <xref:System.Windows.Window> was opened.
 
--   The <xref:System.Windows.Window.Closed> event is raised.
+- The <xref:System.Windows.Window.Closed> event is raised.
 
--   Unmanaged resources created by the <xref:System.Windows.Window> are disposed.
+- Unmanaged resources created by the <xref:System.Windows.Window> are disposed.
 
--   If <xref:System.Windows.Window.ShowDialog%2A> was called to show the <xref:System.Windows.Window>, <xref:System.Windows.Window.ShowDialog%2A> returns.
+- If <xref:System.Windows.Window.ShowDialog%2A> was called to show the <xref:System.Windows.Window>, <xref:System.Windows.Window.ShowDialog%2A> returns false.
 
- Closing a <xref:System.Windows.Window> causes any windows that it owns to be closed. Furthermore, closing a <xref:System.Windows.Window> may cause an application to stop running depending on how the <xref:System.Windows.Application.ShutdownMode%2A?displayProperty=nameWithType> property is set.
+  Closing a <xref:System.Windows.Window> causes any windows that it owns to be closed. Furthermore, closing a <xref:System.Windows.Window> may cause an application to stop running depending on how the <xref:System.Windows.Application.ShutdownMode%2A?displayProperty=nameWithType> property is set.
 
 > [!NOTE]
->  This method cannot be called when a window is hosted in a browser.
-
-
+> This method cannot be called when a window is hosted in a browser.
 
 ## Examples
- The following example shows a **File** &#124; **Exit** menu being handled to explicitly call <xref:System.Windows.Window.Close%2A>.
 
- :::code language="xaml" source="~/snippets/csharp/System.Windows/Window/Close/MainWindow.xaml" id="Snippetwindowclosexaml":::
+The following example shows a **File** > **Exit** menu being handled to explicitly call <xref:System.Windows.Window.Close%2A>.
+
+:::code language="xaml" source="~/snippets/csharp/System.Windows/Window/Close/MainWindow.xaml" id="Snippetwindowclosexaml":::
 
- :::code language="csharp" source="~/snippets/csharp/System.Windows/Window/Close/MainWindow.xaml.cs" id="Snippetwindowclosecodebehind":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/WindowCloseSnippets/visualbasic/mainwindow.xaml.vb" id="Snippetwindowclosecodebehind":::
+:::code language="csharp" source="~/snippets/csharp/System.Windows/Window/Close/MainWindow.xaml.cs" id="Snippetwindowclosecodebehind":::
+:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/WindowCloseSnippets/visualbasic/mainwindow.xaml.vb" id="Snippetwindowclosecodebehind":::
 
  ]]></format>
         </remarks>