ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.Design
Sestavení:
System.Design.dll

Volá se hostitelem návrhu, když uživatel klikne na přidružený ovládací prvek v době návrhu.

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)

Parametry

e
DesignerRegionMouseEventArgs

Objekt DesignerRegionMouseEventArgs , který určuje umístění a případně oblast návrháře ovládacího prvku, na kterou uživatel klikl.

Příklady

Následující příklad kódu ukazuje, jak použít obslužnou rutinu OnClick pro událost v oblasti ovládacího prvku, na kterou lze kliknout, a použít DesignerRegionMouseEventArgs objekt k identifikaci oblasti, na kterou se kliká.

Tento příklad kódu je součástí většího příkladu EditableDesignerRegion kódu pro třídu .

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

Poznámky

Událost ViewEvent je vyvolána hostitelem návrhu pro určité akce na ovládacím prvku v návrhové ploše. Událost je vyvolána například za následujících podmínek:

  • Uživatel klikne na ovládací prvek.

  • Návrhář ovládacích prvků maluje na návrhové ploše.

  • Uživatel přejde do režimu úprav šablony ovládacího prvku nebo ho ukončí.

Třída ControlDesigner poskytuje výchozího delegáta pro zpracování IControlDesignerView.ViewEvent události. Třídy odvozené z ControlDesigner přepisují metodu OnClick zpracování událostí, které jsou vyvolány při kliknutí uživatele na ovládací prvek.

Metoda OnClick umožňuje odvozeným třídám zpracovat událost bez připojení delegáta. Toto je upřednostňovaná technika pro zpracování události v odvozené třídě.

Výchozí implementace OnClick metody vrátí bez provedení zpracování.

Poznámky pro dědice

Přepište metodu OnClick(DesignerRegionMouseEventArgs) ve třídě odvozené od ControlDesigner třídy pro zpracování událostí kliknutí v době návrhu ovládacího prvku. Pokud e není null, je ve vlastnosti zadána oblast, na které jste kliknuli Region (pokud existuje).

Platí pro

Viz také