IDesigner Interfész

Definíció

Névtér:

System.ComponentModel.Design

Szerelvények:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Forrás:

IDesigner.cs

Az egyéni tervezők létrehozásának alapszintű keretrendszerét biztosítja.

public interface class IDesigner : IDisposable

public interface IDesigner : IDisposable

type IDesigner = interface
    interface IDisposable

Public Interface IDesigner
Implements IDisposable

Származtatott

System.ComponentModel.Design.IRootDesigner

System.ComponentModel.Design.ITreeDesigner

System.Web.UI.Design.WebFormsRootDesigner

System.Workflow.ComponentModel.Design.ActivityDesigner

System.Workflow.ComponentModel.Design.IWorkflowRootDesigner

Megvalósítás

IDisposable

Példák

Ez a példa egy IDesigner olyan implementációt mutat be, amely helyi hivatkozást tárol az összetevőre, végrehajt egy alapértelmezett műveletet, amikor az összetevőre duplán kattint, és egy tervezői parancsot ad meg.

#using <System.Windows.Forms.dll>
#using <System.Data.dll>
#using <System.Drawing.dll>
#using <System.dll>

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Drawing;
using namespace System::Data;
using namespace System::Windows::Forms;
using namespace System::Security::Permissions;

public ref class ExampleIDesigner: public System::ComponentModel::Design::IDesigner
{
private:

   // Local reference to the designer's component.
   IComponent^ component;

public:

   property System::ComponentModel::IComponent^ Component 
   {
      // Public accessor to the designer's component.
      virtual System::ComponentModel::IComponent^ get()
      {
         return component;
      }
   }
   ExampleIDesigner(){}

   virtual void Initialize( System::ComponentModel::IComponent^ component )
   {
      // This method is called after a designer for a component is created,
      // and stores a reference to the designer's component.
      this->component = component;
   }

   // This method peforms the 'default' action for the designer. The default action 
   // for a basic IDesigner implementation is invoked when the designer's component 
   // is double-clicked. By default, a component associated with a basic IDesigner 
   // implementation is displayed in the design-mode component tray.
   virtual void DoDefaultAction()
   {
      // Shows a message box indicating that the default action for the designer was invoked.
      MessageBox::Show( "The DoDefaultAction method of an IDesigner implementation was invoked.", "Information" );
   }

   property System::ComponentModel::Design::DesignerVerbCollection^ Verbs 
   {
      // Returns a collection of designer verb menu items to show in the 
      // shortcut menu for the designer's component.
      [PermissionSetAttribute(SecurityAction::Demand, Name="FullTrust")]
      virtual System::ComponentModel::Design::DesignerVerbCollection^ get()
      {
         DesignerVerbCollection^ verbs = gcnew DesignerVerbCollection;
         DesignerVerb^ dv1 = gcnew DesignerVerb( "Display Component Name",gcnew EventHandler( this, &ExampleIDesigner::ShowComponentName ) );
         verbs->Add( dv1 );
         return verbs;
      }
   }

private:

   // Event handler for displaying a message box showing the designer's component's name.
   void ShowComponentName( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      if ( this->Component != nullptr )
            MessageBox::Show( this->Component->Site->Name, "Designer Component's Name" );
   }

public:

   // Provides an opportunity to release resources before object destruction.
   ~ExampleIDesigner(){}

};

// A DesignerAttribute associates the example IDesigner with an example control.

[DesignerAttribute(ExampleIDesigner::typeid)]
public ref class TestControl: public System::Windows::Forms::UserControl
{
public:
   TestControl(){}

};

using System;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Data;
using System.Windows.Forms;

namespace IDesignerExample
{	
    // A DesignerAttribute associates the example IDesigner with an example control.
    [DesignerAttribute(typeof(ExampleIDesigner))]
    public class TestControl : System.Windows.Forms.UserControl
    {				
        public TestControl()
        {	
        }
    }

