TreeView

[C#] TreeViewノード編集の方法と活用法

2025-04-15更新日: 2025-04-15

C#のTreeViewコントロールでノードを編集するには、まずTreeViewのLabelEditプロパティをtrueに設定します。

これにより、ユーザーはノードのラベルを直接編集できるようになります。

ノードの編集が開始されると、BeforeLabelEditイベントが発生し、編集が完了するとAfterLabelEditイベントが発生します。

これらのイベントを利用して、編集の制御や検証を行うことができます。

TreeViewノードの編集は、階層構造を持つデータの管理や、ユーザーが動的にデータを変更する必要があるアプリケーションで活用されます。

例えば、ファイルシステムのブラウザや、組織図の編集ツールなどで役立ちます。

目次から探す

ノード編集の設定
ノード編集イベントの活用
ノード編集の応用例
TreeViewのカスタマイズ
まとめ

ノード編集の設定

LabelEditプロパティの設定

TreeViewコントロールでノードを編集可能にするためには、まずLabelEditプロパティを設定する必要があります。

このプロパティをtrueに設定することで、ユーザーがノードのラベルを編集できるようになります。

以下は、MyFormクラス内での設定例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // TreeViewのLabelEditプロパティをtrueに設定
        treeView1.LabelEdit = true;
    }
}

この設定を行うことで、TreeView内のノードをダブルクリックすることで編集モードに入ることができます。

ノード編集の開始と終了

ノードの編集は、ユーザーがノードをダブルクリックすることで開始されます。

編集が終了するのは、ユーザーがEnterキーを押すか、他の場所をクリックしたときです。

以下のコードは、ノード編集の開始と終了を管理する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        
        // ノード編集の開始イベント
        treeView1.NodeMouseDoubleClick += (sender, e) =>
        {
            // ノードの編集を開始
            treeView1.SelectedNode.BeginEdit();
        };
        
        // ノード編集の終了イベント
        treeView1.AfterLabelEdit += (sender, e) =>
        {
            // 編集が終了した後の処理
            if (e.Label != null)
            {
                // 編集されたラベルを使用する処理
                MessageBox.Show($"新しいラベル: {e.Label}");
            }
        };
    }
}

このコードでは、ノードをダブルクリックするとBeginEditメソッドが呼ばれ、ノードの編集が開始されます。

編集が終了すると、AfterLabelEditイベントが発生し、編集されたラベルを取得することができます。

編集可能なノードの制御

特定のノードのみを編集可能にする場合、BeforeLabelEditイベントを使用して制御することができます。

このイベントを利用して、編集を許可するかどうかを判断することができます。

以下はその実装例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        
        // 編集可能なノードの制御
        treeView1.BeforeLabelEdit += (sender, e) =>
        {
            // 編集を許可するノードの条件
            if (e.Node.Text == "編集可能なノード")
            {
                e.CancelEdit = false; // 編集を許可
            }
            else
            {
                e.CancelEdit = true; // 編集を禁止
            }
        };
    }
}

このコードでは、ノードのテキストが「編集可能なノード」の場合のみ、編集を許可しています。

それ以外のノードでは編集を禁止します。

これにより、ユーザーが意図しないノードを編集することを防ぐことができます。

ノード編集イベントの活用

BeforeLabelEditイベントの使い方

BeforeLabelEditイベントは、ノードの編集が開始される前に発生します。

このイベントを利用することで、特定の条件に基づいてノードの編集を許可またはキャンセルすることができます。

以下は、BeforeLabelEditイベントを使用した例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        
        // BeforeLabelEditイベントの設定
        treeView1.BeforeLabelEdit += (sender, e) =>
        {
            // 編集を許可するノードの条件
            if (e.Node.Text == "編集可能なノード")
            {
                e.CancelEdit = false; // 編集を許可
            }
            else
            {
                e.CancelEdit = true; // 編集を禁止
            }
        };
    }
}

このコードでは、ノードのテキストが「編集可能なノード」の場合のみ、編集を許可しています。

これにより、特定のノードだけを編集可能にすることができます。

AfterLabelEditイベントの使い方

AfterLabelEditイベントは、ノードの編集が終了した後に発生します。

このイベントを利用して、編集されたラベルの値を取得したり、特定の処理を実行したりすることができます。

