ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Método

  • Referência

Definição

Namespace:
System.Web.UI.Design
Assembly:
System.Design.dll

Chamado pelo host de design quando o usuário clica no controle associado em tempo de 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 objeto DesignerRegionMouseEventArgs que especifica o local e, possivelmente, a região do designer de controle em que o usuário clicou.

Exemplos

O exemplo de código a seguir mostra como usar um manipulador para o OnClick evento em uma região clicável do controle e usar um DesignerRegionMouseEventArgs objeto para identificar a região que está sendo 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

Comentários

O ViewEvent evento é gerado pelo host de design para determinadas ações em um controle na superfície de design. Por exemplo, um evento é gerado para as seguintes condições:

  • O usuário clica no controle.

  • O designer de controle pinta na superfície de design.

  • O usuário entra ou sai do modo de edição de modelo para o controle.

A ControlDesigner classe fornece um delegado padrão para manipular o IControlDesignerView.ViewEvent evento. Classes derivadas de ControlDesigner substituem o OnClick método para processar eventos gerados quando o usuário clica em um controle.

O OnClick método permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

A implementação padrão do OnClick método retorna sem executar nenhum processamento.

Notas aos Herdeiros

Substitua o OnClick(DesignerRegionMouseEventArgs) método em uma classe derivada da ControlDesigner classe para manipular eventos de clique em tempo de design no controle. Se e não for nulo, a região clicada, se houver, será especificada na Region propriedade .

Aplica-se a

Confira também