ControlDesigner.OnClick メソッド

.NET Framework クラス ライブラリ リファレンス

ControlDesigner.OnClick メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

関連付けられているコントロールをデザイン時にユーザーがクリックすると、デザイン ホストによって呼び出されます。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnClick ( _
    e As DesignerRegionMouseEventArgs _
)

Visual Basic (使用法)

Dim e As DesignerRegionMouseEventArgs

Me.OnClick(e)

C#

protected virtual void OnClick (
    DesignerRegionMouseEventArgs e
)

C++

protected:
virtual void OnClick (
    DesignerRegionMouseEventArgs^ e
)

J#

protected void OnClick (
    DesignerRegionMouseEventArgs e
)

JScript

protected function OnClick (
    e : DesignerRegionMouseEventArgs
)

パラメータ

e

ユーザーによってクリックされた位置および (場合によっては) コントロール デザイナ領域を指定する DesignerRegionMouseEventArgs。

解説

ViewEvent イベントは、デザイン サーフェイスのコントロールの特定の操作に対して発生し、デザイン ホストによって生成されます。たとえば、イベントは、次の状況で生成されます。

• ユーザーがコントロールをクリックしたとき。

• コントロール デザイナがデザイン サーフェイスを描画したとき。

• ユーザーがコントロールのテンプレート編集モードに切り替えたとき、またはテンプレート編集モードを終了したとき。

ControlDesigner クラスは、IControlDesignerView.ViewEvent イベントを処理するための既定のデリゲートを提供します。ControlDesigner から派生するクラスは、OnClick メソッドをオーバーライドして、ユーザーがコントロールをクリックしたときに生成されたイベントを処理します。

OnClick メソッドを使用すると、デリゲートを結び付けずに派生クラスでイベントを処理できます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

OnClick メソッドの既定の実装では、処理が行われずに制御が戻ります。

継承時の注意 ControlDesigner クラスから派生したクラスの OnClick メソッドをオーバーライドして、コントロールのデザイン時のクリック イベントを処理します。e が null でない場合、クリックされた領域 (存在する場合) は Region プロパティに指定されています。

使用例

コントロールのクリック可能領域の OnClick イベントのハンドラを使用し、DesignerRegionMouseEventArgs オブジェクトを使用して、クリックされた領域を識別する方法のコード例を次に示します。

このコード例は、EditableDesignerRegion クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' 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

C#

// 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();
    }
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
ViewEventHandler
DesignerRegionMouseEventArgs
DesignerRegion
その他の技術情報
Web フォームのデザイン時サポート