    public class ExampleIDesigner : System.ComponentModel.Design.IDesigner
    {
        // Local reference to the designer's component.
        private IComponent component; 
        // Public accessor to the designer's component.
        public System.ComponentModel.IComponent Component
        {
            get
            {
                return component;
            }            
        }

        public ExampleIDesigner()
        {            
        }

        public void Initialize(System.ComponentModel.IComponent component)
        {
            // This method is called after a designer for a component is created,
            // and stores a reference to the designer's component.
            this.component = component;
        }        
        
        // This method peforms the 'default' action for the designer. The default action 
        // for a basic IDesigner implementation is invoked when the designer's component 
        // is double-clicked. By default, a component associated with a basic IDesigner 
        // implementation is displayed in the design-mode component tray.
        public void DoDefaultAction()
        {
            // Shows a message box indicating that the default action for the designer was invoked.
            MessageBox.Show("The DoDefaultAction method of an IDesigner implementation was invoked.", "Information");
        }

        // Returns a collection of designer verb menu items to show in the 
        // shortcut menu for the designer's component.
        public System.ComponentModel.Design.DesignerVerbCollection Verbs
        {
            get
            {
                DesignerVerbCollection verbs = new DesignerVerbCollection();
                DesignerVerb dv1 = new DesignerVerb("Display Component Name", new EventHandler(this.ShowComponentName));
                verbs.Add( dv1 );
                return verbs;
            }
        }

        // Event handler for displaying a message box showing the designer's component's name.
        private void ShowComponentName(object sender, EventArgs e)
        {
            if( this.Component != null )
                MessageBox.Show( this.Component.Site.Name, "Designer Component's Name" );
        }

        // Provides an opportunity to release resources before object destruction.
        public void Dispose()
        {        
        }
    }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Drawing
Imports System.Windows.Forms

' A DesignerAttribute associates the example IDesigner with an example control.
<DesignerAttribute(GetType(ExampleIDesigner))> _
Public Class TestControl
    Inherits System.Windows.Forms.UserControl

    Public Sub New()
    End Sub
End Class

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Public Class ExampleIDesigner
    Implements System.ComponentModel.Design.IDesigner

    ' Local reference to the designer's component.
    Private _component As IComponent

    ' Public accessor to the designer's component.
    Public ReadOnly Property Component() As System.ComponentModel.IComponent Implements IDesigner.Component
        Get
            Return _component
        End Get
    End Property

    Public Sub New()
    End Sub

    Public Sub Initialize(ByVal component As System.ComponentModel.IComponent) Implements IDesigner.Initialize
        ' This method is called after a designer for a component is created,
        ' and stores a reference to the designer's component.
        Me._component = component
    End Sub

    ' This method peforms the 'default' action for the designer. The default action 
    ' for a basic IDesigner implementation is invoked when the designer's component 
    ' is double-clicked. By default, a component associated with a basic IDesigner 
    ' implementation is displayed in the design-mode component tray.
    Public Sub DoDefaultAction() Implements IDesigner.DoDefaultAction
        ' Shows a message box indicating that the default action for the designer was invoked.
        MessageBox.Show("The DoDefaultAction method of an IDesigner implementation was invoked.", "Information")
    End Sub

    ' Returns a collection of designer verb menu items to show in the 
    ' shortcut menu for the designer's component.
    Public ReadOnly Property Verbs() As System.ComponentModel.Design.DesignerVerbCollection Implements IDesigner.Verbs
        Get
            Dim verbs_ As New DesignerVerbCollection()
            Dim dv1 As New DesignerVerb("Display Component Name", New EventHandler(AddressOf Me.ShowComponentName))
            verbs_.Add(dv1)
            Return verbs_
        End Get
    End Property

    ' Event handler for displaying a message box showing the designer's component's name.
    Private Sub ShowComponentName(ByVal sender As Object, ByVal e As EventArgs)
        If (Me.Component IsNot Nothing) Then
            MessageBox.Show(Me.Component.Site.Name, "Designer Component's Name")
        End If
    End Sub

