TreeView.HotTracking Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un valore che indica se un'etichetta del nodo dell'albero assume l'aspetto di un collegamento ipertestuale al passaggio del mouse su di essa.

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

Valore della proprietà

Boolean

true se l'etichetta di un nodo della struttura ad albero assume l'aspetto di un collegamento ipertestuale al passaggio del mouse su di essa; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio di codice seguente viene illustrato un oggetto personalizzato TreeView. Ereditando la TreeView classe , questa versione personalizzata ha tutte le funzionalità di un tipico TreeViewoggetto . La modifica di vari valori di proprietà nel costruttore fornisce un aspetto univoco. Poiché la ShowPlusMinus proprietà è impostata su false, il controllo personalizzato esegue anche l'override del OnAfterSelect metodo in modo che i nodi possano essere espansi e compressi quando vengono selezionati.

Un controllo personalizzato in questo modo può essere usato in tutta un'organizzazione, semplificando la creazione di un'interfaccia coerente senza richiedere che le proprietà del controllo vengano specificate in ogni singolo progetto.

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

Commenti

Se la CheckBoxes proprietà è impostata su true, la HotTracking proprietà non ha alcun effetto.

Nota

Quando la HotTracking proprietà è impostata su true, ogni etichetta del nodo della struttura ad albero assume l'aspetto di un collegamento ipertestuale quando il puntatore del mouse passa su di esso. Lo Underline stile del carattere viene applicato a Font e l'oggetto ForeColor è impostato su blu per fare in modo che l'etichetta venga visualizzata come collegamento. L'aspetto non è controllato dalle impostazioni Internet del sistema operativo dell'utente.