以下は、AfterLabelEditイベントを使用した例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        
        // AfterLabelEditイベントの設定
        treeView1.AfterLabelEdit += (sender, e) =>
        {
            // 編集がキャンセルされた場合
            if (e.Label == null)
            {
                MessageBox.Show("編集がキャンセルされました。");
                return;
            }
            
            // 編集されたラベルを使用する処理
            MessageBox.Show($"新しいラベル: {e.Label}");
        };
    }
}

このコードでは、編集がキャンセルされた場合にメッセージボックスを表示し、編集されたラベルがある場合にはその内容を表示します。

これにより、ユーザーに対してフィードバックを提供することができます。

編集イベントでの検証とキャンセル

ノードの編集中に、特定の条件を満たさない場合に編集をキャンセルすることができます。

これには、AfterLabelEditイベントを利用して、編集されたラベルの内容を検証することができます。

以下はその実装例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        
        // AfterLabelEditイベントの設定
        treeView1.AfterLabelEdit += (sender, e) =>
        {
            // 編集されたラベルの検証
            if (string.IsNullOrWhiteSpace(e.Label) || e.Label.Length < 3)
            {
                // 編集をキャンセル
                e.CancelEdit = true;
                MessageBox.Show("ラベルは3文字以上で入力してください。");
            }
        };
    }
}

このコードでは、編集されたラベルが空白または3文字未満の場合、編集をキャンセルし、ユーザーにエラーメッセージを表示します。

これにより、ユーザーが不適切なラベルを設定することを防ぐことができます。

ノード編集の応用例

ファイルシステムブラウザでの活用

TreeViewコントロールを使用してファイルシステムブラウザを作成する際、ノード編集機能を活用することで、ユーザーがフォルダやファイルの名前を直接変更できるようになります。

以下は、ファイルシステムブラウザでのノード編集の実装例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        LoadFileSystem(); // ファイルシステムを読み込むメソッド
        
        treeView1.AfterLabelEdit += (sender, e) =>
        {
            if (e.Label != null)
            {
                // ファイル名を変更する処理
                RenameFileOrFolder(e.Node.FullPath, e.Label);
            }
        };
    }
    
    private void LoadFileSystem()
    {
        // ルートディレクトリを追加する処理
    }
    
    private void RenameFileOrFolder(string oldPath, string newName)
    {
        // ファイルまたはフォルダの名前を変更する処理
    }
}

このコードでは、ファイルシステムを読み込むメソッドと、ノードのラベルが変更された際にファイルやフォルダの名前を変更する処理を実装しています。

これにより、ユーザーはTreeView上で直接名前を変更できるようになります。

組織図エディタでの活用

組織図エディタでは、ノード編集機能を利用して、社員や部門の名前を簡単に変更できるインターフェースを提供できます。

以下は、組織図エディタでのノード編集の実装例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        LoadOrganizationChart(); // 組織図を読み込むメソッド
        
        treeView1.AfterLabelEdit += (sender, e) =>
        {
            if (e.Label != null)
            {
                // 組織図のノード名を更新する処理
                UpdateEmployeeName(e.Node, e.Label);
            }
        };
    }
    
    private void LoadOrganizationChart()
    {
        // 組織図を読み込む処理
    }
    
    private void UpdateEmployeeName(TreeNode node, string newName)
    {
        // ノードの名前を更新する処理
    }
}

このコードでは、組織図を読み込むメソッドと、ノードのラベルが変更された際に社員の名前を更新する処理を実装しています。

これにより、ユーザーは組織図内のノードを直接編集できるようになります。

タスク管理ツールでの活用

タスク管理ツールでは、ノード編集機能を利用して、タスクの名前やステータスを簡単に変更できるインターフェースを提供できます。

以下は、タスク管理ツールでのノード編集の実装例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        treeView1.LabelEdit = true;
        LoadTasks(); // タスクを読み込むメソッド
        
        treeView1.AfterLabelEdit += (sender, e) =>
        {
            if (e.Label != null)
            {
                // タスクの名前を更新する処理
                UpdateTaskName(e.Node, e.Label);
            }
        };
    }
    
    private void LoadTasks()
    {
        // タスクを読み込む処理
    }
    
    private void UpdateTaskName(TreeNode node, string newName)
    {
        // タスクの名前を更新する処理
    }
}

