ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Método

Definição

Espaço de Nomes:
System.Web.UI.Design
Assemblagem:
System.Design.dll

Chamada pelo anfitrião de design quando o utilizador clica no controlo associado no momento do design.

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

Um DesignerRegionMouseEventArgs objeto que especifica a localização e, possivelmente, a região do designer de controlo onde o utilizador clicou.

Exemplos

O exemplo de código seguinte mostra como usar um handler para o OnClick evento numa região clicável do controlo e usar um DesignerRegionMouseEventArgs objeto para identificar a região que está a ser clicada.

Este exemplo de código faz parte de um exemplo de código maior para a EditableDesignerRegion classe.

// 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

Observações

O ViewEvent evento é levantado pelo anfitrião de design para certas ações num controlo na superfície de design. Por exemplo, um evento é levantado para as seguintes condições:

  • O utilizador clica no controlo.

  • O designer de controlo pinta a superfície do design.

  • O utilizador entra ou sai do modo de edição de modelos para o controlo.

A ControlDesigner classe fornece um delegado padrão para gerir o IControlDesignerView.ViewEvent evento. Classes derivadas de ControlDesigner sobrepõem o OnClick método para processar eventos que são gerados quando o utilizador clica num controlo.

O OnClick método permite que classes derivadas tratem do evento sem anexar um delegado. Esta é a técnica preferida para lidar com o evento numa classe derivada.

A implementação padrão do OnClick método retorna sem realizar qualquer processamento.

Notas para Herdeiros

Sobrescreva o OnClick(DesignerRegionMouseEventArgs) método numa classe derivada da ControlDesigner classe para tratar eventos de clique em tempo de design no controlo. Se e não for nulo, a região clicada, se existir, é especificada na Region propriedade.

Aplica-se a

Ver também