ParentControlDesigner ParentControlDesigner ParentControlDesigner ParentControlDesigner Class

Definition

Extends the design mode behavior of a Control that supports nested controls.

public ref class ParentControlDesigner : System::Windows::Forms::Design::ControlDesigner
public class ParentControlDesigner : System.Windows.Forms.Design.ControlDesigner
type ParentControlDesigner = class
    inherit ControlDesigner
Public Class ParentControlDesigner
Inherits ControlDesigner
Inheritance
Derived

Examples

The following example demonstrates how to implement a custom ParentControlDesigner. This code example is part of a larger example provided for the IToolboxUser interface.

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

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Diagnostics;
using namespace System::Drawing;
using namespace System::Drawing::Design;
using namespace System::Windows::Forms;
using namespace System::Windows::Forms::Design;

// This example contains an IRootDesigner that implements the IToolboxUser interface.
// This example demonstrates how to enable the GetToolSupported method of an IToolboxUser
// designer in order to disable specific toolbox items, and how to respond to the 
// invocation of a ToolboxItem in the ToolPicked method of an IToolboxUser implementation.
public ref class SampleRootDesigner;

// The following attribute associates the SampleRootDesigner with this example component.

[DesignerAttribute(__typeof(SampleRootDesigner),__typeof(IRootDesigner))]
public ref class RootDesignedComponent: public Control{};


// This example component class demonstrates the associated IRootDesigner which 
// implements the IToolboxUser interface. When designer view is invoked, Visual 
// Studio .NET attempts to display a design mode view for the class at the top 
// of a code file. This can sometimes fail when the class is one of multiple types 
// in a code file, and has a DesignerAttribute associating it with an IRootDesigner. 
// Placing a derived class at the top of the code file solves this problem. A 
// derived class is not typically needed for this reason, except that placing the 
// RootDesignedComponent class in another file is not a simple solution for a code 
// example that is packaged in one segment of code.
public ref class RootViewSampleComponent: public RootDesignedComponent{};


// This example IRootDesigner implements the IToolboxUser interface and provides a 
// Windows Forms view technology view for its associated component using an internal 
// Control type.     
// The following ToolboxItemFilterAttribute enables the GetToolSupported method of this
// IToolboxUser designer to be queried to check for whether to enable or disable all 
// ToolboxItems which create any components whose type name begins with "System.Windows.Forms".

[ToolboxItemFilterAttribute(S"System.Windows.Forms",ToolboxItemFilterType::Custom)]
public ref class SampleRootDesigner: public ParentControlDesigner, public IRootDesigner, public IToolboxUser
{
public private:
   ref class RootDesignerView;

private:

   // This field is a custom Control type named RootDesignerView. This field references
   // a control that is shown in the design mode document window.
   RootDesignerView^ view;

   // This string array contains type names of components that should not be added to 
   // the component managed by this designer from the Toolbox.  Any ToolboxItems whose 
   // type name matches a type name in this array will be marked disabled according to  
   // the signal returned by the IToolboxUser.GetToolSupported method of this designer.
   array<String^>^blockedTypeNames;

public:
   SampleRootDesigner()
   {
      array<String^>^tempTypeNames = {"System.Windows.Forms.ListBox","System.Windows.Forms.GroupBox"};
      blockedTypeNames = tempTypeNames;
   }


private:

   property array<ViewTechnology>^ SupportedTechnologies 
   {

      // IRootDesigner.SupportedTechnologies is a required override for an IRootDesigner.
      // This designer provides a display using the Windows Forms view technology.
      array<ViewTechnology>^ IRootDesigner::get()
      {
         ViewTechnology temp0[] = {ViewTechnology::WindowsForms};
         return temp0;
      }

   }

   // This method returns an object that provides the view for this root designer. 
   Object^ IRootDesigner::GetView( ViewTechnology technology )
   {
      
      // If the design environment requests a view technology other than Windows 
      // Forms, this method throws an Argument Exception.
      if ( technology != ViewTechnology::WindowsForms )
            throw gcnew ArgumentException( "An unsupported view technology was requested","Unsupported view technology." );

      
      // Creates the view object if it has not yet been initialized.
      if ( view == nullptr )
            view = gcnew RootDesignerView( this );

      return view;
   }


   // This method can signal whether to enable or disable the specified
   // ToolboxItem when the component associated with this designer is selected.
   bool IToolboxUser::GetToolSupported( ToolboxItem^ tool )
   {
      
      // Search the blocked type names array for the type name of the tool
      // for which support for is being tested. Return false to indicate the
      // tool should be disabled when the associated component is selected.
      for ( int i = 0; i < blockedTypeNames->Length; i++ )
         if ( tool->TypeName == blockedTypeNames[ i ] )
                  return false;

      
      // Return true to indicate support for the tool, if the type name of the
      // tool is not located in the blockedTypeNames string array.
      return true;
   }


   // This method can perform behavior when the specified tool has been invoked.
   // Invocation of a ToolboxItem typically creates a component or components, 
   // and adds any created components to the associated component.
   void IToolboxUser::ToolPicked( ToolboxItem^ /*tool*/ ){}


public private:

   // This control provides a Windows Forms view technology view object that 
   // provides a display for the SampleRootDesigner.

   [DesignerAttribute(__typeof(ParentControlDesigner),__typeof(IDesigner))]
   ref class RootDesignerView: public Control
   {
   private:

      // This field stores a reference to a designer.
      IDesigner^ m_designer;

   public:
      RootDesignerView( IDesigner^ designer )
      {
         
         // Perform basic control initialization.
         m_designer = designer;
         BackColor = Color::Blue;
         Font = gcnew System::Drawing::Font( Font->FontFamily->Name,24.0f );
      }


   protected:

      // This method is called to draw the view for the SampleRootDesigner.
      void OnPaint( PaintEventArgs^ pe )
      {
         Control::OnPaint( pe );
         
         // Draw the name of the component in large letters.
         pe->Graphics->DrawString( m_designer->Component->Site->Name, Font, Brushes::Yellow, ClientRectangle );
      }

   };


};

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

