|
//------------------------------------------------------------------------------
// <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;
}
}
}
}
}
|