EditorZoneBase.OnDisplayModeChanged 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

準備 Web 網頁以進入或結束編輯顯示模式時，引發 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，其中包含事件資料。

範例

下列程式代碼範例示範如何覆寫 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 準備網頁以進入或結束編輯顯示模式。 方法會終結區域中包含的所有控件，然後呼叫基底方法，以引發 DisplayModeChanged 控件中的 WebPartManager 事件。

給繼承者的注意事項

OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)您可以在繼承自 EditorZoneBase 類別或 類別的自訂編輯器區域控制件中，以程式設計方式覆寫或EditorZone呼叫 方法。

另請參閱

• ASP.NET 網頁元件控制件