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 控制項設計工具概觀