EditorAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

netstandard.dll, System.ComponentModel.Primitives.dll

Origine:

EditorAttribute.cs

Specifica l'editor da utilizzare per modificare una proprietà. Questa classe non può essere ereditata.

public ref class EditorAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=true, Inherited=true)]
public sealed class EditorAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=true, Inherited=true)>]
type EditorAttribute = class
    inherit Attribute

Public NotInheritable Class EditorAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

EditorAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene creata la MyImage classe . La classe è contrassegnata con un EditorAttribute oggetto che specifica l'oggetto ImageEditor come editor.

[Editor("System.Windows.Forms.ImageEditorIndex, System.Design",
UITypeEditor::typeid)]
public ref class MyImage{
   // Insert code here.
};

[Editor("System.Windows.Forms.ImageEditorIndex, System.Design",
    typeof(UITypeEditor))]

public class MyImage
{
    // Insert code here.
}

<Editor("System.Windows.Forms.ImageEditorIndex, System.Design", _
    GetType(UITypeEditor))> _
Public Class MyImage
    ' Insert code here.
End Class

Nell'esempio di codice seguente viene creata un'istanza della MyImage classe , vengono recuperati gli attributi per la classe e quindi viene stampato il nome dell'editor utilizzato da myNewImage.

int main()
{
   // Creates a new component.
   MyImage^ myNewImage = gcnew MyImage;

   // Gets the attributes for the component.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewImage );

   /* Prints the name of the editor by retrieving the EditorAttribute 
       * from the AttributeCollection. */
   EditorAttribute^ myAttribute = dynamic_cast<EditorAttribute^>(attributes[ EditorAttribute::typeid ]);
   Console::WriteLine( "The editor for this class is: {0}", myAttribute->EditorTypeName );
   return 0;
}

public static int Main()
{
    // Creates a new component.
    MyImage myNewImage = new();

    // Gets the attributes for the component.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewImage);

    /* Prints the name of the editor by retrieving the EditorAttribute 
     * from the AttributeCollection. */

    EditorAttribute myAttribute = (EditorAttribute)attributes[typeof(EditorAttribute)];
    Console.WriteLine("The editor for this class is: " + myAttribute.EditorTypeName);

    return 0;
}

Public Shared Sub Main()
    ' Creates a new component.
    Dim myNewImage As New MyImage()
    
    ' Gets the attributes for the component.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewImage)
    
    ' Prints the name of the editor by retrieving the EditorAttribute
    ' from the AttributeCollection. 
    
    Dim myAttribute As EditorAttribute = CType(attributes(GetType(EditorAttribute)), EditorAttribute)
    Console.WriteLine(("The editor for this class is: " & myAttribute.EditorTypeName))

End Sub

Commenti

Quando si modifica la proprietà, una finestra di progettazione visiva deve creare una nuova istanza dell'editor specificato tramite una finestra di dialogo o una finestra a discesa.

Utilizzare la EditorBaseTypeName proprietà per trovare il tipo di base dell'editor. L'unico tipo di base disponibile è UITypeEditor.

Utilizzare la EditorTypeName proprietà per ottenere il nome del tipo di editor associato a questo attributo.

Per informazioni generali sull'uso degli attributi. vedere Attributi. Per altre informazioni sugli attributi in fase di progettazione, vedere Attributi e supporto Design-Time.

Costruttori

Nome	Descrizione
EditorAttribute()	Inizializza una nuova istanza della EditorAttribute classe con l'editor predefinito, che non è un editor.
EditorAttribute(String, String)	Inizializza una nuova istanza della EditorAttribute classe con il nome del tipo e il nome del tipo di base dell'editor.
EditorAttribute(String, Type)	Inizializza una nuova istanza della EditorAttribute classe con il nome del tipo e il tipo di base.
EditorAttribute(Type, Type)	Inizializza una nuova istanza della EditorAttribute classe con il tipo e il tipo di base.

Proprietà

Nome	Descrizione
EditorBaseTypeName	Ottiene il nome della classe o dell'interfaccia di base che funge da chiave di ricerca per questo editor.
EditorTypeName	Ottiene il nome della classe dell'editor nel AssemblyQualifiedName formato .
TypeId	Ottiene un ID univoco per questo tipo di attributo.

Metodi

Nome	Descrizione
Equals(Object)	Restituisce un valore che indica se il valore dell'oggetto specificato è uguale all'oggetto corrente EditorAttribute.
GetHashCode()	Restituisce il codice hash per questa istanza.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)