ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Methode
Definition
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 -> unitProtected Overridable Sub OnClick (e As DesignerRegionMouseEventArgs)Parameter
Ein DesignerRegionMouseEventArgs Objekt, das die Position und ggf. den Bereich des Steuerelement-Designers angibt, auf den der Benutzer geklickt hat.
Beispiele
Das folgende Codebeispiel zeigt, wie Sie einen Handler für das OnClick Ereignis in einem klickbaren Bereich des Steuerelements verwenden und ein DesignerRegionMouseEventArgs Objekt verwenden, um den Bereich zu identifizieren, auf den 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 oder beendet den Bearbeitungsmodus der Vorlage für das Steuerelement.
Die ControlDesigner Klasse stellt einen Standarddelegat zum Behandeln des IControlDesignerView.ViewEvent Ereignisses bereit. Klassen, die von der ControlDesigner Außerkraftsetzung der OnClick Methode abgeleitet werden, um Ereignisse zu verarbeiten, die ausgelöst werden, wenn der Benutzer auf ein Steuerelement klickt.
Mit der OnClick Methode können abgeleitete Klassen das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik 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 er nicht NULL ist, wird der angeklickte Bereich (falls vorhanden) in der Region Eigenschaft angegeben.
