ControlDesigner.OnClick(DesignerRegionMouseEventArgs) メソッド

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)

パラメーター

例

次のコード例は、コントロールのクリック可能な領域で 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 コントロール デザイナーの概要