    ' Provides an opportunity to release resources before object destruction.
    Public Sub Dispose() Implements IDisposable.Dispose
    End Sub

End Class

Megjegyzések

Az IDesigner interfész egy felületet biztosít, amelyen keresztül alapvető szolgáltatásokat valósíthat meg a tervezők számára. A tervezők a tervezéskor módosíthatják az összetevők viselkedését, és saját szolgáltatásokat és viselkedést biztosíthatnak. A tervezők csak tervezéskor aktívak, és egy összetevőtípushoz kell társítani, DesignerAttribute hogy betölthetők legyenek, amikor a társított típusú összetevőt a tervezéskor létrehozták.

Az IDesigner interfész olyan módszereket és tulajdonságokat biztosít, amelyeket implementálhat annak érdekében, hogy egyéni viselkedést biztosítson a tervezéskor.

Implementálja a Initialize tervező metódusát a műveletek végrehajtására egy összetevő létrehozásakor. Ez akkor lehet hasznos, ha egy összetevőnek tervezéskor speciális konfigurációval kell rendelkeznie, vagy ha a konfigurációja a tervező által meghatározható feltételektől függően változik.

A tervezők megadhatnak menüparancsokat a helyi menüben, amely akkor jelenik meg, ha a felhasználó a jobb gombbal kattint egy összetevőre vagy vezérlőelemre a tervezési időalapú környezetben. A tulajdonságot implementálva Verbs megadhat egy get kiegészítőt, amely a menüparancsok DesignerVerbCollection létrehozásához használt objektumokat tartalmazó DesignerVerb objektumokat adja vissza.

Az összetevő tálcán megjelenő összetevőinek tervezője az összetevő dupla kattintásával végrehajthat egy alapértelmezett műveletet. Implementálja a DoDefaultAction metódust, amely megadja az összetevő dupla kattintáskor végrehajtandó viselkedését.

A tervezők a rendelkezésre álló tervezési idő szolgáltatásokat is használhatják különféle feladatok elvégzéséhez, beleértve az összetevők és tulajdonságaik aktuális tervezési időkörnyezetének felmérését, az összetevők tulajdonságainak olvasását és beállítását, az eszközkészlet kezelését, a kiválasztott összetevők kezelését, vagy egy olyan felhasználói felület megjelenítését, amely felhasználható értékek konfigurálására vagy további feldolgozásra.

Ha egy űrlapon található vezérlőhöz szeretne tervezőt implementálni, örökölhet az ControlDesigner osztálytól. Azok a vezérlők, amelyekből ControlDesigner a társított tervező nem származik, megjelennek az összetevőtálcában. ComponentDesigner Az ControlDesigner és osztályok implementálják a IDesigner felületet, és további tervezési időt támogató támogatást nyújtanak, amelyet a tervezők használhatnak. További információkért tekintse meg az osztályok referenciadokumentációját.

A tervezési összetevők létrehozásának áttekintéséért tekintse meg a Design-Time támogatásának kiterjesztését ismertető témakört.

Tulajdonságok

Name	Description
Component	Lekéri a tervező által tervezett alapösszetevőt.
Verbs	Lekéri a tervező által támogatott tervezési idejű igék gyűjteményét.

Metódusok

Name	Description
Dispose()	Végrehajtja a nem felügyelt erőforrások felszabadításával, felszabadításával vagy alaphelyzetbe állításával kapcsolatos alkalmazásalapú feladatokat. (Öröklődés forrása IDisposable)
DoDefaultAction()	Végrehajtja a tervező alapértelmezett műveletét.
Initialize(IComponent)	Inicializálja a tervezőt a megadott összetevővel.

Lásd még

• IRootDesigner
• IDesignerHost
• DesignerVerb
• Design-Time támogatásának kiterjesztése