TreeView.HotTracking Propriété

Définition

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.Gets or sets a value indicating whether a tree node label takes on the appearance of a hyperlink as the mouse pointer passes over it.

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.true if a tree node label takes on the appearance of a hyperlink as the mouse pointer passes over it; otherwise, false. La valeur par défaut est false.The default is false.

Exemples

L’exemple de code suivant illustre un personnalisé TreeView .The following code example illustrates a customized TreeView. En héritant TreeView de la classe, cette version personnalisée possède toutes les fonctionnalités d’un type TreeView .By inheriting the TreeView class, this custom version has all the functionality of a typical TreeView. La modification de différentes valeurs de propriété dans le constructeur fournit une apparence unique.Changing various property values in the constructor provides a unique appearance. Étant donné que la ShowPlusMinus propriété a la valeur false , le contrôle personnalisé substitue également la OnAfterSelect méthode afin que les nœuds puissent être développés et réduits lorsque l’utilisateur clique dessus.Because the ShowPlusMinus property is set to false, the customized control also overrides the OnAfterSelect method so that nodes can be expanded and collapsed when they are clicked.

Un contrôle personnalisé de cette façon peut être utilisé dans toute l’organisation, ce qui facilite la fourniture d’une interface cohérente sans que les propriétés du contrôle soient spécifiées dans chaque projet individuel.A control that is customized in this way can be used throughout an organization, making it easy to provide a consistent interface without requiring the control properties to be specified in each individual project.

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é a la valeur true , la HotTracking propriété n’a aucun effet.If the CheckBoxes property is set to true, the HotTracking property has no effect.

Notes

Lorsque la HotTracking propriété a la valeur true , chaque étiquette de nœud d’arbre prend l’apparence d’un lien hypertexte lorsque le pointeur de la souris passe dessus.When the HotTracking property is set to true, each tree node label takes on the appearance of a hyperlink as the mouse pointer passes over it. Le Underline style de police est appliqué au Font et le ForeColor est défini sur bleu pour faire apparaître l’étiquette en tant que lien.The Underline font style is applied to the Font and the ForeColor is set to blue to make the label appear as a link. L’apparence n’est pas contrôlée par les paramètres Internet du système d’exploitation de l’utilisateur.The appearance is not controlled by the Internet settings of the user's operating system.

S’applique à