// This example contains an IRootDesigner that implements the IToolboxUser interface.
// This example demonstrates how to enable the GetToolSupported method of an IToolboxUser
// designer in order to disable specific toolbox items, and how to respond to the 
// invocation of a ToolboxItem in the ToolPicked method of an IToolboxUser implementation.
namespace IToolboxUserExample
{
    // This example component class demonstrates the associated IRootDesigner which 
    // implements the IToolboxUser interface. When designer view is invoked, Visual 
    // Studio .NET attempts to display a design mode view for the class at the top 
    // of a code file. This can sometimes fail when the class is one of multiple types 
    // in a code file, and has a DesignerAttribute associating it with an IRootDesigner. 
    // Placing a derived class at the top of the code file solves this problem. A 
    // derived class is not typically needed for this reason, except that placing the 
    // RootDesignedComponent class in another file is not a simple solution for a code 
    // example that is packaged in one segment of code.
    public class RootViewSampleComponent : RootDesignedComponent
	{
	}

	// The following attribute associates the SampleRootDesigner with this example component.
	[DesignerAttribute(typeof(SampleRootDesigner), typeof(IRootDesigner))]
	public class RootDesignedComponent : System.Windows.Forms.Control
	{
	}

    // This example IRootDesigner implements the IToolboxUser interface and provides a 
    // Windows Forms view technology view for its associated component using an internal 
    // Control type.     
    // The following ToolboxItemFilterAttribute enables the GetToolSupported method of this
    // IToolboxUser designer to be queried to check for whether to enable or disable all 
    // ToolboxItems which create any components whose type name begins with "System.Windows.Forms".
    [ToolboxItemFilterAttribute("System.Windows.Forms", ToolboxItemFilterType.Custom)]
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name = "FullTrust")] 
    public class SampleRootDesigner : ParentControlDesigner, IRootDesigner, IToolboxUser
    {
        // This field is a custom Control type named RootDesignerView. This field references
        // a control that is shown in the design mode document window.
        private RootDesignerView view;

        // This string array contains type names of components that should not be added to 
        // the component managed by this designer from the Toolbox.  Any ToolboxItems whose 
        // type name matches a type name in this array will be marked disabled according to  
        // the signal returned by the IToolboxUser.GetToolSupported method of this designer.
        private string[] blockedTypeNames =
        {
            "System.Windows.Forms.ListBox",
            "System.Windows.Forms.GroupBox"
        };

        // IRootDesigner.SupportedTechnologies is a required override for an IRootDesigner.
        // This designer provides a display using the Windows Forms view technology.
        ViewTechnology[] IRootDesigner.SupportedTechnologies 
        {
            get { return new ViewTechnology[] {ViewTechnology.Default}; }
        }

        // This method returns an object that provides the view for this root designer. 
        object IRootDesigner.GetView(ViewTechnology technology) 
        {
            // If the design environment requests a view technology other than Windows 
            // Forms, this method throws an Argument Exception.
            if (technology != ViewTechnology.Default)            
                throw new ArgumentException("An unsupported view technology was requested", 
                "Unsupported view technology.");            
            
            // Creates the view object if it has not yet been initialized.
            if (view == null)                            
                view = new RootDesignerView(this);          
  
            return view;
        }

        // This method can signal whether to enable or disable the specified
        // ToolboxItem when the component associated with this designer is selected.
        bool IToolboxUser.GetToolSupported(ToolboxItem tool)
        {       
            // Search the blocked type names array for the type name of the tool
            // for which support for is being tested. Return false to indicate the
            // tool should be disabled when the associated component is selected.
            for( int i=0; i<blockedTypeNames.Length; i++ )
                if( tool.TypeName == blockedTypeNames[i] )
                    return false;
            
            // Return true to indicate support for the tool, if the type name of the
            // tool is not located in the blockedTypeNames string array.
            return true;
        }
    
        // This method can perform behavior when the specified tool has been invoked.
        // Invocation of a ToolboxItem typically creates a component or components, 
        // and adds any created components to the associated component.
        void IToolboxUser.ToolPicked(ToolboxItem tool)
        {
        }

        // This control provides a Windows Forms view technology view object that 
        // provides a display for the SampleRootDesigner.
        [DesignerAttribute(typeof(ParentControlDesigner), typeof(IDesigner))]
        internal class RootDesignerView : Control
        {
            // This field stores a reference to a designer.
            private IDesigner m_designer;

            public RootDesignerView(IDesigner designer)
            {
                // Perform basic control initialization.
                m_designer = designer;
                BackColor = Color.Blue;
                Font = new Font(Font.FontFamily.Name, 24.0f);                
            }

            // This method is called to draw the view for the SampleRootDesigner.
            protected override void OnPaint(PaintEventArgs pe)
            {
                base.OnPaint(pe);
                // Draw the name of the component in large letters.
                pe.Graphics.DrawString(m_designer.Component.Site.Name, Font, Brushes.Yellow, ClientRectangle);
            }
        }
    }
}
Imports System
Imports System.Collections
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Diagnostics
Imports System.Drawing
Imports System.Drawing.Design
Imports System.Windows.Forms
Imports System.Windows.Forms.Design

