EditorZoneBase.OnSelectedWebPartChanged メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

EditorZoneBase.OnSelectedWebPartChanged メソッド

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

WebPart コントロールが編集モードを開始または終了する準備として、SelectedWebPartChanged イベントを発生させて、ゾーンの EditorParts コレクションを null 参照 (Visual Basic では Nothing) に設定します。

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

Visual Basic (宣言)

Protected Overrides Sub
 OnSelectedWebPartChanged ( _
    sender As Object, _
    e As WebPartEventArgs _
)

Visual Basic (使用法)

Dim sender As Object
Dim e As WebPartEventArgs

Me.OnSelectedWebPartChanged(sender, e)

protected override void OnSelectedWebPartChanged
 (
    Object sender,
    WebPartEventArgs e
)

C++

protected:
virtual void OnSelectedWebPartChanged (
    Object^ sender, 
    WebPartEventArgs^ e
) override

protected void OnSelectedWebPartChanged (
    Object sender, 
    WebPartEventArgs e
)

JScript

protected override function OnSelectedWebPartChanged
 (
    sender : Object, 
    e : WebPartEventArgs
)

パラメータ

sender: SelectedWebPartChanged イベントの発生元の Object。

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

解説

各 WebPart コントロールが編集モードを開始または終了したときに発生するイベントのカスタムハンドリングを、OnSelectedWebPartChanged メソッドにより提供できます。

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

使用例

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

カスタムエディタゾーンは、Web ページの宣言型マークアップのゾーンテンプレートで使用できるよう、EditorZone クラスから派生します。このカスタムクラスは、OnSelectedWebPartChanged メソッドをオーバーライドし、編集中の特定のコントロールの背景色を設定して、基本メソッドを呼び出します。

Visual Basic

Protected Overrides Sub
 OnSelectedWebPartChanged(ByVal sender _
  As Object, ByVal e As
 WebPartEventArgs)
  If Not (e.WebPart Is Nothing)
 Then
    e.WebPart.Zone.SelectedPartChromeStyle.BackColor = _
      Color.LightGreen
  End If
  MyBase.OnSelectedWebPartChanged(sender, e)

End Sub

protected override void OnSelectedWebPartChanged(object
 sender, 
  WebPartEventArgs e)
{
  if (e.WebPart != null)
    e.WebPart.Zone.SelectedPartChromeStyle.BackColor = 
      Color.LightGreen;
  base.OnSelectedWebPartChanged(sender, e);
}

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