[Maps] Add doxygen for map view classes
authorDinesh Dwivedi <dinesh.d@samsung.com>
Tue, 27 Dec 2016 14:09:17 +0000 (19:39 +0530)
committerchanywa <cbible.kim@samsung.com>
Wed, 28 Dec 2016 02:25:00 +0000 (11:25 +0900)
Change-Id: I813850d4a24216f029cc6c67acd77940bf9356b1
Signed-off-by: Dinesh Dwivedi <dinesh.d@samsung.com>
Signed-off-by: chanywa <cbible.kim@samsung.com>
Conflicts:
Tizen.Maps/Interop/Interop.Service.cs
Tizen.Maps/Interop/Interop.View.cs

Change-Id: I4dd8f6de32e7497f1ab770232f40cdec7621774b

15 files changed:
src/Tizen.Maps/Interop/Interop.Service.cs
src/Tizen.Maps/Interop/Interop.View.cs
src/Tizen.Maps/Tizen.Maps.Net45.csproj
src/Tizen.Maps/Tizen.Maps.csproj
src/Tizen.Maps/Tizen.Maps/GestureType.cs
src/Tizen.Maps/Tizen.Maps/MapGestureEventArgs.cs
src/Tizen.Maps/Tizen.Maps/MapObject.cs
src/Tizen.Maps/Tizen.Maps/MapObjectEventArgs.cs
src/Tizen.Maps/Tizen.Maps/MapObjectType.cs [deleted file]
src/Tizen.Maps/Tizen.Maps/MapTypes.cs
src/Tizen.Maps/Tizen.Maps/MapView.cs
src/Tizen.Maps/Tizen.Maps/Marker.cs
src/Tizen.Maps/Tizen.Maps/Overlay.cs
src/Tizen.Maps/Tizen.Maps/Polygon.cs
src/Tizen.Maps/Tizen.Maps/Polyline.cs

index 7ccf9cd..dcd3aa8 100755 (executable)
@@ -160,8 +160,6 @@ internal static partial class Interop
 
     internal class ServiceHandle : SafeMapsHandle
     {
-        internal ErrorCode DestroyHandle(IntPtr handle) { return Service.Destroy(handle); }
-
-        public ServiceHandle(IntPtr handle, bool ownsHandle = true) : base(handle, ownsHandle) { Destroy = DestroyHandle; }
+        public ServiceHandle(IntPtr handle, bool ownsHandle = true) : base(handle, ownsHandle) { Destroy = Service.Destroy; }
     }
 }
index c506647..9e23a38 100755 (executable)
@@ -161,8 +161,6 @@ internal static partial class Interop
 
     internal class ViewHandle : SafeMapsHandle
     {
-        internal ErrorCode DestroyHandle(IntPtr handle) { return Service.Destroy(handle); }
-
-        public ViewHandle(IntPtr handle, bool ownsHandle = true) : base(handle, ownsHandle) { Destroy = DestroyHandle; }
+        public ViewHandle(IntPtr handle, bool ownsHandle = true) : base(handle, ownsHandle) { Destroy = View.Destroy; }
     }
 }
index 2dc0f30..dbddb36 100755 (executable)
@@ -56,7 +56,6 @@
     <Compile Include="Tizen.Maps\MapGestureEventArgs.cs" />
     <Compile Include="Tizen.Maps\MapObjectEventArgs.cs" />
     <Compile Include="Tizen.Maps\MapObject.cs" />
-    <Compile Include="Tizen.Maps\MapObjectType.cs" />
     <Compile Include="Tizen.Maps\MapTypes.cs" />
     <Compile Include="Tizen.Maps\Marker.cs" />
     <Compile Include="Interop\Interop.Address.cs" />
index b0220c1..b5fd579 100755 (executable)
@@ -61,7 +61,6 @@
     <Compile Include="Tizen.Maps\MapGestureEventArgs.cs" />
     <Compile Include="Tizen.Maps\MapObjectEventArgs.cs" />
     <Compile Include="Tizen.Maps\MapObject.cs" />
-    <Compile Include="Tizen.Maps\MapObjectType.cs" />
     <Compile Include="Tizen.Maps\MapTypes.cs" />
     <Compile Include="Tizen.Maps\Marker.cs" />
     <Compile Include="Interop\Interop.Address.cs" />
index 4a9ca08..f81f659 100755 (executable)
  * limitations under the License.
  */
 
