EditorZoneBase.OnDisplayModeChanged Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Genera l'evento DisplayModeChanged e distrugge tutti i controlli EditorPart e i controlli figlio nella zona in preparazione dell'entrata o dell'uscita di una pagina Web dalla modalità di modifica.

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)

Parametri

sender

Object

Oggetto Object che genera l'evento DisplayModeChanged.

e

WebPartDisplayModeEventArgs

Oggetto WebPartDisplayModeEventArgs che contiene i dati dell'evento.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del OnDisplayModeChanged metodo in una classe derivata. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento panoramica della EditorZoneBase classe.

La zona dell'editor EditorZone personalizzato deriva dalla classe in modo che possa essere usata con un modello di zona nel markup dichiarativo della pagina Web. La classe personalizzata esegue l'override OnDisplayModeChanged del metodo, impostando il colore di sfondo della zona su un colore specificato e quindi chiama il metodo di base, che elimina tutti i controlli figlio e EditorPart in preparazione per l'immissione o l'uscita dalla modalità di visualizzazione della modifica.

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

Quando si carica la pagina in un browser, è possibile selezionare Modalità di modifica nel controllo elenco a discesa per passare alla modalità di modifica. È possibile fare clic sul menu verbi (freccia giù) nella barra del titolo di uno dei controlli e fare clic su Modifica per modificare il controllo selezionato. Quando il controllo e la EditorZone modifica dell'interfaccia utente sono visibili, è possibile notare che la zona ha il colore di sfondo specificato nel codice.

Commenti

Il OnDisplayModeChanged metodo fornisce un'implementazione per il metodo di base nella ToolZone classe .

Lo scopo principale del OnDisplayModeChanged metodo è preparare una pagina Web per immettere o uscire dalla modalità di visualizzazione di modifica. Il metodo elimina tutti i controlli contenuti nella zona e quindi chiama il metodo di base, che genera l'evento DisplayModeChanged nel WebPartManager controllo.

Note per gli eredi

Il OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) metodo può essere sottoposto a override o chiamato a livello di codice in un controllo zona dell'editor personalizzato che eredita dalla classe o dalla EditorZoneBaseEditorZone classe.

Vedi anche

• ASP.NET controlli web part