ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Methode

Definition

Wird vom Entwurfshost aufgerufen, wenn der Benutzer zur Entwurfszeit auf das zugeordnete Steuerelement klickt.Called by the design host when the user clicks the associated control at design time.

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.A DesignerRegionMouseEventArgs object that specifies the location and, possibly, the control designer region that the user clicked.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie ein Handler für das- OnClick Ereignis in einem klickbaren Bereich des-Steuer Elements verwendet wird und wie ein- DesignerRegionMouseEventArgs Objekt verwendet wird, um den Bereich zu identifizieren, auf den geklickt wird.The following code example shows how to use a handler for the OnClick event in a clickable region of the control and use a DesignerRegionMouseEventArgs object to identify the region that is being clicked.

Dieses Codebeispiel ist Teil eines größeren Code Beispiels für die- EditableDesignerRegion Klasse.This code example is part of a larger code example for the EditableDesignerRegion class.

// 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 Entwurfs Host für bestimmte Aktionen auf einem-Steuerelement in der Entwurfs Oberfläche ausgelöst.The ViewEvent event is raised by the design host for certain actions on a control in the design surface. Beispielsweise wird ein Ereignis für die folgenden Bedingungen ausgelöst:For example, an event is raised for the following conditions:

  • Der Benutzer klickt auf das-Steuerelement.The user clicks the control.

  • Der Steuerelement-Designer zeichnet die Entwurfs Oberfläche.The control designer paints on the design surface.

  • Der Benutzer wechselt in den Vorlagen Bearbeitungsmodus für das Steuerelement oder beendet ihn.The user enters or exits template editing mode for the control.

Die-Klasse stellt einen Standard Delegaten bereit ControlDesigner , um das Ereignis zu behandeln IControlDesignerView.ViewEvent .The ControlDesigner class supplies a default delegate to handle the IControlDesignerView.ViewEvent event. Von abgeleitete Klassen ControlDesigner überschreiben die- OnClick Methode zum Verarbeiten von Ereignissen, die ausgelöst werden, wenn der Benutzer auf ein Steuerelement klickt.Classes deriving from ControlDesigner override the OnClick method to process events that are raised when the user clicks a control.

Mit der- OnClick Methode können abgeleitete Klassen das-Ereignis behandeln, ohne einen Delegaten anzufügen.The OnClick method allows derived classes to handle the event without attaching a delegate. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.This is the preferred technique for handling the event in a derived class.

Die Standard Implementierung der- OnClick Methode wird zurückgegeben, ohne dass eine Verarbeitung durchgeführt wird.The default implementation of the OnClick method returns without performing any processing.

Hinweise für Vererber

Überschreiben OnClick(DesignerRegionMouseEventArgs) Sie die-Methode in einer Klasse, die von der-Klasse abgeleitet wird ControlDesigner , um für das Steuerelement Entwurfszeit-Click-EreignisseOverride the OnClick(DesignerRegionMouseEventArgs) method in a class deriving from the ControlDesigner class to handle design-time click events on the control. Wenn e nicht NULL ist, wird der angeklickte Bereich, sofern vorhanden, in der- Region Eigenschaft angegeben.If e is not null, the clicked region, if any, is specified in the Region property.

Gilt für:

Siehe auch