' This example contains an IRootDesigner that implements the IToolboxUser interface.
' This example demonstrates how to enable the GetToolSupported method of an IToolboxUser
' designer in order to disable specific toolbox items, and how to respond to the 
' invocation of a ToolboxItem in the ToolPicked method of an IToolboxUser implementation.
' This example component class demonstrates the associated IRootDesigner which 
' implements the IToolboxUser interface. When designer view is invoked, Visual 
' Studio .NET attempts to display a design mode view for the class at the top 
' of a code file. This can sometimes fail when the class is one of multiple types 
' in a code file, and has a DesignerAttribute associating it with an IRootDesigner. 
' Placing a derived class at the top of the code file solves this problem. A 
' derived class is not typically needed for this reason, except that placing the 
' RootDesignedComponent class in another file is not a simple solution for a code 
' example that is packaged in one segment of code.

Public Class RootViewSampleComponent
    Inherits RootDesignedComponent
End Class

' The following attribute associates the SampleRootDesigner with this example component.
<DesignerAttribute(GetType(SampleRootDesigner), GetType(IRootDesigner))> _
Public Class RootDesignedComponent
    Inherits System.Windows.Forms.Control
End Class

' This example IRootDesigner implements the IToolboxUser interface and provides a 
' Windows Forms view technology view for its associated component using an internal 
' Control type.     
' The following ToolboxItemFilterAttribute enables the GetToolSupported method of this
' IToolboxUser designer to be queried to check for whether to enable or disable all 
' ToolboxItems which create any components whose type name begins with "System.Windows.Forms".
<ToolboxItemFilterAttribute("System.Windows.Forms", ToolboxItemFilterType.Custom)> _
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Public Class SampleRootDesigner
    Inherits ParentControlDesigner
    Implements IRootDesigner, IToolboxUser

    ' Member field of custom type RootDesignerView, a control that is shown in the 
    ' design mode document window. This member is cached to reduce processing needed 
    ' to recreate the view control on each call to GetView().
    Private m_view As RootDesignerView

    ' This string array contains type names of components that should not be added to 
    ' the component managed by this designer from the Toolbox.  Any ToolboxItems whose 
    ' type name matches a type name in this array will be marked disabled according to  
    ' the signal returned by the IToolboxUser.GetToolSupported method of this designer.
    Private blockedTypeNames As String() = {"System.Windows.Forms.ListBox", "System.Windows.Forms.GroupBox"}

    ' IRootDesigner.SupportedTechnologies is a required override for an IRootDesigner.
    ' This designer provides a display using the Windows Forms view technology.
    ReadOnly Property SupportedTechnologies() As ViewTechnology() Implements IRootDesigner.SupportedTechnologies
        Get
            Return New ViewTechnology() {ViewTechnology.Default}
        End Get
    End Property

    ' This method returns an object that provides the view for this root designer. 
    Function GetView(ByVal technology As ViewTechnology) As Object Implements IRootDesigner.GetView
        ' If the design environment requests a view technology other than Windows 
        ' Forms, this method throws an Argument Exception.
        If technology <> ViewTechnology.Default Then
            Throw New ArgumentException("An unsupported view technology was requested", "Unsupported view technology.")
        End If

        ' Creates the view object if it has not yet been initialized.
        If m_view Is Nothing Then
            m_view = New RootDesignerView(Me)
        End If
        Return m_view
    End Function

    ' This method can signal whether to enable or disable the specified
    ' ToolboxItem when the component associated with this designer is selected.
    Function GetToolSupported(ByVal tool As ToolboxItem) As Boolean Implements IToolboxUser.GetToolSupported
        ' Search the blocked type names array for the type name of the tool
        ' for which support for is being tested. Return false to indicate the
        ' tool should be disabled when the associated component is selected.
        Dim i As Integer
        For i = 0 To blockedTypeNames.Length - 1
            If tool.TypeName = blockedTypeNames(i) Then
                Return False
            End If
        Next i ' Return true to indicate support for the tool, if the type name of the
        ' tool is not located in the blockedTypeNames string array.
        Return True
    End Function

    ' This method can perform behavior when the specified tool has been invoked.
    ' Invocation of a ToolboxItem typically creates a component or components, 
    ' and adds any created components to the associated component.
    Sub ToolPicked(ByVal tool As ToolboxItem) Implements IToolboxUser.ToolPicked
    End Sub

    ' This control provides a Windows Forms view technology view object that 
    ' provides a display for the SampleRootDesigner.
    <DesignerAttribute(GetType(ParentControlDesigner), GetType(IDesigner))> _
    Friend Class RootDesignerView
        Inherits Control
        ' This field stores a reference to a designer.
        Private m_designer As IDesigner

        Public Sub New(ByVal designer As IDesigner)
            ' Performs basic control initialization.
            m_designer = designer
            BackColor = Color.Blue
            Font = New Font(Font.FontFamily.Name, 24.0F)
        End Sub

        ' This method is called to draw the view for the SampleRootDesigner.
        Protected Overrides Sub OnPaint(ByVal pe As PaintEventArgs)
            MyBase.OnPaint(pe)
            ' Draws the name of the component in large letters.
            pe.Graphics.DrawString(m_designer.Component.Site.Name, Font, Brushes.Yellow, New RectangleF(ClientRectangle.X, ClientRectangle.Y, ClientRectangle.Width, ClientRectangle.Height))
        End Sub
    End Class
