DesignerRegionMouseEventArgs クラス

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

DesignerRegionMouseEventArgs クラス

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

選択されているコントロールまたは選択されているコントロールのデザイナ領域をクリックしたときに発生する ViewEvent イベントのデータを提供します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 DesignerRegionMouseEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As DesignerRegionMouseEventArgs

C#

public sealed class DesignerRegionMouseEventArgs
 : EventArgs

C++

public ref class DesignerRegionMouseEventArgs
 sealed : public EventArgs

J#

public final class DesignerRegionMouseEventArgs
 extends EventArgs

JScript

public final class DesignerRegionMouseEventArgs
 extends EventArgs

解説

ViewEvent イベントは、デザイン サーフェイス上の特定の操作に対して発生し、デザイナのホストによって生成されます。たとえば、デザイン サーフェイスで選択されているコントロールまたは選択されているコントロールのデザイナ領域をクリックすると、イベントが発生します。

ControlDesigner クラスは、ViewEvent イベントを処理するための既定のデリゲートを提供します。デザイン時に、選択されているコントロールまたは選択されているコントロールのデザイナ領域をクリックすると、デザイナ ホストは Click イベント型の ViewEventArgs オブジェクトを初期化し、EventArgs プロパティに DesignerRegionMouseEventArgs オブジェクトを設定します。

デザイナ領域をクリックしたことが ViewEventArgs オブジェクトにより示されると、ControlDesigner クラスの既定のデリゲートにより、DesignerRegionMouseEventArgs オブジェクトが OnClick メソッドに渡されます。ControlDesigner クラスから派生するクラスは、OnClick メソッドをオーバーライドして、デザイン ホストでコントロールがクリックされたときに生成されるイベントを処理します。

Region プロパティは、イベントが適用されるコントロール デザイナ領域 (存在する場合) を表します。Location プロパティは、デザイン サーフェイス上のクリックされた位置を表します。

イベントとデリゲートの詳細については、「イベントとデリゲート」を参照してください。

使用例

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

継承階層

System.Object
   System.EventArgs
    System.Web.UI.Design.DesignerRegionMouseEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
DesignerRegionMouseEventArgs メンバ
System.Web.UI.Design 名前空間
Region
Location
ViewEventArgs
OnClick