ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metodo

  • Riferimento

Definizione

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

Chiamato dall'host di progettazione quando l'utente fa clic su un 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, se possibile, l'area della finestra di progettazione di controlli su cui l'utente ha fatto clic.

Esempio

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

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 su un controllo nell'area di progettazione. Ad esempio, viene generato un evento per le condizioni seguenti:

  • L'utente fa clic sul controllo .

  • Progettazione controlli disegna sull'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 derivate 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. È la tecnica consigliata per la gestione dell'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