EditorZoneBase.OnDisplayModeChanged メソッド

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

EditorZoneBase.OnDisplayModeChanged メソッド

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

DisplayModeChanged イベントを発生させ、Web ページが編集表示モードを開始または終了する準備として、ゾーン内のすべての EditorPart および子コントロールを破棄します。

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

Visual Basic (宣言)

Protected Overrides Sub
 OnDisplayModeChanged ( _
    sender As Object, _
    e As WebPartDisplayModeEventArgs _
)

Visual Basic (使用法)

Dim sender As Object
Dim e As WebPartDisplayModeEventArgs

Me.OnDisplayModeChanged(sender, e)

C#

protected override void OnDisplayModeChanged
 (
    Object sender,
    WebPartDisplayModeEventArgs e
)

C++

protected:
virtual void OnDisplayModeChanged (
    Object^ sender, 
    WebPartDisplayModeEventArgs^ e
) override

J#

protected void OnDisplayModeChanged (
    Object sender, 
    WebPartDisplayModeEventArgs e
)

JScript

protected override function OnDisplayModeChanged
 (
    sender : Object, 
    e : WebPartDisplayModeEventArgs
)

パラメータ

sender

DisplayModeChanged イベントの発生元の Object。

e

イベント データを格納している WebPartDisplayModeEventArgs。

解説

OnDisplayModeChanged メソッドは、ToolZone クラスの基本メソッドの実装を提供します。

OnDisplayModeChanged メソッドの主な目的は、Web ページが編集表示モードを開始または終了するための準備です。このメソッドは、ゾーンに含まれるすべてのコントロールを破棄し、次に WebPartManager コントロール内で DisplayModeChanged イベントを発生させる基本メソッドを呼び出します。

継承時の注意 OnDisplayModeChanged メソッドは、EditorZoneBase クラスまたは EditorZone クラスを継承するカスタムのエディタ ゾーン コントロールでオーバーライドしたり、プログラムを使用して呼び出したりできます。

使用例

派生クラスで OnDisplayModeChanged メソッドをオーバーライドする方法を次のコード例に示します。例の実行に必要なコード全体については、EditorZoneBase クラスの概要のトピックで「例」を参照してください。

カスタム エディタ ゾーンは、Web ページの宣言型マークアップのゾーン テンプレートで使用できるよう、EditorZone クラスから派生します。このカスタム クラスは、OnDisplayModeChanged メソッドをオーバーライドしてゾーンの背景色に指定色を設定してから、編集表示モードの開始または終了のための準備として、すべての子コントロールおよび EditorPart コントロールを破棄する基本メソッドを呼び出します。

Visual Basic

Protected Overrides Sub
 OnDisplayModeChanged(ByVal sender _
  As Object, ByVal e As
 WebPartDisplayModeEventArgs)
  Me.BackColor = Color.LightGray
  MyBase.OnDisplayModeChanged(sender, e)
End Sub

C#

protected override void OnDisplayModeChanged(object
 sender, 
  WebPartDisplayModeEventArgs e)
{
  this.BackColor = Color.LightGray;
  base.OnDisplayModeChanged(sender, e);
}

ブラウザでページを読み込む場合、ドロップダウン リスト コントロールから [編集モード] を選択して、編集モードに切り替えることができます。コントロールのいずれかのタイトル バーで動詞メニュー (下向きの矢印) をクリックし、[編集] をクリックすることにより、選択されたコントロールを編集できます。EditorZone コントロールおよび編集ユーザー インターフェイス (UI) が表示されている場合、そのゾーンにコードで指定された背景色が割り当てられていることを確認できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
EditorZoneBase クラス
EditorZoneBase メンバ
System.Web.UI.WebControls.WebParts 名前空間
その他の技術情報
ASP.NET Web パーツ ページ