TreeView.HotTracking Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si une étiquette de nœud d’arbre prend l’apparence d’un lien hypertexte lorsque le pointeur de la souris passe dessus.

public:
 property bool HotTracking { bool get(); void set(bool value); };

public bool HotTracking { get; set; }

member this.HotTracking : bool with get, set

Public Property HotTracking As Boolean

Valeur de propriété

Boolean

true si une étiquette de nœud d'arbre prend l'apparence d'un lien hypertexte lorsque le pointeur de la souris passe dessus ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple de code suivant illustre une personnalisation TreeView. En héritant de la TreeView classe, cette version personnalisée a toutes les fonctionnalités d’une version classique TreeView. La modification de différentes valeurs de propriété dans le constructeur offre une apparence unique. Étant donné que la ShowPlusMinus propriété est définie falsesur , le contrôle personnalisé remplace également la OnAfterSelect méthode afin que les nœuds puissent être développés et réduits lorsqu’ils cliquent dessus.

Un contrôle personnalisé de cette façon peut être utilisé au sein d’une organisation, ce qui facilite la fourniture d’une interface cohérente sans que les propriétés de contrôle soient spécifiées dans chaque projet individuel.

public ref class CustomizedTreeView: public TreeView
{
public:
   CustomizedTreeView()
   {

      // Customize the TreeView control by setting various properties.
      BackColor = System::Drawing::Color::CadetBlue;
      FullRowSelect = true;
      HotTracking = true;
      Indent = 34;
      ShowPlusMinus = false;

      // The ShowLines property must be false for the FullRowSelect
      // property to work.
      ShowLines = false;
   }

protected:
   virtual void OnAfterSelect( TreeViewEventArgs^ e ) override
   {
      // Confirm that the user initiated the selection.
      // This prevents the first node from expanding when it is
      // automatically selected during the initialization of
      // the TreeView control.
      if ( e->Action != TreeViewAction::Unknown )
      {
         if ( e->Node->IsExpanded )
         {
            e->Node->Collapse();
         }
         else
         {
            e->Node->Expand();
         }
      }

      
      // Remove the selection. This allows the same node to be
      // clicked twice in succession to toggle the expansion state.
      SelectedNode = nullptr;
   }
};

public class CustomizedTreeView : TreeView
{
    public CustomizedTreeView()
    {
        // Customize the TreeView control by setting various properties.
        BackColor = System.Drawing.Color.CadetBlue;
        FullRowSelect = true;
        HotTracking = true;
        Indent = 34;
        ShowPlusMinus = false;

        // The ShowLines property must be false for the FullRowSelect 
        // property to work.
        ShowLines = false;
    }

    protected override void OnAfterSelect(TreeViewEventArgs e)
    {
        // Confirm that the user initiated the selection.
        // This prevents the first node from expanding when it is
        // automatically selected during the initialization of 
        // the TreeView control.
        if (e.Action != TreeViewAction.Unknown)
        {
            if (e.Node.IsExpanded) 
            {
                e.Node.Collapse();
            }
            else 
            {
                e.Node.Expand();
            }
        }

        // Remove the selection. This allows the same node to be
        // clicked twice in succession to toggle the expansion state.
        SelectedNode = null;
    }
}

Public Class CustomizedTreeView
    Inherits TreeView

    Public Sub New()
        ' Customize the TreeView control by setting various properties.
        BackColor = System.Drawing.Color.CadetBlue
        FullRowSelect = True
        HotTracking = True
        Indent = 34
        ShowPlusMinus = False

        ' The ShowLines property must be false for the FullRowSelect 
        ' property to work.
        ShowLines = False
    End Sub


    Protected Overrides Sub OnAfterSelect(ByVal e As TreeViewEventArgs)
        ' Confirm that the user initiated the selection.
        ' This prevents the first node from expanding when it is
        ' automatically selected during the initialization of 
        ' the TreeView control.
        If e.Action <> TreeViewAction.Unknown Then
            If e.Node.IsExpanded Then
                e.Node.Collapse()
            Else
                e.Node.Expand()
            End If
        End If

        ' Remove the selection. This allows the same node to be
        ' clicked twice in succession to toggle the expansion state.
        SelectedNode = Nothing
    End Sub

End Class

Remarques

Si la CheckBoxes propriété est définie truesur , la HotTracking propriété n’a aucun effet.

Notes

Lorsque la HotTracking propriété est définie truesur , chaque étiquette de nœud d’arbre prend l’apparence d’un lien hypertexte lorsque le pointeur de la souris passe dessus. Le Underline style de police est appliqué à celui-ci Font et il ForeColor est défini sur bleu pour que l’étiquette apparaisse en tant que lien. L’apparence n’est pas contrôlée par les paramètres Internet du système d’exploitation de l’utilisateur.