End Class

Remarks

ParentControlDesigner provides a base class for designers of controls that can contain child controls. In addition to the methods and functionality inherited from the ControlDesigner and ComponentDesigner classes, ParentControlDesigner enables child controls to be added to, removed from, selected within, and arranged within the control whose behavior it extends at design time.

You can associate a designer with a type using a DesignerAttribute. For an overview of customizing design time behavior, see Extending Design-Time Support.

Constructors

ParentControlDesigner() ParentControlDesigner() ParentControlDesigner() ParentControlDesigner()

Initializes a new instance of the ParentControlDesigner class.

Properties

AccessibilityObject AccessibilityObject AccessibilityObject AccessibilityObject

Gets the AccessibleObject assigned to the control.

(Inherited from ControlDesigner)
ActionLists ActionLists ActionLists ActionLists

Gets the design-time action lists supported by the component associated with the designer.

(Inherited from ComponentDesigner)
AllowControlLasso AllowControlLasso AllowControlLasso AllowControlLasso

Gets a value indicating whether selected controls will be re-parented.

AllowGenericDragBox AllowGenericDragBox AllowGenericDragBox AllowGenericDragBox

Gets a value indicating whether a generic drag box should be drawn when dragging a toolbox item over the designer's surface.

AllowSetChildIndexOnDrop AllowSetChildIndexOnDrop AllowSetChildIndexOnDrop AllowSetChildIndexOnDrop

