Partager via


ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Méthode

Définition

Appelé par l'hôte de conception lorsque l'utilisateur clique sur le contrôle associé au moment du design.

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)

Paramètres

e
DesignerRegionMouseEventArgs

Objet DesignerRegionMouseEventArgs qui spécifie l'emplacement et peut-être la zone du Concepteur de contrôles sur laquelle l'utilisateur a cliqué.

Exemples

L’exemple de code suivant montre comment utiliser un gestionnaire pour l’événement OnClick dans une région cliquable du contrôle et utiliser un DesignerRegionMouseEventArgs objet pour identifier la région sur laquelle on clique.

Cet exemple de code fait partie d’un exemple de code plus grand pour la EditableDesignerRegion classe .

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

Remarques

L’événement ViewEvent est déclenché par l’hôte de conception pour certaines actions sur un contrôle dans l’aire de conception. Par exemple, un événement est déclenché pour les conditions suivantes :

  • L’utilisateur clique sur le contrôle.

  • Le concepteur de contrôles peint sur l’aire de conception.

  • L’utilisateur entre ou quitte le mode d’édition du modèle pour le contrôle.

La ControlDesigner classe fournit un délégué par défaut pour gérer l’événement IControlDesignerView.ViewEvent . Les classes dérivées de ControlDesigner remplacent la OnClick méthode pour traiter les événements déclenchés lorsque l’utilisateur clique sur un contrôle.

La OnClick méthode permet aux classes dérivées de gérer l’événement sans attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

L’implémentation par défaut de la OnClick méthode retourne sans effectuer de traitement.

Notes pour les héritiers

Remplacez la OnClick(DesignerRegionMouseEventArgs) méthode dans une classe dérivant de la ControlDesigner classe pour gérer les événements de clic au moment du design sur le contrôle. Si e n’est pas null, la région sur laquelle vous avez cliqué, le cas échéant, est spécifiée dans la Region propriété .

S’applique à

Voir aussi