ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Methode

Referenz

Definition

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

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.

Wird vom Entwurfshost aufgerufen, wenn der Benutzer zur Entwurfszeit auf das zugeordnete Steuerelement klickt.

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)

Parameter

e: DesignerRegionMouseEventArgs

Ein DesignerRegionMouseEventArgs-Objekt, das die Position sowie ggf. den Steuerelement-Designer-Bereich angibt, auf den der Benutzer geklickt hat.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie einen Handler für das OnClick Ereignis in einem klickbaren Bereich des Steuerelements verwenden und ein DesignerRegionMouseEventArgs Objekt verwenden, um die Region zu identifizieren, auf die geklickt wird.

Dieses Codebeispiel ist Teil eines größeren Codebeispiels für die EditableDesignerRegion -Klasse.

// 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

Hinweise

Das ViewEvent Ereignis wird vom Entwurfshost für bestimmte Aktionen für ein Steuerelement in der Entwurfsoberfläche ausgelöst. Beispielsweise wird ein Ereignis für die folgenden Bedingungen ausgelöst:

Der Benutzer klickt auf das Steuerelement.
Der Steuerelement-Designer zeichnet auf der Entwurfsoberfläche.
Der Benutzer wechselt in den Vorlagenbearbeitungsmodus für das Steuerelement oder beendet diese.

Die ControlDesigner -Klasse stellt einen Standarddelegat bereit, um das IControlDesignerView.ViewEvent Ereignis zu behandeln. Klassen, die von ControlDesigner der Überschreibung der OnClick -Methode abgeleitet werden, um Ereignisse zu verarbeiten, die ausgelöst werden, wenn der Benutzer auf ein Steuerelement klickt.

Die OnClick -Methode ermöglicht abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Die Standardimplementierung der OnClick Methode wird ohne Verarbeitung zurückgegeben.

Hinweise für Vererber

Überschreiben Sie die OnClick(DesignerRegionMouseEventArgs) -Methode in einer Klasse, die von der ControlDesigner -Klasse abgeleitet wird, um Entwurfszeitklickereignisse für das Steuerelement zu behandeln. Wenn e nicht NULL ist, wird die angeklickte Region (sofern vorhanden) in der Region -Eigenschaft angegeben.

Gilt für: