ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metod

Definition

Namnområde:
System.Web.UI.Design
Sammansättning:
System.Design.dll

Anropas av designvärden när användaren klickar på den associerade kontrollen vid designtillfället.

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)

Parametrar

e
DesignerRegionMouseEventArgs

Ett DesignerRegionMouseEventArgs objekt som anger platsen och eventuellt den kontrolldesignerregion som användaren klickade på.

Exempel

Följande kodexempel visar hur du använder en hanterare för OnClick händelsen i en klickbar region i kontrollen och använder ett DesignerRegionMouseEventArgs objekt för att identifiera den region som klickas på.

Det här kodexemplet är en del av ett större kodexempel för EditableDesignerRegion klassen.

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

Kommentarer

Händelsen ViewEvent utlöses av designvärden för vissa åtgärder på en kontroll på designytan. En händelse aktiveras till exempel för följande villkor:

  • Användaren klickar på kontrollen.

  • Kontrolldesignern målar på designytan.

  • Användaren går in i eller avslutar mallredigeringsläget för kontrollen.

Klassen ControlDesigner tillhandahåller ett standarddelegat för att hantera IControlDesignerView.ViewEvent händelsen. Klasser som härleds från ControlDesigner åsidosätter OnClick metoden för att bearbeta händelser som genereras när användaren klickar på en kontroll.

Metoden OnClick gör det möjligt för härledda klasser att hantera händelsen utan att koppla ett ombud. Det här är den bästa tekniken för att hantera händelsen i en härledd klass.

Standardimplementeringen OnClick av metoden returnerar utan bearbetning.

Anteckningar till arvingar

Åsidosätt OnClick(DesignerRegionMouseEventArgs) metoden i en klass som härleds från ControlDesigner klassen för att hantera händelser för designtidsklicka på kontrollen. Om e inte är null anges den klickade regionen, om någon, i Region egenskapen.

Gäller för

Se även