このコードでは、タスクを読み込むメソッドと、ノードのラベルが変更された際にタスクの名前を更新する処理を実装しています。

これにより、ユーザーはタスクの名前を直接編集できるようになります。

ノード編集機能を活用することで、タスク管理がより直感的に行えるようになります。

TreeViewのカスタマイズ

ノードのドラッグ＆ドロップ

TreeViewコントロールでは、ノードのドラッグ＆ドロップ機能を実装することで、ユーザーがノードを簡単に移動できるようになります。

この機能を実装するには、ItemDrag、DragEnter、DragDropイベントを使用します。

以下は、ノードのドラッグ＆ドロップを実装する例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // ドラッグ＆ドロップを有効にする
        treeView1.AllowDrop = true;
        treeView1.ItemDrag += (sender, e) =>
        {
            // ドラッグを開始
            DoDragDrop(e.Item, DragDropEffects.Move);
        };
        
        treeView1.DragEnter += (sender, e) =>
        {
            // ドラッグされたアイテムがノードである場合
            if (e.Data.GetDataPresent(typeof(TreeNode)))
            {
                e.Effect = DragDropEffects.Move; // 移動を許可
            }
        };
        
        treeView1.DragDrop += (sender, e) =>
        {
            // ドロップされたノードを取得
            TreeNode droppedNode = (TreeNode)e.Data.GetData(typeof(TreeNode));
            TreeNode targetNode = treeView1.GetNodeAt(e.X, e.Y);
            
            if (targetNode != null && droppedNode != targetNode)
            {
                // ドロップ先にノードを追加
                targetNode.Nodes.Add((TreeNode)droppedNode.Clone());
                droppedNode.Remove(); // 元のノードを削除
            }
        };
    }
}

このコードでは、ノードをドラッグして別のノードにドロップすることで、ノードの移動が可能になります。

DoDragDropメソッドを使用してドラッグを開始し、DragEnterイベントで移動を許可し、DragDropイベントでノードを移動させています。

ノードのコンテキストメニュー

TreeViewコントロールにコンテキストメニューを追加することで、右クリック時に特定の操作を提供できます。

ContextMenuStripを使用して、ノードに対する操作を簡単に実装できます。

以下は、ノードのコンテキストメニューを実装する例です。

partial class MyForm : Form
{
    private ContextMenuStrip contextMenuStrip;
    public MyForm()
    {
        InitializeComponent();
        
        // コンテキストメニューの作成
        contextMenuStrip = new ContextMenuStrip();
        contextMenuStrip.Items.Add("ノードを追加", null, AddNode_Click);
        contextMenuStrip.Items.Add("ノードを削除", null, RemoveNode_Click);
        
        treeView1.ContextMenuStrip = contextMenuStrip;
    }
    private void AddNode_Click(object sender, EventArgs e)
    {
        // 選択されたノードに新しいノードを追加
        if (treeView1.SelectedNode != null)
        {
            treeView1.SelectedNode.Nodes.Add("新しいノード");
        }
    }
    private void RemoveNode_Click(object sender, EventArgs e)
    {
        // 選択されたノードを削除
        if (treeView1.SelectedNode != null)
        {
            treeView1.Nodes.Remove(treeView1.SelectedNode);
        }
    }
}

このコードでは、右クリック時に表示されるコンテキストメニューを作成し、ノードの追加と削除の操作を実装しています。

ContextMenuStripを使用することで、ユーザーに直感的な操作を提供できます。

ノードのアイコン変更

TreeViewコントロールでは、ノードごとに異なるアイコンを設定することができます。

これにより、ノードの種類や状態を視覚的に区別することができます。

以下は、ノードのアイコンを変更する例です。

partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        
        // 画像リストの作成
        imageList = new ImageList();
        imageList.Images.Add("folder", Properties.Resources.folderIcon); // フォルダアイコン
        imageList.Images.Add("file", Properties.Resources.fileIcon); // ファイルアイコン
        
        treeView1.ImageList = imageList;
        
        // ノードの追加とアイコンの設定
        TreeNode folderNode = new TreeNode("フォルダ", 0, 0); // フォルダアイコン
        TreeNode fileNode = new TreeNode("ファイル", 1, 1); // ファイルアイコン;
        
        treeView1.Nodes.Add(folderNode);
        folderNode.Nodes.Add(fileNode);
    }
}