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 zerstört alle EditorPart und untergeordneten Steuerelemente in der Zone zur Vorbereitung auf eine Webseite, um in den Bearbeitungsanzeigemodus zu gelangen oder ihn zu beenden.
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 Ereignis, das das DisplayModeChanged Ereignis auslöst.
Ein WebPartDisplayModeEventArgs Objekt, das die Ereignisdaten enthält.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die OnDisplayModeChanged Methode in einer abgeleiteten Klasse überschreibt wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" des EditorZoneBase Themas "Klassenübersicht".
Die benutzerdefinierte Editorzone wird von der EditorZone Klasse abgeleitet, sodass sie mit einer Zonenvorlage im deklarativen Markup der Webseite verwendet werden kann. Die benutzerdefinierte Klasse setzt die OnDisplayModeChanged Methode außer Kraft, 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 in den Bearbeitungsmodus zu gelangen oder den Bearbeitungsmodus 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 den Bearbeitungsmodus auswählen, um zum Bearbeitungsmodus zu wechseln. Sie können auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste eines der Steuerelemente klicken und auf "Bearbeiten" klicken, um das ausgewählte Steuerelement zu bearbeiten. Wenn das Steuerelement und die Bearbeitung der EditorZone Benutzeroberfläche sichtbar sind, können Sie sehen, dass die Zone die im Code angegebene Hintergrundfarbe aufweist.
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 vorzubereiten, um den Bearbeitungsanzeigemodus einzugeben oder zu beenden. 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 der EditorZone Klasse erbt, überschrieben oder programmgesteuert aufgerufen werden.