-using System;
-
 namespace Tizen.Maps
 {
-    [Flags]
+    /// <summary>
+    /// Enumeration of user gestures over map view
+    /// </summary>
     public enum GestureType
     {
+        /// <summary>
+        /// Indicates empty gesture
+        /// </summary>
         None = Interop.ViewGesture.None,
+        /// <summary>
+        /// Indicates the move map user gesture
+        /// </summary>
         Scroll = Interop.ViewGesture.Scroll,
+        /// <summary>
+        /// Indicates the zoom user gesture
+        /// </summary>
         Zoom = Interop.ViewGesture.Zoom,
+        /// <summary>
+        /// Indicates the tap user gesture
+        /// </summary>
         Tap = Interop.ViewGesture.Tap,
+        /// <summary>
+        /// Indicates the double tap user gesture
+        /// </summary>
         DoubleTap = Interop.ViewGesture.DoubleTap,
+        /// <summary>
+        /// Indicates the two-finger tap user gesture
+        /// </summary>
         TwoFingerTap = Interop.ViewGesture.TwoFingerTap,
+        /// <summary>
+        ///  Indicates the rotation user gesture
+        /// </summary>
         Rotate = Interop.ViewGesture.Rotate,
+        /// <summary>
+        /// Indicates the long press user gesture
+        /// </summary>
         LongPress = Interop.ViewGesture.LongPress,
     }
 }
\ No newline at end of file
index 8cccd8f..4b31650 100755 (executable)
@@ -19,6 +19,9 @@ using ElmSharp;
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Event arguments for gesture type map events
+    /// </summary>
     public class MapGestureEventArgs : EventArgs
     {
         internal static MapGestureEventArgs Create(IntPtr nativeHandle)
@@ -52,11 +55,34 @@ namespace Tizen.Maps
             RotationAngle = rotationAngle;
         }
 
+        /// <summary>
+        /// Type of gesture event
+        /// </summary>
         public GestureType GestureType { get; }
+
+        /// <summary>
+        /// Screen coordinates for the event
+        /// </summary>
         public Point Position { get; }
+
+        /// <summary>
+        /// Number of fingers detected in the event
+        /// </summary>
         public int TouchCount { get; }
+
+        /// <summary>
+        /// Zoom factor for zoom gesture event
+        /// </summary>
         public double ZoomFactor { get; }
+
+        /// <summary>
+        /// Angle of rotation for rotate gesture event
+        /// </summary>
         public double RotationAngle { get; }
+
+        /// <summary>
+        /// Geo-coordinates for the event
+        /// </summary>
         public Geocoordinates Geocoordinates { get; }
     }
 }
index 8b761b4..200b84c 100755 (executable)
@@ -29,8 +29,15 @@ namespace Tizen.Maps
             handle = nativeHandle;
         }
 
+
+        /// <summary>
+        /// Clicked event
+        /// </summary>
         public event EventHandler Clicked;
 
+        /// <summary>
+        /// Map Object's visibility
+        /// </summary>
         public bool IsVisible
         {
             get
index 98317a8..e0af184 100755 (executable)
@@ -46,9 +46,24 @@ namespace Tizen.Maps
             ViewObject = mapObject;
         }
 
+        /// <summary>
+        /// Type of gesture event
+        /// </summary>
         public GestureType GestureType { get; }
+
+        /// <summary>
+        /// Screen coordinates for the event
+        /// </summary>
         public Point Position { get; }
+
+        /// <summary>
+        /// Number of fingers detected in the event
+        /// </summary>
         public int TouchCount { get; }
+
+        /// <summary>
+        /// Map Object on which event has occurred
+        /// </summary>
         public MapObject ViewObject { get; }
     }
 }
