Udostępnij za pośrednictwem

ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.Design
Zestaw:
System.Design.dll

Wywoływana przez hosta projektu, gdy użytkownik kliknie skojarzona kontrolka w czasie projektowania.

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

DesignerRegionMouseEventArgs Obiekt, który określa lokalizację i, ewentualnie, region projektanta sterowania, który użytkownik kliknął.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać procedury obsługi dla OnClick zdarzenia w regionie z możliwością kliknięcia kontrolki i używać DesignerRegionMouseEventArgs obiektu do identyfikowania regionu, który jest klikany.

Ten przykładowy kod jest częścią większego przykładu EditableDesignerRegion kodu dla klasy .

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

Uwagi

Zdarzenie ViewEvent jest wywoływane przez hosta projektu dla niektórych akcji na kontrolce na powierzchni projektowej. Na przykład zdarzenie jest zgłaszane dla następujących warunków:

  • Użytkownik klika kontrolkę.

  • Projektant kontrolek maluje na powierzchni projektowej.

  • Użytkownik wprowadza lub zamyka tryb edycji szablonu dla kontrolki.

Klasa ControlDesigner dostarcza domyślny delegat do obsługi IControlDesignerView.ViewEvent zdarzenia. Klasy pochodne od ControlDesigner zastąpienia OnClick metody do przetwarzania zdarzeń, które są wywoływane, gdy użytkownik kliknie kontrolkę.

Metoda OnClick umożliwia klasom pochodnym obsługę zdarzenia bez dołączania delegata. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.

Domyślna implementacja OnClick metody jest zwracana bez wykonywania jakiegokolwiek przetwarzania.

Uwagi dotyczące dziedziczenia

Zastąpij metodę OnClick(DesignerRegionMouseEventArgs) w klasie pochodnej ControlDesigner z klasy w celu obsługi zdarzeń kliknięcia w czasie projektowania w kontrolce. Jeśli e parametr nie ma wartości null, kliknięty region, jeśli istnieje, jest określony we Region właściwości .

Dotyczy

Zobacz też