ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metodo

Riferimento

Definizione

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

Assembly:: System.Design.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 in un'area selezionabile del controllo e usare un DesignerRegionMouseEventArgs oggetto per identificare l'area OnClick 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 del controllo disegna sull'area di progettazione.
L'utente immette o chiude la modalità di modifica dei modelli 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 collegare 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 ControlDesigner del OnClick(DesignerRegionMouseEventArgs) metodo in una classe derivata dalla classe per gestire gli eventi di progettazione clic sul controllo. Se e non è Null, l'area selezionata, se presente, viene specificata nella Region proprietà.

Si applica a

Condividi tramite