言語

EditorZoneBase.OnDisplayModeChanged メソッド

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

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

protected:
 override void OnDisplayModeChanged(System::Object ^ sender, System::Web::UI::WebControls::WebParts::WebPartDisplayModeEventArgs ^ e);
protected override void OnDisplayModeChanged(object sender, System.Web.UI.WebControls.WebParts.WebPartDisplayModeEventArgs e);
override this.OnDisplayModeChanged : obj * System.Web.UI.WebControls.WebParts.WebPartDisplayModeEventArgs -> unit
Protected Overrides Sub OnDisplayModeChanged (sender As Object, e As WebPartDisplayModeEventArgs)

パラメーター

sender
Object

Object イベントを発生させるDisplayModeChanged。

e
WebPartDisplayModeEventArgs

イベント データを含む WebPartDisplayModeEventArgs 。

例

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

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

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

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

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

注釈

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

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

注意 (継承者)

OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) メソッドは、EditorZoneBase クラスまたは EditorZone クラスから継承するカスタム エディター ゾーン コントロールで、プログラムによってオーバーライドまたは呼び出すことができます。

適用対象

こちらもご覧ください