Gets a value indicating whether the z-order of dragged controls should be maintained when dropped on a ParentControlDesigner.

AssociatedComponents AssociatedComponents AssociatedComponents AssociatedComponents

Gets the collection of components associated with the component managed by the designer.

(Inherited from ControlDesigner)
AutoResizeHandles AutoResizeHandles AutoResizeHandles AutoResizeHandles

Gets or sets a value indicating whether resize handle allocation depends on the value of the AutoSize property.

(Inherited from ControlDesigner)
BehaviorService BehaviorService BehaviorService BehaviorService

Gets the BehaviorService from the design environment.

(Inherited from ControlDesigner)
Component Component Component Component

Gets the component this designer is designing.

(Inherited from ComponentDesigner)
Control Control Control Control

Gets the control that the designer is designing.

(Inherited from ControlDesigner)
DefaultControlLocation DefaultControlLocation DefaultControlLocation DefaultControlLocation

Gets the default location for a control added to the designer.

DrawGrid DrawGrid DrawGrid DrawGrid

Gets or sets a value indicating whether a grid should be drawn on the control for this designer.

EnableDragRect EnableDragRect EnableDragRect EnableDragRect

Gets a value indicating whether drag rectangles are drawn by the designer.

GridSize GridSize GridSize GridSize

Gets or sets the size of each square of the grid that is drawn when the designer is in grid draw mode.

InheritanceAttribute InheritanceAttribute InheritanceAttribute InheritanceAttribute

Gets the InheritanceAttribute of the designer.

(Inherited from ControlDesigner)
Inherited Inherited Inherited Inherited

Gets a value indicating whether this component is inherited.

(Inherited from ComponentDesigner)
ITreeDesigner.Children ITreeDesigner.Children ITreeDesigner.Children ITreeDesigner.Children

For a description of this member, see the Children property.

(Inherited from ComponentDesigner)
ITreeDesigner.Parent ITreeDesigner.Parent ITreeDesigner.Parent ITreeDesigner.Parent

For a description of this member, see the Parent property.

(Inherited from ComponentDesigner)
MouseDragTool MouseDragTool MouseDragTool MouseDragTool

Gets a value indicating whether the designer has a valid tool during a drag operation.

ParentComponent ParentComponent ParentComponent ParentComponent

Gets the parent component for the ControlDesigner.

(Inherited from ControlDesigner)
ParticipatesWithSnapLines ParticipatesWithSnapLines ParticipatesWithSnapLines ParticipatesWithSnapLines

Gets a value indicating whether the ControlDesigner will allow snapline alignment during a drag operation.

(Inherited from ControlDesigner)
SelectionRules SelectionRules SelectionRules SelectionRules

Gets the selection rules that indicate the movement capabilities of a component.

(Inherited from ControlDesigner)
ShadowProperties ShadowProperties ShadowProperties ShadowProperties

Gets a collection of property values that override user settings.

(Inherited from ComponentDesigner)
SnapLines SnapLines SnapLines SnapLines

Gets a list of SnapLine objects representing significant alignment points for this control.

Verbs Verbs Verbs Verbs

Gets the design-time verbs supported by the component that is associated with the designer.

(Inherited from ComponentDesigner)

Methods

AddPaddingSnapLines(ArrayList) AddPaddingSnapLines(ArrayList) AddPaddingSnapLines(ArrayList) AddPaddingSnapLines(ArrayList)

Adds padding snaplines.

BaseWndProc(Message) BaseWndProc(Message) BaseWndProc(Message) BaseWndProc(Message)

Processes Windows messages.

(Inherited from ControlDesigner)
CanAddComponent(IComponent) CanAddComponent(IComponent) CanAddComponent(IComponent) CanAddComponent(IComponent)

Called when a component is added to the parent container.

CanBeParentedTo(IDesigner) CanBeParentedTo(IDesigner) CanBeParentedTo(IDesigner) CanBeParentedTo(IDesigner)

Indicates if this designer's control can be parented by the control of the specified designer.

(Inherited from ControlDesigner)
CanParent(Control) CanParent(Control) CanParent(Control) CanParent(Control)

Indicates whether the specified control can be a child of the control managed by this designer.

CanParent(ControlDesigner) CanParent(ControlDesigner) CanParent(ControlDesigner) CanParent(ControlDesigner)

