Język

ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Metoda

Definicja

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

Wywoływany 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, który można kliknąć w regionie kontrolki, 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 kontrolek maluje na powierzchni projektowej.

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

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

Notatki 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 nie ma wartości null, kliknięty region, jeśli istnieje, jest określony we Region właściwości .

Dotyczy

Zobacz też