ControlDesigner.OnClick(DesignerRegionMouseEventArgs) 方法

定义

命名空间:

System.Web.UI.Design

程序集:

System.Design.dll

当用户在设计时单击关联控件时由设计宿主调用。

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)

参数

e

DesignerRegionMouseEventArgs

一个 DesignerRegionMouseEventArgs 对象，它指定了位置，还可能指定了用户单击的控件设计器区域。

示例

下面的代码示例演示如何在控件的可单击区域中为 OnClick 事件使用处理程序，并使用 DesignerRegionMouseEventArgs 对象标识正在单击的区域。

此代码示例是 类的较大代码示例的 EditableDesignerRegion 一部分。

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

注解

该 ViewEvent 事件由设计主机引发，用于对设计图面中的控件执行某些操作。 例如，针对以下条件引发事件：

• 用户单击控件。

• 控件设计器在设计图面上绘制。

• 用户进入或退出控件的模板编辑模式。

类 ControlDesigner 提供用于处理 IControlDesignerView.ViewEvent 事件的默认委托。 派生自 ControlDesigner 的类重写 方法， OnClick 以处理用户单击控件时引发的事件。

方法 OnClick 允许派生类在不附加委托的情况下处理事件。 这是在派生类中处理事件的首选技术。

方法的默认实现 OnClick 返回而不执行任何处理。

继承者说明

OnClick(DesignerRegionMouseEventArgs)重写派生自 类的 类中的 方法，ControlDesigner以处理控件上的设计时单击事件。 如果 e 不为 null，则会在 属性中 Region 指定单击的区域（如果有）。

另请参阅

• ViewEventHandler
• DesignerRegionMouseEventArgs
• DesignerRegion
• ASP.NET 控件设计器概述