ADD Added missing XML documentation.

NTFY-16


git-svn-id: https://svn.evolvesoftware.ch/repos/evolve.net/WPF/NotifyIcon@211 9f600761-6f11-4665-b6dc-0185e9171623

Source/NotifyIconWpf/Interop/IconDataMembers.cs

@@ -40,10 +40,9 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
         /// </summary>
         Info = 0x10,
 
-        /// <summary>
+        // Internal identifier is set. Reserved, thus commented out.
-        /// Internal identifier is set. Reserved, thus commented out.
-        /// </summary>
         //Guid = 0x20,
+
         /// <summary>
         /// Windows Vista (Shell32.dll version 6.0.6) and later. If the ToolTip
         /// cannot be displayed immediately, discard it.<br/>

Source/NotifyIconWpf/Interop/IconState.cs

@@ -16,9 +16,7 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
         /// </summary>
         Hidden = 0x01,
 
-        /// <summary>
+        // The icon is shared - currently not supported, thus commented out.
-        /// The icon is shared - currently not supported, thus commented out.
-        /// </summary>
         //Shared = 0x02
     }
 }

Source/NotifyIconWpf/Interop/Point.cs

@@ -8,7 +8,13 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
     [StructLayout(LayoutKind.Sequential)]
     public struct Point
     {
+        /// <summary>
+        /// X coordinate.
+        /// </summary>
         public int X;
+        /// <summary>
+        /// Y coordinate.
+        /// </summary>
         public int Y;
     }
 }

Source/NotifyIconWpf/Interop/WindowClass.cs

@@ -17,6 +17,8 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
     [StructLayout(LayoutKind.Sequential)]
     public struct WindowClass
     {
+        #pragma warning disable 1591
+
         public uint style;
         public WindowProcedureHandler lpfnWndProc;
         public int cbClsExtra;
@@ -27,5 +29,7 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
         public IntPtr hbrBackground;
         [MarshalAs(UnmanagedType.LPWStr)] public string lpszMenuName;
         [MarshalAs(UnmanagedType.LPWStr)] public string lpszClassName;
+
+        #pragma warning restore 1591
     }
 }

Source/NotifyIconWpf/Interop/WindowMessageSink.cs

@@ -71,7 +71,7 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
 
         /// <summary>
         /// Handle for the message window.
-        /// </summary
+        /// </summary> 
         internal IntPtr MessageWindowHandle { get; private set; }
 
         /// <summary>
@@ -309,8 +309,7 @@ namespace Hardcodet.Wpf.TaskbarNotification.Interop
         #region Dispose
 
         /// <summary>
-        /// Set to true as soon as <see cref="Dispose"/>
+        /// Set to true as soon as <c>Dispose</c> has been invoked.
-        /// has been invoked.
         /// </summary>
         public bool IsDisposed { get; private set; }
 

Source/NotifyIconWpf/TaskbarIcon.Declarations.cs

@@ -142,6 +142,9 @@ namespace Hardcodet.Wpf.TaskbarNotification
             = DependencyProperty.RegisterReadOnly("CustomBalloon", typeof (Popup), typeof (TaskbarIcon),
                 new FrameworkPropertyMetadata(null));
 
+        /// <summary>
+        /// Maintains a currently displayed custom balloon.
+        /// </summary>
         public static readonly DependencyProperty CustomBalloonProperty
             = CustomBalloonPropertyKey.DependencyProperty;
 

Source/NotifyIconWpf/TaskbarIcon.cs

@@ -514,7 +514,7 @@ namespace Hardcodet.Wpf.TaskbarNotification
         /// <see cref="Popup"/> because there was no way to prevent a
         /// popup from causing cyclic open/close commands if it was
         /// placed under the mouse. ToolTip internally uses a Popup of
-        /// its own, but takes advance of Popup's internal <see cref="Popup.HitTestable"/>
+        /// its own, but takes advance of Popup's internal <see cref="UIElement.IsHitTestVisible"/>
         /// property which prevents this issue.</remarks>
         private void CreateCustomToolTip()
         {
@@ -600,7 +600,7 @@ namespace Hardcodet.Wpf.TaskbarNotification
         /// <see cref="Popup"/> because there was no way to prevent a
         /// popup from causing cyclic open/close commands if it was
         /// placed under the mouse. ToolTip internally uses a Popup of
-        /// its own, but takes advance of Popup's internal <see cref="Popup.HitTestable"/>
+        /// its own, but takes advance of Popup's internal <see cref="UIElement.IsHitTestVisible"/>
         /// property which prevents this issue.</remarks>
         private void CreatePopup()
         {
@@ -986,8 +986,7 @@ namespace Hardcodet.Wpf.TaskbarNotification
         #region Dispose / Exit
 
         /// <summary>
-        /// Set to true as soon as <see cref="Dispose"/>
+        /// Set to true as soon as <c>Dispose</c> has been invoked.
-        /// has been invoked.
         /// </summary>
         public bool IsDisposed { get; private set; }