ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Método

Referencia

Definición

Espacio de nombres:: System.Web.UI.Design

Ensamblado:: System.Design.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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 evento en una región en la OnClick 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 los eventos de clic en tiempo de diseño en el control. Si e no es null, la región en la que se ha clic, si existe, se especifica en la Region propiedad .

Se aplica a

Compartir vía