Freigeben über


EditorZoneBase.OnDisplayModeChanged Methode

Definition

Löst das DisplayModeChanged-Ereignis aus und löscht alle EditorPart-Steuerelemente und die untergeordneten Steuerelemente in der Zone, um den Wechsel der Webseite in den oder aus dem Bearbeitungsanzeigemodus vorzubereiten.

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)

Parameter

sender
Object

Ein Object, das das DisplayModeChanged-Ereignis auslöst.

e
WebPartDisplayModeEventArgs

Ein WebPartDisplayModeEventArgs, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die OnDisplayModeChanged -Methode in einer abgeleiteten Klasse überschrieben wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des EditorZoneBase Themas Klassenübersicht.

Die zone des benutzerdefinierten Editors wird von der EditorZone -Klasse abgeleitet, sodass sie mit einer Zonenvorlage im deklarativen Markup der Webseite verwendet werden kann. Die benutzerdefinierte Klasse überschreibt die OnDisplayModeChanged -Methode, legt die Hintergrundfarbe der Zone auf eine angegebene Farbe fest und ruft dann die Basismethode auf, die alle untergeordneten Steuerelemente und EditorPart Steuerelemente zerstört, um den Anzeigemodus zu öffnen oder zu beenden.

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

Wenn Sie die Seite in einem Browser laden, können Sie im Dropdownlistensteuerelement Bearbeitungsmodus auswählen, um in den Bearbeitungsmodus zu wechseln. Sie können auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste eines der Steuerelemente klicken und dann auf Bearbeiten klicken, um das ausgewählte Steuerelement zu bearbeiten. Wenn das Steuerelement und die EditorZone Benutzeroberfläche für die Bearbeitung sichtbar sind, können Sie sehen, dass die Zone über die im Code angegebene Hintergrundfarbe verfügt.

Hinweise

Die OnDisplayModeChanged -Methode stellt eine Implementierung für die Basismethode in der ToolZone -Klasse bereit.

Der Hauptzweck der OnDisplayModeChanged -Methode besteht darin, eine Webseite so vorzubereiten, dass sie in den Bearbeitungsanzeigemodus eintritt oder diesen beendet. Die -Methode zerstört alle in der Zone enthaltenen Steuerelemente und ruft dann die Basismethode auf, die das DisplayModeChanged -Ereignis im WebPartManager -Steuerelement auslöst.

Hinweise für Vererber

Die OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) -Methode kann in einem benutzerdefinierten Editorzonensteuerelement, das von der EditorZoneBase -Klasse oder - EditorZone Klasse erbt, überschrieben oder programmgesteuert aufgerufen werden.

Gilt für:

Weitere Informationen