Indicates whether the control managed by the specified designer can be a child of the control managed by this designer.

CreateTool(ToolboxItem) CreateTool(ToolboxItem) CreateTool(ToolboxItem) CreateTool(ToolboxItem)

Creates a component or control from the specified tool and adds it to the current design document.

CreateTool(ToolboxItem, Point) CreateTool(ToolboxItem, Point) CreateTool(ToolboxItem, Point) CreateTool(ToolboxItem, Point)

Creates a component or control from the specified tool and adds it to the current design document at the specified location.

CreateTool(ToolboxItem, Rectangle) CreateTool(ToolboxItem, Rectangle) CreateTool(ToolboxItem, Rectangle) CreateTool(ToolboxItem, Rectangle)

Creates a component or control from the specified tool and adds it to the current design document within the bounds of the specified rectangle.

CreateToolCore(ToolboxItem, Int32, Int32, Int32, Int32, Boolean, Boolean) CreateToolCore(ToolboxItem, Int32, Int32, Int32, Int32, Boolean, Boolean) CreateToolCore(ToolboxItem, Int32, Int32, Int32, Int32, Boolean, Boolean) CreateToolCore(ToolboxItem, Int32, Int32, Int32, Int32, Boolean, Boolean)

Provides core functionality for all the CreateTool(ToolboxItem) methods.

DefWndProc(Message) DefWndProc(Message) DefWndProc(Message) DefWndProc(Message)

Provides default processing for Windows messages.

(Inherited from ControlDesigner)
DisplayError(Exception) DisplayError(Exception) DisplayError(Exception) DisplayError(Exception)

Displays information about the specified exception to the user.

(Inherited from ControlDesigner)
Dispose() Dispose() Dispose() Dispose()

Releases all resources used by the ComponentDesigner.

(Inherited from ComponentDesigner)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Releases the unmanaged resources used by the ParentControlDesigner, and optionally releases the managed resources.

DoDefaultAction() DoDefaultAction() DoDefaultAction() DoDefaultAction()

Creates a method signature in the source code file for the default event on the component and navigates the user's cursor to that location.

(Inherited from ComponentDesigner)
EnableDesignMode(Control, String) EnableDesignMode(Control, String) EnableDesignMode(Control, String) EnableDesignMode(Control, String)

Enables design time functionality for a child control.

(Inherited from ControlDesigner)
EnableDragDrop(Boolean) EnableDragDrop(Boolean) EnableDragDrop(Boolean) EnableDragDrop(Boolean)

Enables or disables drag-and-drop support for the control being designed.

(Inherited from ControlDesigner)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetControl(Object) GetControl(Object) GetControl(Object) GetControl(Object)

Gets the control from the designer of the specified component.

GetControlGlyph(GlyphSelectionType) GetControlGlyph(GlyphSelectionType) GetControlGlyph(GlyphSelectionType) GetControlGlyph(GlyphSelectionType)

Gets a body glyph that represents the bounds of the control.

GetGlyphs(GlyphSelectionType) GetGlyphs(GlyphSelectionType) GetGlyphs(GlyphSelectionType) GetGlyphs(GlyphSelectionType)

Gets a collection of Glyph objects representing the selection borders and grab handles for a standard control.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetHitTest(Point) GetHitTest(Point) GetHitTest(Point) GetHitTest(Point)

Indicates whether a mouse click at the specified point should be handled by the control.

(Inherited from ControlDesigner)
GetParentForComponent(IComponent) GetParentForComponent(IComponent) GetParentForComponent(IComponent) GetParentForComponent(IComponent)

Used by deriving classes to determine if it returns the control being designed or some other Container while adding a component to it.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Attempts to retrieve the specified type of service from the design mode site of the designer's component.

(Inherited from ComponentDesigner)
GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
GetUpdatedRect(Rectangle, Rectangle, Boolean) GetUpdatedRect(Rectangle, Rectangle, Boolean) GetUpdatedRect(Rectangle, Rectangle, Boolean) GetUpdatedRect(Rectangle, Rectangle, Boolean)

Updates the position of the specified rectangle, adjusting it for grid alignment if grid alignment mode is enabled.

HookChildControls(Control) HookChildControls(Control) HookChildControls(Control) HookChildControls(Control)

Routes messages from the child controls of the specified control to the designer.

(Inherited from ControlDesigner)
Initialize(IComponent) Initialize(IComponent) Initialize(IComponent) Initialize(IComponent)

