ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Método

Definición

Lo llama el host de diseño cuando el usuario hace clic en el control asociado en tiempo de diseño.

protected:
 virtual void OnClick(System::Web::UI::Design::DesignerRegionMouseEventArgs ^ e);
protected virtual void OnClick (System.Web.UI.Design.DesignerRegionMouseEventArgs e);
abstract member OnClick : System.Web.UI.Design.DesignerRegionMouseEventArgs -> unit
override this.OnClick : System.Web.UI.Design.DesignerRegionMouseEventArgs -> unit
Protected Overridable Sub OnClick (e As DesignerRegionMouseEventArgs)

Parámetros

e
DesignerRegionMouseEventArgs

Objeto DesignerRegionMouseEventArgs que especifica la ubicación y, posiblemente, la región del diseñador de controles en la que el usuario hizo clic.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un controlador para el OnClick evento en una región en la que se puede hacer clic en el control y usar un DesignerRegionMouseEventArgs objeto para identificar la región en la que se hace clic.

Este ejemplo de código forma parte de un ejemplo de código más grande para la EditableDesignerRegion clase .

// Handler for the Click event, which provides the region in the arguments.
protected override void OnClick(DesignerRegionMouseEventArgs e)
{
    if (e.Region == null)
        return;

    // If the clicked region is not a header, return
    if (e.Region.Name.IndexOf("Header") != 0)
        return;

    // Switch the current view if required
    if (e.Region.Name.Substring(6, 1) != myControl.CurrentView.ToString())
    {
        myControl.CurrentView = int.Parse(e.Region.Name.Substring(6, 1));
        base.UpdateDesignTimeHtml();
    }
}
' Handler for the Click event, which provides the region in the arguments.
Protected Overrides Sub OnClick(ByVal e As DesignerRegionMouseEventArgs)
    If IsNothing(e.Region) Then
        Return
    End If

    ' If the clicked region is not a header, return
    If e.Region.Name.IndexOf("Header") <> 0 Then
        Return
    End If

    ' Switch the current view if required
    If e.Region.Name.Substring(6, 1) <> myControl.CurrentView.ToString() Then
        myControl.CurrentView = Integer.Parse(e.Region.Name.Substring(6, 1))
        MyBase.UpdateDesignTimeHtml()
    End If
End Sub

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 diseñador de controles pinta 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 invalidan el OnClick método para procesar eventos que se generan cuando el usuario hace clic en un control.

El OnClick 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 OnClick método devuelve sin realizar ningún procesamiento.

Notas a los desarrolladores de herederos

Invalide el OnClick(DesignerRegionMouseEventArgs) método de una clase que deriva de la ControlDesigner clase para controlar eventos de clic en tiempo de diseño en el control. Si e no es null, la región en la que se hace clic, si existe, se especifica en la Region propiedad .

Se aplica a

Consulte también