語言

EditorZoneBase.OnDisplayModeChanged 方法

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

會提升 DisplayModeChanged 事件並摧毀區域內所有 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 A 包含事件資料。

範例

以下程式碼範例示範如何在衍生類別中覆寫該 OnDisplayModeChanged 方法。 關於執行範例所需的完整程式碼，請參閱課程總覽主題的 EditorZoneBase 範例部分。

自訂編輯器區域源自該 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 方法的主要目的是準備網頁進入或退出編輯顯示模式。 該方法會銷毀區域內所有控制，然後呼叫基礎方法，將事件在控制區中觸發DisplayModeChangedWebPartManager。

給繼承者的注意事項

此OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)方法可被覆蓋或在自訂編輯器區域控制中以程式呼叫，該區域控制項繼承自類別EditorZoneBase或類別。EditorZone

適用於

另請參閱