Imported Upstream version 5.4.0.167

Former-commit-id: 5624ac747d633e885131e8349322922b6a59baaa

mcs/class/referencesource/System.Web.DataVisualization/Common/General/NamedImageCollection.cs

@@ -0,0 +1,175 @@
+//-------------------------------------------------------------
+// <copyright company=<3D>Microsoft Corporation<6F>>
+//   Copyright <20> Microsoft Corporation. All Rights Reserved.
+// </copyright>
+//-------------------------------------------------------------
+// @owner=alexgor, deliant
+//=================================================================
+//  File:		NamedImagesCollection.cs
+//
+//  Namespace:	System.Windows.Forms.DataVisualization.Charting.ChartTypes
+//
+//	Classes:	NamedImagesCollection, NamedImage
+//
+//  Purpose:	Every property in the chart references images by names. 
+//              This means that you can set MarkerImage property to a 
+//              full image path or URL. In case when the user wants to 
+//              dynamically generate an image or load it from other 
+//              location (like database) you can use named image 
+//              collection which is exposed as Images property of the 
+//              chart. Any Image can be added to this collection with 
+//              unique name and than this name can be used in all the 
+//              chart properties which require image names.
+//
+//	Reviewed:	AG - Microsoft 14, 2007
+//
+//===================================================================
+
+#region Used namespaces
+
+using System;
+using System.Collections;
+using System.Drawing;
+using System.ComponentModel;
+using System.Globalization;
+using System.Reflection;
+using System.ComponentModel.Design.Serialization;
+
+#endregion
+
+#if Microsoft_CONTROL
+	namespace System.Windows.Forms.DataVisualization.Charting
+#else
+    namespace System.Web.UI.DataVisualization.Charting
+#endif
+{
+	/// <summary>
+    /// The NamedImagesCollection class is a strongly typed collection of NamedImage
+    /// objects.
+	/// </summary>
+#if ASPPERM_35
+	[AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
+        [AspNetHostingPermission(System.Security.Permissions.SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
+#endif
+    public class NamedImagesCollection : ChartNamedElementCollection<NamedImage>
+	{
+		#region Constructor
+
+		/// <summary>
+		/// Constructor
+		/// </summary>
+		internal NamedImagesCollection() : base(null)
+		{
+		}
+
+        #endregion
+
+	}
+
+	/// <summary>
+	/// The NamedImage class stores a single Image with its unique name.
+	/// </summary>
+	[
+		SRDescription("DescriptionAttributeNamedImage_NamedImage"),
+		DefaultProperty("Name"),
+	]
+#if ASPPERM_35
+	[AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
+        [AspNetHostingPermission(System.Security.Permissions.SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
+#endif
+    public class NamedImage : ChartNamedElement
+	{
+		#region Fields
+
+		private	string _name  = string.Empty;
+		private System.Drawing.Image _image = null;
+
+		#endregion
+
+		#region Constructor
+
+		/// <summary>
+        /// NamedImage constructor.
+		/// </summary>
+		public NamedImage()
+		{
+		}
+
+		/// <summary>
+        /// NamedImage constructor.
+		/// </summary>
+		/// <param name="name">Image name.</param>
+		/// <param name="image">Image object.</param>
+        public NamedImage(string name, System.Drawing.Image image)
+		{
+			this._name = name;
+            this._image = image;
+		}
+
+		#endregion
+
+		#region Properties
+
+		/// <summary>
+		/// Gets or sets the image name.
+		/// </summary>
+		[
+		Bindable(false),
+		SRDescription("DescriptionAttributeNamedImage_Name"),
+		]
+		public override string Name
+		{
+			get
+			{
+				return _name;
+			}
+			set
+			{
+				_name = value;
+			}
+		}
+
+		/// <summary>
+		/// Gets or sets the image object.
+		/// </summary>
+		[
+		Bindable(false),
+		SRDescription("DescriptionAttributeNamedImage_Image"),
+		]
+		public System.Drawing.Image Image
+		{
+			get
+			{
+                return _image;
+			}
+			set
+			{
+                _image = value;
+			}
+		}
+
+		#endregion
+
+
+        #region IDisposable Members
+        /// <summary>
+        /// Releases unmanaged and - optionally - managed resources
+        /// </summary>
+        /// <param name="disposing"><c>true</c> to release both managed and unmanaged resources; <c>false</c> to release only unmanaged resources.</param>
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing)
+            {
+                // Dispose managed resources
+                if (_image != null)
+                {
+                    _image.Dispose();
+                    _image = null;
+                }
+            }
+            base.Dispose(disposing);
+        }
+
+        #endregion
+	}
+}