ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metodo

Definizione

Spazio dei nomi:
System.Web.UI.Design
Assembly:
System.Design.dll

Chiamato dall'host di progettazione quando l'utente fa clic sul controllo associato in fase di progettazione.

protected:
 virtual void OnClick(System::Web::UI::Design::DesignerRegionMouseEventArgs ^ e);
protected virtual void OnClick(System.Web.UI.Design.DesignerRegionMouseEventArgs e);
abstract member OnClick : System.Web.UI.Design.DesignerRegionMouseEventArgs -> unit
override this.OnClick : System.Web.UI.Design.DesignerRegionMouseEventArgs -> unit
Protected Overridable Sub OnClick (e As DesignerRegionMouseEventArgs)

Parametri

e
DesignerRegionMouseEventArgs

Oggetto DesignerRegionMouseEventArgs che specifica la posizione e, eventualmente, l'area della finestra di progettazione del controllo selezionata dall'utente.

Esempio

Nell'esempio di codice seguente viene illustrato come usare un gestore per l'evento in un'area OnClick selezionabile del controllo e usare un DesignerRegionMouseEventArgs oggetto per identificare l'area su cui si fa clic.

Questo esempio di codice fa parte di un esempio di codice più grande per la EditableDesignerRegion classe .

// Handler for the Click event, which provides the region in the arguments.
protected override void OnClick(DesignerRegionMouseEventArgs e)
{
    if (e.Region == null)
        return;

    // If the clicked region is not a header, return
    if (e.Region.Name.IndexOf("Header") != 0)
        return;

    // Switch the current view if required
    if (e.Region.Name.Substring(6, 1) != myControl.CurrentView.ToString())
    {
        myControl.CurrentView = int.Parse(e.Region.Name.Substring(6, 1));
        base.UpdateDesignTimeHtml();
    }
}

' Handler for the Click event, which provides the region in the arguments.
Protected Overrides Sub OnClick(ByVal e As DesignerRegionMouseEventArgs)
    If IsNothing(e.Region) Then
        Return
    End If

    ' If the clicked region is not a header, return
    If e.Region.Name.IndexOf("Header") <> 0 Then
        Return
    End If

    ' Switch the current view if required
    If e.Region.Name.Substring(6, 1) <> myControl.CurrentView.ToString() Then
        myControl.CurrentView = Integer.Parse(e.Region.Name.Substring(6, 1))
        MyBase.UpdateDesignTimeHtml()
    End If
End Sub

Commenti

L'evento ViewEvent viene generato dall'host di progettazione per determinate azioni in un controllo nell'area di progettazione. Ad esempio, viene generato un evento per le condizioni seguenti:

  • L'utente fa clic sul controllo.

  • La finestra di progettazione dei controlli disegna nell'area di progettazione.

  • L'utente entra o esce dalla modalità di modifica del modello per il controllo.

La ControlDesigner classe fornisce un delegato predefinito per gestire l'evento IControlDesignerView.ViewEvent . Le classi che derivano dall'override ControlDesigner del OnClick metodo per elaborare gli eventi generati quando l'utente fa clic su un controllo.

Il OnClick metodo consente alle classi derivate di gestire l'evento senza associare un delegato. Questa è la tecnica preferita per gestire l'evento in una classe derivata.

L'implementazione predefinita del OnClick metodo restituisce senza eseguire alcuna elaborazione.

Note per gli eredi

Eseguire l'override del OnClick(DesignerRegionMouseEventArgs) metodo in una classe derivata dalla ControlDesigner classe per gestire gli eventi di clic in fase di progettazione nel controllo . Se e non è Null, l'area selezionata, se presente, viene specificata nella Region proprietà .

Si applica a

Vedi anche