Guide pratique pour ajouter des informations personnalisées à un contrôle TreeView ou ListView (Windows Forms)

Vous pouvez créer un nœud dérivé dans un contrôle Windows Forms TreeView ou un élément dérivé dans un ListView contrôle. La dérivation vous permet d’ajouter les champs dont vous avez besoin, ainsi que des méthodes et des constructeurs personnalisés pour traiter les champs. Une utilisation de cette fonctionnalité consiste à attacher un objet Customer à chaque élément de liste ou nœud de l’arborescence. Les exemples ici concernent un TreeView contrôle, mais la même approche peut être utilisée pour un ListView contrôle.

Pour dériver un nœud d’arborescence

• Créez une classe de nœud, dérivée de la TreeNode classe, qui a un champ personnalisé pour enregistrer un chemin d’accès au fichier.

  Class myTreeNode  
     Inherits TreeNode  
  
     Public FilePath As String  
  
     Sub New(ByVal fp As String)  
        MyBase.New()  
        FilePath = fp  
        Me.Text = fp.Substring(fp.LastIndexOf("\"))  
     End Sub  
  End Class  
  

  class myTreeNode : TreeNode  
  {  
     public string FilePath;  
  
     public myTreeNode(string fp)  
     {  
        FilePath = fp;  
        this.Text = fp.Substring(fp.LastIndexOf("\\"));  
     }  
  }  
  

  ref class myTreeNode : public TreeNode  
  {  
  public:  
     System::String ^ FilePath;  
  
     myTreeNode(System::String ^ fp)  
     {  
        FilePath = fp;  
        this->Text = fp->Substring(fp->LastIndexOf("\\"));  
     }  
  };  
  

Pour utiliser un nœud d’arborescence dérivé

1. Vous pouvez utiliser le nouveau nœud d’arborescence dérivé en tant que paramètre pour les appels de fonction.

   Dans l’exemple ci-dessous, le chemin d’accès défini pour l’emplacement du fichier texte est le dossier Mes documents. En effet, vous pouvez supposer que la plupart des ordinateurs exécutant le système d’exploitation Windows incluent ce répertoire. Cela permet également aux utilisateurs avec des niveaux d’accès minimum au système d’exécuter l’application en toute sécurité.

   ' You should replace the bold text file
   ' in the sample below with a text file of your own choosing.  
   TreeView1.Nodes.Add(New myTreeNode (System.Environment.GetFolderPath _  
      (System.Environment.SpecialFolder.Personal) _  
      & "\ TextFile.txt ") )  
   

   // You should replace the bold text file
   // in the sample below with a text file of your own choosing.  
   // Note the escape character used (@) when specifying the path.  
   treeView1.Nodes.Add(new myTreeNode(System.Environment.GetFolderPath
      (System.Environment.SpecialFolder.Personal)
      + @"\TextFile.txt") );  
   

   // You should replace the bold text file
   // in the sample below with a text file of your own choosing.  
   treeView1->Nodes->Add(new myTreeNode(String::Concat(  
      System::Environment::GetFolderPath  
      (System::Environment::SpecialFolder::Personal),  
      "\\TextFile.txt")));  
   

2. Si vous avez passé le nœud d’arborescence et qu’il est typé en tant que TreeNode classe, vous devez effectuer un cast vers votre classe dérivée. Le cast est une conversion explicite d’un type d’objet vers un autre. Pour plus d’informations sur la conversion, consultez Conversions implicites et explicites (Visual Basic), Conversion et conversions de types (Visual C#) ou Opérateur cast : () (Visual C++).

   Public Sub TreeView1_AfterSelect(ByVal sender As Object, ByVal e As System.Windows.Forms.TreeViewEventArgs) Handles TreeView1.AfterSelect  
      Dim mynode As myTreeNode  
      mynode = CType(e.node, myTreeNode)  
      MessageBox.Show("Node selected is " & mynode.filepath)  
   End Sub  
   

   protected void treeView1_AfterSelect (object sender,  
   System.Windows.Forms.TreeViewEventArgs e)  
   {  
      myTreeNode myNode = (myTreeNode)e.Node;  
      MessageBox.Show("Node selected is " + myNode.FilePath);  
   }  
   

   private:  
      System::Void treeView1_AfterSelect(System::Object ^  sender,  
         System::Windows::Forms::TreeViewEventArgs ^  e)  
      {  
         myTreeNode ^ myNode = safe_cast<myTreeNode^>(e->Node);  
         MessageBox::Show(String::Concat("Node selected is ",
            myNode->FilePath));  
      }  
   

Voir aussi

• Contrôle TreeView
• Contrôle ListView