Imported Upstream version 4.6.0.125

Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4

mcs/class/referencesource/System/compmod/system/componentmodel/design/PropertyTabAttribute.cs

@@ -0,0 +1,243 @@
+//------------------------------------------------------------------------------
+// <copyright file="PropertyTabAttribute.cs" company="Microsoft">
+//     Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>                                                                
+//------------------------------------------------------------------------------
+
+// SECREVIEW: Remove this attribute once bug#411903 is fixed.
+[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2113:SecureLateBindingMethods", Scope="member", Target="System.ComponentModel.PropertyTabAttribute.get_TabClasses():System.Type[]")]
+
+namespace System.ComponentModel {
+    
+    using System;
+    using System.ComponentModel;
+    using System.Reflection;
+    using System.Security.Permissions;
+
+    /// <devdoc>
+    ///    <para> Identifies the property tab or tabs that should be displayed for the
+    ///       specified class or classes.</para>
+    /// </devdoc>
+    [AttributeUsage(AttributeTargets.All)]
+    public class PropertyTabAttribute : Attribute {
+        private PropertyTabScope[]  tabScopes;
+        private Type[] tabClasses;
+        private string[] tabClassNames;
+        
+        /// <devdoc>
+        ///    <para>
+        ///       Basic constructor that creates a PropertyTabAttribute.  Use this ctor to derive from this
+        ///       attribute and specify multiple tab types by calling InitializeArrays.
+        ///    </para>
+        /// </devdoc>
+        public PropertyTabAttribute() {
+            tabScopes = new PropertyTabScope[0];
+            tabClassNames = new string[0];
+        }
+
+        /// <devdoc>
+        ///    <para>
+        ///       Basic constructor that creates a property tab attribute that will create a tab
+        ///       of the specified type.
+        ///    </para>
+        /// </devdoc>
+        public PropertyTabAttribute(Type tabClass) : this(tabClass, PropertyTabScope.Component) {
+        }
+
+        /// <devdoc>
+        ///    <para>
+        ///       Basic constructor that creates a property tab attribute that will create a tab
+        ///       of the specified type.
+        ///    </para>
+        /// </devdoc>
+        public PropertyTabAttribute(string tabClassName) : this(tabClassName, PropertyTabScope.Component) {
+        }
+
+        /// <devdoc>
+        ///    <para>
+        ///       Basic constructor that creates a property tab attribute that will create a tab
+        ///       of the specified type.
+        ///    </para>
+        /// </devdoc>
+        public PropertyTabAttribute(Type tabClass, PropertyTabScope tabScope) {
+        
+            this.tabClasses = new Type[]{ tabClass};
+            if (tabScope < PropertyTabScope.Document) {
+                throw new ArgumentException(SR.GetString(SR.PropertyTabAttributeBadPropertyTabScope), "tabScope");
+            }
+            this.tabScopes  = new PropertyTabScope[]{tabScope};
+
+        }
+
+        
+        /// <devdoc>
+        ///    <para>
+        ///       Basic constructor that creates a property tab attribute that will create a tab
+        ///       of the specified type.
+        ///    </para>
+        /// </devdoc>
+        public PropertyTabAttribute(string tabClassName, PropertyTabScope tabScope) {
+            this.tabClassNames = new string[]{ tabClassName};
+            if (tabScope < PropertyTabScope.Document) {
+                throw new ArgumentException(SR.GetString(SR.PropertyTabAttributeBadPropertyTabScope), "tabScope");
+            }
+            this.tabScopes  = new PropertyTabScope[]{tabScope};
+        }
+
+        /// <devdoc>
+        ///    <para>Gets the types of tab that this attribute specifies.</para>
+        /// </devdoc>
+        public Type[] TabClasses {
+            get {
+                if (tabClasses == null && tabClassNames != null) {
+                    tabClasses = new Type[tabClassNames.Length];
+                    for (int i=0; i<tabClassNames.Length; i++) {
+                    
+                        int commaIndex = tabClassNames[i].IndexOf(',');
+                        string className = null;
+                        string assemblyName = null;
+                        
+                        if (commaIndex != -1) {
+                            className = tabClassNames[i].Substring(0, commaIndex).Trim();
+                            assemblyName = tabClassNames[i].Substring(commaIndex + 1).Trim();
+                        }
+                        else {
+                            className = tabClassNames[i];
+                        }
+                        
+                        tabClasses[i] = Type.GetType(className, false);
+                        
+                        if (tabClasses[i] == null) {
+                            if (assemblyName != null) {
+                                Assembly a = Assembly.Load(assemblyName);
+                                if (a != null) {
+                                    tabClasses[i] = a.GetType(className, true);
+                                }
+                            }
+                            else {
+                                throw new TypeLoadException(SR.GetString(SR.PropertyTabAttributeTypeLoadException, className));
+                            }
+                        }
+                    }
+                }
+                return tabClasses;
+            }
+        }
+        
+        /// <devdoc>
+        ///    <para>[To be supplied.]</para>
+        /// </devdoc>
+        protected string[] TabClassNames{
+            get {
+                if (tabClassNames != null) {
+                    return (string[])tabClassNames.Clone();
+                }
+                else {
+                    return null;
+                }
+            }
+        }
+
+        /// <devdoc>
+        /// <para>Gets the scopes of tabs for this System.ComponentModel.Design.PropertyTabAttribute, from System.ComponentModel.Design.PropertyTabScope.</para>
+        /// </devdoc>
+        public PropertyTabScope[] TabScopes {
+            get {
+                return tabScopes;
+            }
+        }
+              /// <internalonly/>
+        public override bool Equals(object other) {
+            if (other is PropertyTabAttribute) {
+                return Equals((PropertyTabAttribute)other);
+            }
+            return false;
+        }
+
+        /// <internalonly/>
+        public bool Equals(PropertyTabAttribute other) {
+            if (other == (object)this) {
+                return true;
+            }
+            if (other.TabClasses.Length != TabClasses.Length ||
+                other.TabScopes.Length != TabScopes.Length) {
+                return false;
+            }
+
+            for (int i = 0; i < TabClasses.Length; i++) {
+                if (TabClasses[i] != other.TabClasses[i] ||
+                    TabScopes[i] != other.TabScopes[i]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        
+
+        /// <devdoc>
+        ///    <para>
+        ///       Returns the hashcode for this object.
+        ///    </para>
+        /// </devdoc>
+        public override int GetHashCode() {
+            return base.GetHashCode();
+        }
+        
+        /// <devdoc>
+        ///    <para>
+        ///       Utiliity function to set the types of tab classes this PropertyTabAttribute specifies.
+        ///    </para>
+        /// </devdoc>
+        protected void InitializeArrays(string[] tabClassNames, PropertyTabScope[] tabScopes) {
+            InitializeArrays(tabClassNames, null, tabScopes);
+        }
+        
+        /// <devdoc>
+        ///    <para>
+        ///       Utiliity function to set the types of tab classes this PropertyTabAttribute specifies.
+        ///    </para>
+        /// </devdoc>
+        protected void InitializeArrays(Type[] tabClasses, PropertyTabScope[] tabScopes) {
+            InitializeArrays(null, tabClasses, tabScopes);
+        }
+        
+        
+        private void InitializeArrays(string[] tabClassNames, Type[] tabClasses, PropertyTabScope[] tabScopes) {
+        
+            if (tabClasses != null) {
+                if (tabScopes != null && tabClasses.Length != tabScopes.Length) {
+                    throw new ArgumentException(SR.GetString(SR.PropertyTabAttributeArrayLengthMismatch));
+                }
+                this.tabClasses = (Type[])tabClasses.Clone();
+            }
+            else if (tabClassNames != null) {
+                if (tabScopes != null && tabClasses.Length != tabScopes.Length) {
+                    throw new ArgumentException(SR.GetString(SR.PropertyTabAttributeArrayLengthMismatch));
+                }
+                this.tabClassNames = (string[])tabClassNames.Clone();
+                this.tabClasses = null;
+            }
+            else if (this.tabClasses == null && this.tabClassNames == null) {
+                throw new ArgumentException(SR.GetString(SR.PropertyTabAttributeParamsBothNull));
+            }
+            
+            if (tabScopes != null) {
+                for (int i = 0; i < tabScopes.Length; i++) {
+                    if (tabScopes[i] < PropertyTabScope.Document) {
+                        throw new ArgumentException(SR.GetString(SR.PropertyTabAttributeBadPropertyTabScope));
+                    }
+                }
+                this.tabScopes = (PropertyTabScope[])tabScopes.Clone();
+            }
+            else {
+                this.tabScopes = new PropertyTabScope[tabClasses.Length];
+
+                for (int i = 0; i < TabScopes.Length; i++) {
+                    this.tabScopes[i] = PropertyTabScope.Component;
+                }
+            }
+        }
+    }
+}
+
+