TreeNode.BeginEdit メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

TreeNode.cs

ツリー ノードのラベルの編集を開始します。

C#

public void BeginEdit();

例外

InvalidOperationException

LabelEdit が false に設定されます。

例

次のコード例では、 を使用して、ユーザーが非ルート ツリー ノードを ContextMenu編集できます。 ユーザーがマウスを右クリックすると、その位置にある TreeNode が決定され、 という名前 mySelectedNodeの変数に格納されます。 非ルート ツリー ノードが選択されている場合は、編集可能な状態になり、ユーザーはノード ラベルを編集できます。 ユーザーがツリー ノード ラベルの編集を停止すると、新しいラベル テキストが評価されて保存されます。 この例では、ラベル テキストでは複数の文字が無効と見なされます。 無効な文字のいずれかがラベル文字列内にある場合、または文字列が空の場合、ユーザーにエラーが通知され、ラベルが前のテキストに返されます。

C#

/* Get the tree node under the mouse pointer and
   save it in the mySelectedNode variable. */
private void treeView1_MouseDown(object sender,
  System.Windows.Forms.MouseEventArgs e)
{
   mySelectedNode = treeView1.GetNodeAt(e.X, e.Y);
}

private void menuItem1_Click(object sender, System.EventArgs e)
{
   if (mySelectedNode != null && mySelectedNode.Parent != null)
   {
      treeView1.SelectedNode = mySelectedNode;
      treeView1.LabelEdit = true;
      if(!mySelectedNode.IsEditing)
      {
         mySelectedNode.BeginEdit();
      }
   }
   else
   {
      MessageBox.Show("No tree node selected or selected node is a root node.\n" +
         "Editing of root nodes is not allowed.", "Invalid selection");
   }
}

private void treeView1_AfterLabelEdit(object sender,
         System.Windows.Forms.NodeLabelEditEventArgs e)
{
   if (e.Label != null)
   {
     if(e.Label.Length > 0)
     {
        if (e.Label.IndexOfAny(new char[]{'@', '.', ',', '!'}) == -1)
        {
           // Stop editing without canceling the label change.
           e.Node.EndEdit(false);
        }
        else
        {
           /* Cancel the label edit action, inform the user, and
              place the node in edit mode again. */
           e.CancelEdit = true;
           MessageBox.Show("Invalid tree node label.\n" +
              "The invalid characters are: '@','.', ',', '!'",
              "Node Label Edit");
           e.Node.BeginEdit();
        }
     }
     else
     {
        /* Cancel the label edit action, inform the user, and
           place the node in edit mode again. */
        e.CancelEdit = true;
        MessageBox.Show("Invalid tree node label.\nThe label cannot be blank",
           "Node Label Edit");
        e.Node.BeginEdit();
     }
   }
}

注釈

このメソッドを使用する一般的なシナリオは、 または ContextMenuのMenuItemイベントでClick呼び出す場合です。

注意

このメソッドは、 の TreeView プロパティが LabelEdit にtrue設定されている場合にのみ機能します。 が にfalse設定されている場合LabelEdit、例外がスローされ、ツリー ノードは編集可能な状態になりません。

適用対象

こちらもご覧ください

• EndEdit(Boolean)
• IsEditing