ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Aangeroepen door de ontwerphost wanneer de gebruiker op het bijbehorende besturingselement op het ontwerptijd klikt.
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)Parameters
Een DesignerRegionMouseEventArgs object dat de locatie aangeeft en mogelijk de ontwerpregio voor besturingselementen waarop de gebruiker heeft geklikt.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een handler gebruikt voor de OnClick gebeurtenis in een klikbare regio van het besturingselement en een DesignerRegionMouseEventArgs object gebruikt om de regio te identificeren waarop wordt geklikt.
Dit codevoorbeeld maakt deel uit van een groter codevoorbeeld voor de 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
Opmerkingen
De ViewEvent gebeurtenis wordt gegenereerd door de ontwerphost voor bepaalde acties op een besturingselement in het ontwerpoppervlak. Er wordt bijvoorbeeld een gebeurtenis gegenereerd voor de volgende voorwaarden:
De gebruiker klikt op het besturingselement.
De ontwerpfunctie voor besturingselementen schildert op het ontwerpoppervlak.
De gebruiker voert de bewerkingsmodus voor sjablonen voor het besturingselement in of sluit deze af.
De ControlDesigner klasse levert een standaard gedelegeerde om de IControlDesignerView.ViewEvent gebeurtenis af te handelen. Klassen die worden afgeleid van het overschrijven van ControlDesigner de methode voor het OnClick verwerken van gebeurtenissen die worden gegenereerd wanneer de gebruiker op een besturingselement klikt.
Met de OnClick methode kunnen afgeleide klassen de gebeurtenis afhandelen zonder een gemachtigde te koppelen. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een afgeleide klasse.
De standaard implementatie van de OnClick methode retourneert zonder verwerking uit te voeren.
Notities voor overnemers
Overschrijf de OnClick(DesignerRegionMouseEventArgs) methode in een klasse die is afgeleid van de ControlDesigner klasse voor het afhandelen van ontwerptijd op gebeurtenissen in het besturingselement. Als e dit niet null is, wordt de geklikte regio, indien aanwezig, opgegeven in de Region eigenschap.
