Compartir vía


ControlDesigner.OnPaint(PaintEventArgs) Método

Definición

Se le llama cuando el diseñador de controles dibuja el control asociado en la superficie de diseño, si el valor CustomPaint es 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)

Parámetros

e
PaintEventArgs

Objeto PaintEventArgs que especifica los gráficos y límites de rectángulo utilizados para dibujar el control.

Comentarios

El ViewEvent host de diseño genera el evento para determinadas acciones en un control de la superficie de diseño. Por ejemplo, se genera un evento para las condiciones siguientes:

  • El usuario hace clic en el control.

  • El host de diseño solicita marcado HTML para representar el control asociado en la superficie de diseño.

  • El usuario entra o sale del modo de edición de plantillas para el control.

La ControlDesigner clase proporciona un delegado predeterminado para controlar el IControlDesignerView.ViewEvent evento. Las clases derivadas de ControlDesigner deben establecer el ViewFlags.CustomPaint valor e invalidar el OnPaint método para procesar eventos que se generan cuando el host de diseño dibuja el control en la superficie de diseño.

El OnPaint método permite que las clases derivadas controle el evento sin adjuntar un delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

La implementación predeterminada del OnPaint método devuelve sin realizar ningún procesamiento.

Notas a los desarrolladores de herederos

Invalide el OnPaint(PaintEventArgs) método en una clase que deriva de la ControlDesigner clase para controlar los eventos de pintura de un control en la superficie de diseño. Sin embargo, el evento solo se produce si el CustomPaint valor se ha establecido con el SetViewFlags(ViewFlags, Boolean) método .

Se aplica a

Consulte también