Add some xml documentation (#1643)

* add some xml doc

* add missing drag xml doc

* xml doc corrections

* more xml doc

Author: dga711

CefSharp/AddressChangedEventArgs.cs

@@ -14,6 +14,11 @@ public class AddressChangedEventArgs : EventArgs
         public IBrowser Browser { get; set; }
         public string Address { get; private set; }
 
+        /// <summary>
+        /// Called when a frame's address has changed. 
+        /// </summary>
+        /// <param name="browser">the browser object</param>
+        /// <param name="address">the address</param>
         public AddressChangedEventArgs(IBrowser browser, string address)
         {
             Browser = browser;

CefSharp/CEFCursorType.cs

@@ -4,6 +4,9 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// Cursor type values.
+    /// </summary>
     public enum CefCursorType
     {
         Pointer = 0,

CefSharp/CefJsDialogType.cs

@@ -4,6 +4,9 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// Supported JavaScript dialog types.
+    /// </summary>
     public enum CefJsDialogType
     {
         Alert = 0,

CefSharp/CefReturnValue.cs

@@ -4,6 +4,9 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// Return value types.
+    /// </summary>
 	public enum CefReturnValue
 	{
 		/// <summary>

CefSharp/CefState.cs

@@ -4,6 +4,9 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// Represents the state of a setting.
+    /// </summary>
     public enum CefState
     {
         /// <summary>

CefSharp/DefaultResourceHandlerFactory.cs

@@ -34,11 +34,22 @@ public virtual bool UnregisterHandler(string url)
             return Handlers.TryRemove(url, out handler);
         }
 
+        /// <summary>
+        /// Are there any <see cref="ResourceHandler"/>'s registered?
+        /// </summary>
         public bool HasHandlers
         { 
             get { return Handlers.Count > 0; }
         }
 
+        /// <summary>
+        /// Called before a resource is loaded. To specify a handler for the resource return a <see cref="ResourceHandler"/> object
+        /// </summary>
+        /// <param name="browserControl">The browser UI control</param>
+        /// <param name="browser">the browser object</param>
+        /// <param name="frame">the frame object</param>
+        /// <param name="request">the request object - cannot be modified in this callback</param>
+        /// <returns>To allow the resource to load normally return NULL otherwise return an instance of ResourceHandler with a valid stream</returns>
         public virtual IResourceHandler GetResourceHandler(IWebBrowser browserControl, IBrowser browser, IFrame frame, IRequest request)
         {
             try

CefSharp/DragOperationsMask.cs

@@ -7,6 +7,9 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// "Verb" of a drag-and-drop operation as negotiated between the source and destination.
+    /// </summary>
     [Flags]
     public enum DragOperationsMask : uint
     {

CefSharp/DraggableRegion.cs

@@ -4,6 +4,9 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// Representing a draggable region.
+    /// </summary>
     public struct DraggableRegion
     {
         public int Width { get; private set; }

CefSharp/IBrowserHost.cs

@@ -32,16 +32,31 @@ public interface IBrowserHost : IDisposable
         /// </summary>
         void CloseDevTools();
 
+        /// <summary>
+        /// Call this method when the user drags the mouse into the web view (before calling <see cref="DragTargetDragOver"/>/<see cref="DragTargetDragLeave"/>/<see cref="DragTargetDragDrop"/>).
+        /// </summary>
         void DragTargetDragEnter(IDragData dragData, MouseEvent mouseEvent, DragOperationsMask allowedOperations);
 
+        /// <summary>
+        /// Call this method each time the mouse is moved across the web view during a drag operation (after calling <see cref="DragTargetDragEnter"/> and before calling <see cref="DragTargetDragLeave"/>/<see cref="DragTargetDragDrop"/>). 
+        /// This method is only used when window rendering is disabled.
+        /// </summary>
         void DragTargetDragOver(MouseEvent mouseEvent, DragOperationsMask allowedOperations);
 
+        /// <summary>
+        /// Call this method when the user completes the drag operation by dropping the object onto the web view (after calling <see cref="DragTargetDragEnter"/>). 
+        /// The object being dropped is <see cref="IDragData"/>, given as an argument to the previous <see cref="DragTargetDragEnter"/> call. 
+        /// This method is only used when window rendering is disabled.
+        /// </summary>
         void DragTargetDragDrop(MouseEvent mouseEvent);
 
         void DragSourceEndedAt(int x, int y, DragOperationsMask op);
 
+        /// <summary>
+        /// Call this method when the user drags the mouse out of the web view (after calling <see cref="DragTargetDragEnter"/>). This method is only used when window rendering is disabled.
+        /// </summary>
         void DragTargetDragLeave();
-
+        
         void DragSourceSystemDragEnded();
 
         /// <summary>

CefSharp/ICookieVisitor.cs

@@ -4,6 +4,10 @@
 
 namespace CefSharp
 {
+    /// <summary>
+    /// Interface to implement for visiting cookie values. 
+    /// The methods of this class will always be called on the IO thread.
+    /// </summary>
     public interface ICookieVisitor
     {
         bool Visit(Cookie cookie, int count, int total, ref bool deleteCookie);