ControlDesigner.OnPaint(PaintEventArgs) Method

Definition

Chiamato se la finestra di progettazione di controlli crea il controllo associato sull'area di progettazione, se il valore CustomPaint è true.Called when the control designer draws the associated control on the design surface, if the CustomPaint value is true.

protected:
 virtual void OnPaint(System::Windows::Forms::PaintEventArgs ^ e);
protected virtual void OnPaint (System.Windows.Forms.PaintEventArgs e);
abstract member OnPaint : System.Windows.Forms.PaintEventArgs -> unit
override this.OnPaint : System.Windows.Forms.PaintEventArgs -> unit
Protected Overridable Sub OnPaint (e As PaintEventArgs)

Parameters

e
PaintEventArgs

Oggetto PaintEventArgs che specifica i limiti dell'immagine e del rettangolo utilizzati per disegnare il controllo.A PaintEventArgs object that specifies the graphics and rectangle boundaries used to draw the control.

Remarks

L'evento ViewEvent viene generato dall'host di progettazione per determinate azioni su un controllo nell'area di progettazione.The ViewEvent event is raised by the design host for certain actions on a control in the design surface. Ad esempio, viene generato un evento per le condizioni seguenti:For example, an event is raised for the following conditions:

  • L'utente fa clic sul controllo.The user clicks the control.

  • L'host di progettazione richiede il markup HTML per eseguire il rendering del controllo associato nell'area di progettazione.The design host requests HTML markup to render the associated control on the design surface.

  • L'utente immette o esce dalla modalità di modifica del modello per il controllo.The user enters or exits template editing mode for the control.

La classe ControlDesigner fornisce un delegato predefinito per gestire l'evento di IControlDesignerView.ViewEvent.The ControlDesigner class supplies a default delegate to handle the IControlDesignerView.ViewEvent event. Le classi che derivano da ControlDesigner devono impostare il valore di ViewFlags.CustomPaint ed eseguire l'override del metodo OnPaint per elaborare gli eventi generati quando l'host di progettazione disegna il controllo nell'area di progettazione.Classes deriving from ControlDesigner should set the ViewFlags.CustomPaint value and override the OnPaint method to process events that are raised when the design host draws the control on the design surface.

Il metodo OnPaint consente alle classi derivate di gestire l'evento senza allegare un delegato.The OnPaint method allows derived classes to handle the event without attaching a delegate. È la tecnica consigliata per la gestione dell'evento in una classe derivata.This is the preferred technique for handling the event in a derived class.

L'implementazione predefinita del metodo OnPaint restituisce senza eseguire alcuna elaborazione.The default implementation of the OnPaint method returns without performing any processing.

Notes to Inheritors

Eseguire l'override del metodo OnPaint(PaintEventArgs) in una classe che deriva dalla classe ControlDesigner per gestire gli eventi di disegno per un controllo nell'area di progettazione.Override the OnPaint(PaintEventArgs) method in a class deriving from the ControlDesigner class to handle paint events for a control in the design surface. Tuttavia, l'evento si verifica solo se il valore CustomPaint è stato impostato con il metodo SetViewFlags(ViewFlags, Boolean).However, the event occurs only if the CustomPaint value has been set with the SetViewFlags(ViewFlags, Boolean) method.

Applies to

See also