Skip to content

Commit 6ba3897

Browse files
Apply suggestions from code review
Co-authored-by: Carlos Sánchez López <[email protected]>
1 parent 6d32f04 commit 6ba3897

File tree

2 files changed

+29
-21
lines changed

2 files changed

+29
-21
lines changed

xml/System.Windows.Forms/Form.xml

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2290,7 +2290,7 @@
22902290
</value>
22912291
<remarks>
22922292
<para>
2293-
Note: Reading this property is only for tracking purposes. If the window's title bar color is changed through other external means (Win32 calls),
2293+
Reading this property is only for tracking purposes. If the window's title bar color is changed through other external means (Win32 calls),
22942294
reading this property will not reflect those changes, as the Win32 API does not provide a mechanism to retrieve the current title bar color.
22952295
</para>
22962296
<para>
@@ -2363,7 +2363,7 @@
23632363
</value>
23642364
<remarks>
23652365
<para>
2366-
Note: Reading this property is only for tracking purposes. If the Form's title bar's text color (window caption text) is changed through other external means (Win32 calls),
2366+
Reading this property is only for tracking purposes. If the Form's title bar's text color (window caption text) is changed through other external means (Win32 calls),
23672367
reading this property will not reflect those changes, as the Win32 API does not provide a mechanism to retrieve the current title bar color.
23682368
</para>
23692369
<para>
@@ -2557,7 +2557,7 @@
25572557
<value>To be added.</value>
25582558
<remarks>
25592559
<para>
2560-
Note: Reading this property is only for tracking purposes. If the Form's corner preference is changed through other external means (Win32 calls),
2560+
Reading this property is only for tracking purposes. If the Form's corner preference is changed through other external means (Win32 calls),
25612561
reading this property will not reflect those changes, as the Win32 API does not provide a mechanism to retrieve the current title bar color.
25622562
</para>
25632563
<para>
@@ -7624,9 +7624,7 @@ This example assumes that the `CreateMyOpaqueForm` method is called from another
76247624
<altmember cref="P:System.Windows.Forms.Form.ShowInTaskbar" />
76257625
<altmember cref="P:System.Windows.Forms.Form.ShowIcon" />
76267626
<altmember cref="E:System.Windows.Forms.Form.Shown" />
7627-
<exception cref="T:System.ArgumentException">
7628-
Thrown if the owner window is trying to set itself as its own owner.
7629-
</exception>
7627+
<exception cref="T:System.ArgumentException">The owner window is trying to set itself as its own owner.</exception>
76307628
</Docs>
76317629
</Member>
76327630
<Member MemberName="ShowAsync">
@@ -7698,19 +7696,21 @@ This example assumes that the `CreateMyOpaqueForm` method is called from another
76987696
</para>
76997697
</remarks>
77007698
<exception cref="T:System.InvalidOperationException">
7701-
<para>Thrown if:</para>
7702-
<list type="bullet">
7703-
<item><description>The form is already visible.</description></item>
7704-
<item><description>The form is disabled.</description> </item>
7705-
<item><description>The form is not a top-level form.</description></item>
7706-
<item><description>The form is trying to set itself as its own owner.</description></item>
7707-
<item><description>Thrown if the form is already displayed asynchronously or if no <see cref="T:System.Windows.Forms.WindowsFormsSynchronizationContext" /> could be retrieved or installed.</description></item>
7708-
<item><description>The operating system is in a non-interactive mode.</description></item>
7709-
</list>
7710-
</exception>
7711-
<exception cref="T:System.ArgumentException">
7712-
Thrown if the owner window is trying to set itself as its own owner.
7699+
<para>The form is already visible.</para>
7700+
<para>-or-</para>
7701+
<para>The form is disabled.</para>
7702+
<para>-or-</para>
7703+
<para>The form is not a top-level form.</para>
7704+
<para>-or-</para>
7705+
<para>The form is trying to set itself as its own owner.</para>
7706+
<para>-or-</para>
7707+
<para>The form is already displayed asynchronously.</para>
7708+
<para>-or-</para>
7709+
<para>No <see cref="T:System.Windows.Forms.WindowsFormsSynchronizationContext" /> could be retrieved or installed.</para>
7710+
<para>-or-</para>
7711+
<para>The operating system is in a non-interactive mode.</para>
77137712
</exception>
7713+
<exception cref="T:System.ArgumentException">The owner window is trying to set itself as its own owner.</exception>
77147714
</Docs>
77157715
</Member>
77167716
<MemberGroup MemberName="ShowDialog">
@@ -7916,7 +7916,11 @@ This example assumes that the `CreateMyOpaqueForm` method is called from another
79167916
Any exceptions that occur will be automatically propagated to the calling thread.
79177917
</para>
79187918
</remarks>
7919-
<exception cref="T:System.InvalidOperationException">Thrown if the form is already displayed asynchronously or if no <see cref="T:System.Windows.Forms.WindowsFormsSynchronizationContext" /> could be retrieved or installed.</exception>
7919+
<exception cref="T:System.InvalidOperationException">
7920+
<para>The form is already displayed asynchronously.</para>
7921+
<para>-or-</para>
7922+
<para>No <see cref="T:System.Windows.Forms.WindowsFormsSynchronizationContext" /> could be retrieved or installed.</para>
7923+
</exception>
79207924
</Docs>
79217925
</Member>
79227926
<Member MemberName="ShowDialogAsync">
@@ -7971,7 +7975,11 @@ This example assumes that the `CreateMyOpaqueForm` method is called from another
79717975
Any exceptions that occur will be automatically propagated to the calling thread.
79727976
</para>
79737977
</remarks>
7974-
<exception cref="T:System.InvalidOperationException">Thrown if the form is already displayed asynchronously or if no <see cref="T:System.Windows.Forms.WindowsFormsSynchronizationContext" /> could be retrieved or installed.</exception>
7978+
<exception cref="T:System.InvalidOperationException">
7979+
<para>The form is already displayed asynchronously.</para>
7980+
<para>-or-</para>
7981+
<para>No <see cref="T:System.Windows.Forms.WindowsFormsSynchronizationContext" /> could be retrieved or installed.</para>
7982+
</exception>
79757983
</Docs>
79767984
</Member>
79777985
<Member MemberName="ShowIcon">

xml/System.Windows.Forms/GiveFeedbackEventArgs.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -322,7 +322,7 @@
322322
<summary>Gets or sets a value indicating whether a layered window drag image is used.</summary>
323323
<value>
324324
<see langword="true" /> for <see cref="P:System.Windows.Forms.GiveFeedbackEventArgs.UseDefaultDragImage" /> to use a layered window drag image with a size of 96x96; otherwise <see langword="false" />.</value>
325-
<remarks></remarks>
325+
<remarks>To be added.</remarks>
326326
</Docs>
327327
</Member>
328328
</Members>

0 commit comments

Comments
 (0)