diff --git a/src/Tizen.Maps/Tizen.Maps/MapObjectType.cs b/src/Tizen.Maps/Tizen.Maps/MapObjectType.cs
deleted file mode 100755 (executable)
index ab491d5..0000000
+++ /dev/null
@@ -1,26 +0,0 @@
-/*
- * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
- *
- * Licensed under the Apache License, Version 2.0 (the License);
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an AS IS BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-namespace Tizen.Maps
-{
-    internal enum MapObjectType
-    {
-        Marker,
-        Overlay,
-        Polygon,
-        Polyline,
-    }
-}
\ No newline at end of file
index 06b3cba..fbc3525 100755 (executable)
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Map View Type (theme)
+    /// </summary>
     public enum MapTypes
     {
+        /// <summary>
+        /// Normal street theme
+        /// </summary>
         Normal = Interop.ViewType.Normal,
+        /// <summary>
+        /// Satellite theme
+        /// </summary>
         Satellite = Interop.ViewType.Satellite,
+        /// <summary>
+        /// Terrain theme
+        /// </summary>
         Terrain = Interop.ViewType.Terrain,
+        /// <summary>
+        /// Hybrid theme, has both satellite and normal theme
+        /// </summary>
         Hybrid = Interop.ViewType.Hybrid,
     }
 }
\ No newline at end of file
index a37301d..bf7f3df 100755 (executable)
@@ -22,6 +22,9 @@ using System.Collections.Generic;
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Map View
+    /// </summary>
     public class MapView : Layout
     {
         internal Interop.ViewHandle handle;
@@ -42,6 +45,11 @@ namespace Tizen.Maps
         private event EventHandler<MapGestureEventArgs> _longPressedEventHandler;
         private event EventHandler _viewReadyEventHandler;
 
+        /// <summary>
+        /// Creates the View and link it to the instance of map service
+        /// </summary>
+        /// <param name="parent">The evas object to be drawn</param>
+        /// <param name="service">Map service</param>
         public MapView(EvasObject parent, MapService service) : base(parent)
         {
             IntPtr nativeHandle;
@@ -58,6 +66,9 @@ namespace Tizen.Maps
             SetObjectEventCallback();
         }
 
+        /// <summary>
+        /// Scrolled gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> Scrolled
         {
             add
@@ -77,6 +88,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// ZoomChanged gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> ZoomChanged
         {
             add
@@ -96,6 +110,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Clicked gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> Clicked
         {
             add
@@ -115,6 +132,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// DoubleClicked gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> DoubleClicked
         {
             add
@@ -134,6 +154,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// TwoFingerPressed gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> TwoFingerPressed
         {
             add
@@ -153,6 +176,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Rotated gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> Rotated
         {
             add
@@ -172,6 +198,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// LongPressed gesture event
+        /// </summary>
         public event EventHandler<MapGestureEventArgs> LongPressed
         {
             add
@@ -191,6 +220,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// ViewReady gesture event
+        /// </summary>
         public event EventHandler ViewReady
         {
             add
@@ -205,6 +237,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Map View's current zoom level
+        /// </summary>
         public int ZoomLevel
         {
             get
@@ -219,6 +254,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Minimum zoom level for map view
+        /// </summary>
         public int MinimumZoomLevel
         {
             get
@@ -233,6 +271,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Maximum zoom level for map view
+        /// </summary>
         public int MaximumZoomLevel
         {
             get
@@ -247,6 +288,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// orientation on the View [0 ~ 360 degrees]
+        /// </summary>
         public double Orientation
         {
             get
@@ -261,6 +305,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Map view type (theme)
+        /// </summary>
         public MapTypes MapType
         {
             get
@@ -275,6 +322,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Indicates whether the map should show the 3D buildings layer
+        /// </summary>
         public bool BuildingsEnabled
         {
             get
@@ -289,6 +339,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Indicates whether the map should show the traffic layer
+        /// </summary>
         public bool TrafficEnabled
         {
             get
@@ -303,6 +356,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Indicates whether the map should show the public transit layer
+        /// </summary>
         public bool PublicTransitEnabled
         {
             get
@@ -317,6 +373,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Gets whether the scale-bar is enabled or not
+        /// </summary>
         public bool ScalebarEnabled
         {
             get
@@ -331,6 +390,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Map view's language
+        /// </summary>
         public string Language
         {
             get
@@ -345,6 +407,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Geographical coordinates for map view's center
+        /// </summary>
         public Geocoordinates Center
         {
             get
@@ -360,6 +425,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// List of map object added to map view
+        /// </summary>
         public IEnumerable<MapObject> Children
         {
             get
@@ -368,6 +436,11 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Changes geographical coordinates to screen coordinates
+        /// </summary>
+        /// <param name="coordinates">Geographical coordinates</param>
+        /// <returns></returns>
         public Point GeolocationToScreen(Geocoordinates coordinates)
         {
             Point screenCoordinates = new Point();
@@ -376,6 +449,11 @@ namespace Tizen.Maps
             return screenCoordinates;
         }
 
+        /// <summary>
+        /// Changes screen coordinates to geographical coordinates
+        /// </summary>
+        /// <param name="screenCoordinates">screen coordinates</param>
+        /// <returns></returns>
         public Geocoordinates ScreenToGeolocation(Point screenCoordinates)
         {
             IntPtr coordinateHandle;
@@ -383,6 +461,10 @@ namespace Tizen.Maps
             return new Geocoordinates(coordinateHandle);
         }
 
+        /// <summary>
+        /// Adds map object to map view
+        /// </summary>
+        /// <param name="child">map object to add</param>
         public void Add(MapObject child)
         {
             child.handle.ReleaseOwnership();
@@ -391,6 +473,10 @@ namespace Tizen.Maps
             Interop.View.AddObject(handle, child.handle);
         }
 
+        /// <summary>
+        /// Removes map object from map view
+        /// </summary>
+        /// <param name="child">map object to remove</param>
         public void Remove(MapObject child)
         {
             _children.Remove(child);
@@ -398,6 +484,9 @@ namespace Tizen.Maps
             Interop.View.RemoveObject(handle, child.handle);
         }
 
+        /// <summary>
+        /// Removes all map objects from map view
+        /// </summary>
         public void RemoveAll()
         {
             foreach (var child in _children)
@@ -408,6 +497,12 @@ namespace Tizen.Maps
             Interop.View.RemoveAllObjects(handle);
         }
 
+        /// <summary>
+        /// Captures a snapshot of the Map View
+        /// </summary>
+        /// <param name="type">type of file format</param>
+        /// <param name="quality">quality for encoding (1~100) </param>
+        /// <param name="path">The file path for snapshot</param>
         public void CaptureSnapshot(SnapshotType type, int quality, string path)
         {
             var err = Interop.ViewSnapshot.ViewCaptureSnapshot(handle, (Interop.ViewSnapshotFormatType)type, quality, path);
index 27090e5..f12c728 100755 (executable)
@@ -19,6 +19,9 @@ using ElmSharp;
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Marker map object
+    /// </summary>
     public class Marker : MapObject
     {
         internal Marker(Interop.ViewObjectHandle nativeHandle) : base(nativeHandle)
@@ -34,6 +37,11 @@ namespace Tizen.Maps
             }
         }
 
+        // TODO: Need to rename all Geocoordinates type property to Coordinates and all screen coordinates to Position
+
+        /// <summary>
+        /// Geographical coordinates for marker
+        /// </summary>
         public Geocoordinates Position
         {
             get
@@ -58,6 +66,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Image file path for marker
+        /// </summary>
         public string ImagePath
         {
             get
@@ -72,6 +83,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Screen size for marker
+        /// </summary>
         public Size MarkerSize
         {
             get
@@ -86,6 +100,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Z-order for marker
+        /// </summary>
         public int ZOrder
         {
             get
@@ -100,11 +117,19 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Changes marker size
+        /// </summary>
+        /// <param name="newSize">New size</param>
         public void Resize(Size newSize)
         {
             MarkerSize = newSize;
         }
 
+        /// <summary>
+        /// Changes marker coordinates
+        /// </summary>
+        /// <param name="newPosition">New position for marker</param>
         public void Move(Geocoordinates newPosition)
         {
             Position = newPosition;
@@ -127,15 +152,31 @@ namespace Tizen.Maps
         }
     }
 
+    /// <summary>
+    /// Pin type marker map object
+    /// </summary>
     public class Pin : Marker
     {
+        /// <summary>
+        /// Creates Pin type parker
+        /// </summary>
+        /// <param name="coordinates">Marker coordinates</param>
+        /// <param name="imagePath">Image path</param>
         public Pin(Geocoordinates coordinates, string imagePath) : base(coordinates, imagePath, Interop.ViewMarkerType.Pin)
         {
         }
     }
 
+    /// <summary>
+    /// Sticker type marker map object
+    /// </summary>
     public class Sticker : Marker
     {
+        /// <summary>
+        /// Creates Sticker type parker
+        /// </summary>
+        /// <param name="coordinates">Marker coordinates</param>
+        /// <param name="imagePath">Image path</param>
         public Sticker(Geocoordinates coordinates, string imagePath) : base(coordinates, imagePath, Interop.ViewMarkerType.Sticker)
         {
         }
index 1540e0c..1d73b00 100755 (executable)
@@ -19,10 +19,18 @@ using EvasObject = ElmSharp.EvasObject;
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Overlay map object
+    /// </summary>
     public class Overlay : MapObject
     {
         private EvasObject _containedObject;
 
+        /// <summary>
+        /// Creates normal overlay map object
+        /// </summary>
+        /// <param name="coordinates"></param>
+        /// <param name="objectToContain"></param>
         public Overlay(Geocoordinates coordinates, EvasObject objectToContain) : this(coordinates, objectToContain, Interop.ViewOverlayType.Normal)
         {
         }
@@ -42,6 +50,9 @@ namespace Tizen.Maps
             _containedObject = objectToContain;
         }
 
+        /// <summary>
+        /// Geographical coordinates for overlay
+        /// </summary>
         public Geocoordinates Coordinates
         {
             get
@@ -66,6 +77,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Minimum zoom level for overlay
+        /// </summary>
         public int MinimumZoomLevel
         {
             get
@@ -80,6 +94,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Maximum zoom lever for overlay
+        /// </summary>
         public int MaximumZoomLevel
         {
             get
@@ -111,6 +128,9 @@ namespace Tizen.Maps
         }
     }
 
+    /// <summary>
+    /// Bubble overlay map object
+    /// </summary>
     public class BubbleOverlay : Overlay
     {
         public BubbleOverlay(Geocoordinates coordinates, EvasObject objectToContain) : base(coordinates, objectToContain, Interop.ViewOverlayType.Bubble)
@@ -118,8 +138,14 @@ namespace Tizen.Maps
         }
     }
 
+    /// <summary>
+    /// Box Overlay map object
+    /// </summary>
     public class BoxOverlay : Overlay
     {
+        /// <summary>
+        /// Creates Box overlay
+        /// </summary>
         public BoxOverlay(Geocoordinates coordinates, EvasObject objectToContain) : base(coordinates, objectToContain, Interop.ViewOverlayType.Box)
         {
         }
index fd3dd78..2f78c2b 100755 (executable)
@@ -22,10 +22,18 @@ using Color = ElmSharp.Color;
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Polygon map object
+    /// </summary>
     public class Polygon : MapObject
     {
         private List<Geocoordinates> _coordinateList;
 
+        /// <summary>
+        /// Creates a polygon visual object
+        /// </summary>
+        /// <param name="coordinates">list of geographical coordinates</param>
+        /// <param name="color">background color</param>
         public Polygon(IEnumerable<Geocoordinates> coordinates, Color color) : base(CreateNativeHandle(coordinates, color))
         {
             var err = Interop.ErrorCode.InvalidParameter;
@@ -40,6 +48,9 @@ namespace Tizen.Maps
         {
         }
 
+        /// <summary>
+        /// List of geographical coordinates of polygon vertices
+        /// </summary>
         public IEnumerable<Geocoordinates> Coordinates
         {
             get
@@ -74,6 +85,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Background fill color
+        /// </summary>
         public Color FillColor
         {
             get
index e27357f..aaa8dac 100755 (executable)
@@ -22,10 +22,19 @@ using Color = ElmSharp.Color;
 
 namespace Tizen.Maps
 {
+    /// <summary>
+    /// Polyline map object
+    /// </summary>
     public class Polyline : MapObject
     {
         private List<Geocoordinates> _coordinateList;
 
+        /// <summary>
+        /// Creates polyline visual object
+        /// </summary>
+        /// <param name="coordinates">List of geographical coordinates</param>
+        /// <param name="color">Line color</param>
+        /// <param name="width">The width of line [1 ~ 100] (pixels)</param>
         public Polyline(List<Geocoordinates> coordinates, Color color, int width) : base(CreateNativeHandle(coordinates, color, width))
         {
             var err = Interop.ErrorCode.InvalidParameter;
@@ -40,6 +49,9 @@ namespace Tizen.Maps
         {
         }
 
+        /// <summary>
+        /// List of geographical coordinates for polyline vertices
+        /// </summary>
         public IEnumerable<Geocoordinates> Coordinates
         {
             get
@@ -73,6 +85,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// Line color
+        /// </summary>
         public Color LineColor
         {
             get
@@ -87,6 +102,9 @@ namespace Tizen.Maps
             }
         }
 
+        /// <summary>
+        /// line width [1 ~ 100 pixels]
+        /// </summary>
         public int Width
         {
             get