EditorZoneBase.OnDisplayModeChanged Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitProtected Overrides Sub OnDisplayModeChanged (sender As Object, e As WebPartDisplayModeEventArgs)Parameter
- sender
- Object
Ein Object, das das DisplayModeChanged-Ereignis auslöst.
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.
