TreeView.HotTracking Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob eine Strukturknotenbezeichnung als Link dargestellt wird, wenn der Mauszeiger darüber bewegt wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn eine Strukturknotenbezeichnung als Link dargestellt wird, wenn der Mauszeiger darüber bewegt wird, andernfalls false. Der Standardwert ist false.

Beispiele

Das folgende Codebeispiel veranschaulicht eine angepasste TreeView. Durch das Erben der TreeView -Klasse verfügt diese benutzerdefinierte Version über die gesamte Funktionalität eines typischen TreeView. Das Ändern verschiedener Eigenschaftswerte im Konstruktor sorgt für eine eindeutige Darstellung. Da die ShowPlusMinus -Eigenschaft auf falsefestgelegt ist, überschreibt das benutzerdefinierte Steuerelement auch die OnAfterSelect -Methode, sodass Knoten erweitert und reduziert werden können, wenn sie geklickt werden.

Ein Auf diese Weise angepasstes Steuerelement kann in einer gesamten Organisation verwendet werden, sodass eine konsistente Schnittstelle problemlos bereitgestellt werden kann, ohne dass die Steuerelementeigenschaften in jedem einzelnen Projekt angegeben werden müssen.

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

Hinweise

Wenn die CheckBoxes -Eigenschaft auf truefestgelegt ist, hat die HotTracking -Eigenschaft keine Auswirkung.

Hinweis

Wenn die HotTracking -Eigenschaft auf truefestgelegt ist, übernimmt jede Strukturknotenbezeichnung die Darstellung eines Hyperlinks, während der Mauszeiger ihn übergibt. Der Underline Schriftstil wird auf den Font angewendet und auf ForeColor blau festgelegt, damit die Bezeichnung als Link angezeigt wird. Die Darstellung wird nicht durch die Interneteinstellungen des Betriebssystems des Benutzers gesteuert.