Initializes the designer with the specified component.

InitializeExistingComponent(IDictionary) InitializeExistingComponent(IDictionary) InitializeExistingComponent(IDictionary) InitializeExistingComponent(IDictionary)

Re-initializes an existing component.

(Inherited from ControlDesigner)
InitializeNewComponent(IDictionary) InitializeNewComponent(IDictionary) InitializeNewComponent(IDictionary) InitializeNewComponent(IDictionary)

Initializes a newly created component.

InitializeNonDefault() InitializeNonDefault() InitializeNonDefault() InitializeNonDefault()

Initializes properties of the control to any non-default values.

(Inherited from ControlDesigner)
InternalControlDesigner(Int32) InternalControlDesigner(Int32) InternalControlDesigner(Int32) InternalControlDesigner(Int32)

Returns the internal control designer with the specified index in the ControlDesigner.

(Inherited from ControlDesigner)
InvokeCreateTool(ParentControlDesigner, ToolboxItem) InvokeCreateTool(ParentControlDesigner, ToolboxItem) InvokeCreateTool(ParentControlDesigner, ToolboxItem) InvokeCreateTool(ParentControlDesigner, ToolboxItem)

Creates a tool from the specified ToolboxItem.

InvokeGetInheritanceAttribute(ComponentDesigner) InvokeGetInheritanceAttribute(ComponentDesigner) InvokeGetInheritanceAttribute(ComponentDesigner) InvokeGetInheritanceAttribute(ComponentDesigner)

Gets the InheritanceAttribute of the specified ComponentDesigner.

(Inherited from ComponentDesigner)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
NumberOfInternalControlDesigners() NumberOfInternalControlDesigners() NumberOfInternalControlDesigners() NumberOfInternalControlDesigners()

Returns the number of internal control designers in the ControlDesigner.

(Inherited from ControlDesigner)
OnContextMenu(Int32, Int32) OnContextMenu(Int32, Int32) OnContextMenu(Int32, Int32) OnContextMenu(Int32, Int32)

Shows the context menu and provides an opportunity to perform additional processing when the context menu is about to be displayed.

(Inherited from ControlDesigner)
OnCreateHandle() OnCreateHandle() OnCreateHandle() OnCreateHandle()

Provides an opportunity to perform additional processing immediately after the control handle has been created.

(Inherited from ControlDesigner)
OnDragComplete(DragEventArgs) OnDragComplete(DragEventArgs) OnDragComplete(DragEventArgs) OnDragComplete(DragEventArgs)

Called in order to clean up a drag-and-drop operation.

OnDragDrop(DragEventArgs) OnDragDrop(DragEventArgs) OnDragDrop(DragEventArgs) OnDragDrop(DragEventArgs)

Called when a drag-and-drop object is dropped onto the control designer view.

OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs)

Called when a drag-and-drop operation enters the control designer view.

OnDragLeave(EventArgs) OnDragLeave(EventArgs) OnDragLeave(EventArgs) OnDragLeave(EventArgs)

Called when a drag-and-drop operation leaves the control designer view.

OnDragOver(DragEventArgs) OnDragOver(DragEventArgs) OnDragOver(DragEventArgs) OnDragOver(DragEventArgs)

Called when a drag-and-drop object is dragged over the control designer view.

OnGiveFeedback(GiveFeedbackEventArgs) OnGiveFeedback(GiveFeedbackEventArgs) OnGiveFeedback(GiveFeedbackEventArgs) OnGiveFeedback(GiveFeedbackEventArgs)

Called when a drag-and-drop operation is in progress to provide visual cues based on the location of the mouse while a drag operation is in progress.

OnMouseDragBegin(Int32, Int32) OnMouseDragBegin(Int32, Int32) OnMouseDragBegin(Int32, Int32) OnMouseDragBegin(Int32, Int32)

Called in response to the left mouse button being pressed and held while over the component.

OnMouseDragEnd(Boolean) OnMouseDragEnd(Boolean) OnMouseDragEnd(Boolean) OnMouseDragEnd(Boolean)

Called at the end of a drag-and-drop operation to complete or cancel the operation.

OnMouseDragMove(Int32, Int32) OnMouseDragMove(Int32, Int32) OnMouseDragMove(Int32, Int32) OnMouseDragMove(Int32, Int32)

Called for each movement of the mouse during a drag-and-drop operation.

OnMouseEnter() OnMouseEnter() OnMouseEnter() OnMouseEnter()

Called when the mouse first enters the control.

