System.Web.UI.Design.ControlDesigner.OnPaint Method

Called when the control designer draws the associated control on the design surface, if the ViewFlags.CustomPaint value is true.

Syntax

protected virtual void OnPaint (System.Windows.Forms.PaintEventArgs e)

Parameters

e
A System.Windows.Forms.PaintEventArgs object that specifies the graphics and rectangle boundaries used to draw the control.

Remarks

The IControlDesignerView.ViewEvent event is raised by the design host for certain actions on a control in the design surface. For example, an event is raised for the following conditions:

  • The user clicks the control.

  • The design host requests HTML markup to render the associated control on the design surface.

  • The user enters or exits template editing mode for the control.

The System.Web.UI.Design.ControlDesigner class supplies a default delegate to handle the IControlDesignerView.ViewEvent event. Classes deriving from System.Web.UI.Design.ControlDesigner should set the ViewFlags.CustomPaint value and override the ControlDesigner.OnPaint(System.Windows.Forms.PaintEventArgs) method to process events that are raised when the design host draws the control on the design surface.

The ControlDesigner.OnPaint(System.Windows.Forms.PaintEventArgs) method allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

The default implementation of the ControlDesigner.OnPaint(System.Windows.Forms.PaintEventArgs) method returns without performing any processing.

Requirements

Namespace: System.Web.UI.Design
Assembly: System.Design (in System.Design.dll)
Assembly Versions: 2.0.0.0