ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metoda

Odwołanie

Definicja

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

Zestaw:: System.Design.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wywoływane przez hosta projektu, gdy użytkownik kliknie skojarzą kontrolkę 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 kliknął użytkownik.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać procedury obsługi dla OnClick zdarzenia w regionie, który można kliknąć, i użyć DesignerRegionMouseEventArgs obiektu w celu zidentyfikowania regionu, który jest klikany.

Ten przykład kodu 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 wywoływane dla następujących warunków:

Użytkownik klika kontrolkę.
Projektant sterowania maluje się na powierzchni projektowej.
Użytkownik wprowadza lub zamyka tryb edycji szablonu dla kontrolki.

Klasa ControlDesigner dostarcza domyślnego delegata IControlDesignerView.ViewEvent do obsługi zdarzenia. Klasy pochodzące z ControlDesigner zastąpienia OnClick metody 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 zwraca się bez przetwarzania.

Uwagi dotyczące dziedziczenia

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

Dotyczy

Share via