OnMouseHover() OnMouseHover() OnMouseHover() OnMouseHover()

Called after the mouse hovers over the control.

OnMouseLeave() OnMouseLeave() OnMouseLeave() OnMouseLeave()

Called when the mouse first enters the control.

OnPaintAdornments(PaintEventArgs) OnPaintAdornments(PaintEventArgs) OnPaintAdornments(PaintEventArgs) OnPaintAdornments(PaintEventArgs)

Called when the control that the designer is managing has painted its surface so the designer can paint any additional adornments on top of the control.

OnSetComponentDefaults() OnSetComponentDefaults() OnSetComponentDefaults() OnSetComponentDefaults()

Called when the designer is initialized.

(Inherited from ControlDesigner)
OnSetCursor() OnSetCursor() OnSetCursor() OnSetCursor()

Provides an opportunity to change the current mouse cursor.

PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary)

Allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PostFilterEvents(IDictionary) PostFilterEvents(IDictionary) PostFilterEvents(IDictionary) PostFilterEvents(IDictionary)

Allows a designer to change or remove items from the set of events that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PostFilterProperties(IDictionary) PostFilterProperties(IDictionary) PostFilterProperties(IDictionary) PostFilterProperties(IDictionary)

Allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary)

Allows a designer to add to the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PreFilterEvents(IDictionary) PreFilterEvents(IDictionary) PreFilterEvents(IDictionary) PreFilterEvents(IDictionary)

Allows a designer to add to the set of events that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PreFilterProperties(IDictionary) PreFilterProperties(IDictionary) PreFilterProperties(IDictionary) PreFilterProperties(IDictionary)

Adjusts the set of properties the component will expose through a TypeDescriptor.

RaiseComponentChanged(MemberDescriptor, Object, Object) RaiseComponentChanged(MemberDescriptor, Object, Object) RaiseComponentChanged(MemberDescriptor, Object, Object) RaiseComponentChanged(MemberDescriptor, Object, Object)

Notifies the IComponentChangeService that this component has been changed.

(Inherited from ComponentDesigner)
RaiseComponentChanging(MemberDescriptor) RaiseComponentChanging(MemberDescriptor) RaiseComponentChanging(MemberDescriptor) RaiseComponentChanging(MemberDescriptor)

Notifies the IComponentChangeService that this component is about to be changed.

(Inherited from ComponentDesigner)
ToString() ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)
UnhookChildControls(Control) UnhookChildControls(Control) UnhookChildControls(Control) UnhookChildControls(Control)

Routes messages for the children of the specified control to each control rather than to a parent designer.

(Inherited from ControlDesigner)
WndProc(Message) WndProc(Message) WndProc(Message) WndProc(Message)

Processes Windows messages.

Explicit Interface Implementations

IDesignerFilter.PostFilterAttributes(IDictionary) IDesignerFilter.PostFilterAttributes(IDictionary) IDesignerFilter.PostFilterAttributes(IDictionary) IDesignerFilter.PostFilterAttributes(IDictionary)

For a description of this member, see the PostFilterAttributes(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary) IDesignerFilter.PostFilterEvents(IDictionary) IDesignerFilter.PostFilterEvents(IDictionary) IDesignerFilter.PostFilterEvents(IDictionary)

For a description of this member, see the PostFilterEvents(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary) IDesignerFilter.PostFilterProperties(IDictionary) IDesignerFilter.PostFilterProperties(IDictionary) IDesignerFilter.PostFilterProperties(IDictionary)

For a description of this member, see the PostFilterProperties(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary) IDesignerFilter.PreFilterAttributes(IDictionary) IDesignerFilter.PreFilterAttributes(IDictionary) IDesignerFilter.PreFilterAttributes(IDictionary)

For a description of this member, see the PreFilterAttributes(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary) IDesignerFilter.PreFilterEvents(IDictionary) IDesignerFilter.PreFilterEvents(IDictionary) IDesignerFilter.PreFilterEvents(IDictionary)

For a description of this member, see the PreFilterEvents(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary) IDesignerFilter.PreFilterProperties(IDictionary) IDesignerFilter.PreFilterProperties(IDictionary) IDesignerFilter.PreFilterProperties(IDictionary)

For a description of this member, see the PreFilterProperties(IDictionary) method.

(Inherited from ComponentDesigner)

Fields

accessibilityObj accessibilityObj accessibilityObj accessibilityObj

Specifies the accessibility object for the designer.

(Inherited from ControlDesigner)

Applies to

See also