DesignerAttribute Class

Definition

Specifica la classe usata per implementare i servizi in fase di progettazione per un componente.Specifies the class used to implement design-time services for a component.

public ref class DesignerAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true, Inherited=true)]
public sealed class DesignerAttribute : Attribute
type DesignerAttribute = class
    inherit Attribute
Public NotInheritable Class DesignerAttribute
Inherits Attribute
Inheritance
DesignerAttribute
Attributes

Examples

Nell'esempio seguente viene creata una classe denominata MyForm.The following example creates a class called MyForm. MyForm dispone di due attributi, un DesignerAttribute che specifica che questa classe utilizza il DocumentDesignere un DesignerCategoryAttribute che specifica la categoria di Form.MyForm has two attributes, a DesignerAttribute that specifies this class uses the DocumentDesigner, and a DesignerCategoryAttribute that specifies the Form category.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL",
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};
[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL", 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]
public class MyForm : ContainerControl {
    // Insert code here.
}
<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL", _
    GetType(IRootDesigner)), DesignerCategory("Form")> _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class

Nell'esempio seguente viene creata un'istanza di MyForm.The next example creates an instance of MyForm. Ottiene quindi gli attributi per la classe, estrae il DesignerAttributee stampa il nome della finestra di progettazione.Then it gets the attributes for the class, extracts the DesignerAttribute, and prints the name of the designer.

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the DesignerAttribute
       * from the AttributeCollection. */
   DesignerAttribute^ myAttribute = dynamic_cast<DesignerAttribute^>(attributes[ DesignerAttribute::typeid ]);
   Console::WriteLine( "The designer for this class is: {0}", myAttribute->DesignerTypeName );
   return 0;
}
public static int Main() {
    // Creates a new form.
    MyForm myNewForm = new MyForm();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);
 
    /* Prints the name of the designer by retrieving the DesignerAttribute
     * from the AttributeCollection. */
    DesignerAttribute myAttribute = 
       (DesignerAttribute)attributes[typeof(DesignerAttribute)];
    Console.WriteLine("The designer for this class is: " + myAttribute.DesignerTypeName);
  
    return 0;
}
Public Shared Function Main() As Integer
    ' Creates a new form.
    Dim myNewForm As New MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the DesignerAttribute
    ' from the AttributeCollection. 
    Dim myAttribute As DesignerAttribute = _
        CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    Console.WriteLine(("The designer for this class is: " & myAttribute.DesignerTypeName))
    
    Return 0
End Function 'Main

Remarks

La classe utilizzata per i servizi della fase di progettazione deve implementare l'interfaccia IDesigner.The class you use for the design-time services must implement the IDesigner interface.

Utilizzare la proprietà DesignerBaseTypeName per trovare il tipo di base della finestra di progettazione.Use the DesignerBaseTypeName property to find the designer's base type. Utilizzare la proprietà DesignerTypeName per ottenere il nome del tipo di finestra di progettazione associato a questo membro.Use the DesignerTypeName property to get the name of the type of designer associated with this member.

Per altre informazioni, vedere Attributi.For more information, see Attributes.

Constructors

DesignerAttribute(String)

Consente di inizializzare una nuova istanza della classe DesignerAttribute utilizzando il nome del tipo che fornisce i servizi in fase di progettazione.Initializes a new instance of the DesignerAttribute class using the name of the type that provides design-time services.

DesignerAttribute(String, String)

Consente di inizializzare una nuova istanza della classe DesignerAttribute utilizzando il tipo e la classe base della finestra di progettazione.Initializes a new instance of the DesignerAttribute class using the designer type and the base class for the designer.

DesignerAttribute(String, Type)

Consente di inizializzare una nuova istanza della classe DesignerAttribute utilizzando il nome della classe e la classe base della finestra di progettazione.Initializes a new instance of the DesignerAttribute class, using the name of the designer class and the base class for the designer.

DesignerAttribute(Type)

Consente di inizializzare una nuova istanza della classe DesignerAttribute utilizzando il tipo che fornisce i servizi in fase di progettazione.Initializes a new instance of the DesignerAttribute class using the type that provides design-time services.

DesignerAttribute(Type, Type)

Consente di inizializzare una nuova istanza della classe DesignerAttribute utilizzando i tipi e la classe base della finestra di progettazione.Initializes a new instance of the DesignerAttribute class using the types of the designer and designer base class.

Properties

DesignerBaseTypeName

Ottiene il nome del tipo di base per questa finestra di progettazione.Gets the name of the base type of this designer.

DesignerTypeName

Ottiene il nome del tipo di finestra di progettazione associato a questo attributo della finestra di progettazione.Gets the name of the designer type associated with this designer attribute.

TypeId

Ottiene un ID univoco per questo tipo di attributo.Gets a unique ID for this attribute type.

Methods

Equals(Object)

Specifica se il valore dell'oggetto specificato è uguale all'oggetto DesignerAttribute corrente.Returns whether the value of the given object is equal to the current DesignerAttribute.

GetHashCode()

Restituisce il codice hash relativo a questa istanza.Returns the hash code for this instance.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to

See also