Shape.OnClick (Método)

Artículo
11/02/2012

Genera el evento Click.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
Protected Friend Overridable Sub OnClick ( _
    e As EventArgs _
)

protected internal virtual void OnClick(
    EventArgs e
)

protected public:
virtual void OnClick(
    EventArgs^ e
)

abstract OnClick : 
        e:EventArgs -> unit 
override OnClick : 
        e:EventArgs -> unit

 function OnClick(
    e : EventArgs
)

Parámetros

e
Tipo: System.EventArgs
Objeto EventArgs que contiene los datos del evento.

Comentarios

Cuando se genera un evento, se llama al controlador de eventos por medio de un delegado.Para obtener más información, vea Provocar un evento.

El método OnClick también permite que las clases derivadas controlen el evento sin asociar un delegado.Esta es la técnica preferida para controlar eventos en una clase derivada.

Notas para los herederos

Al invalidar OnClick en una clase derivada, hay que asegurarse de llamar al método OnClick de la clase base para que los delegados registrados reciban el evento.

Ejemplos

El ejemplo siguiente es un método que se ejecuta cuando el evento de Click aparece.La clase de Shape tiene varios métodos con el perfil de nombre OnEventName que ejecutan métodos cuando el evento de EventName aparece.(EventName representa el nombre del evento correspondiente).

El ejemplo siguiente se muestra cómo reemplazar los métodos de OnClick y de OnLostFocus en una clase derivada de LineShape.

Public Class HighlightLine
    Inherits LineShape
    Protected Overrides Sub OnClick(ByVal e As EventArgs)
        ' Change the color of the line when clicked.
        Me.BorderColor = Color.Red
        MyBase.OnClick(e)
    End Sub
    Protected Overrides Sub OnLostFocus(ByVal e As System.EventArgs)
        ' Change the color of the line when focus is changed.
        Me.BorderColor = Color.Black
        MyBase.OnLostFocus(e)
    End Sub
End Class

public class HighlightLine :
    LineShape
{
    protected override void OnClick(EventArgs e)
    {
        // Change the color of the line when clicked.
        this.BorderColor = Color.Red;
        base.OnClick(e);
    }
    protected override void OnLostFocus(System.EventArgs e)
    {
        // Change the color of the line when focus is changed.
        this.BorderColor = Color.Black;
        base.OnLostFocus(e);
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.