ControlCollection.Remove メソッド (String)

[アーティクル]
08/09/2011

指定した名前のコントロールを ControlCollection インスタンスから削除します。

名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)

構文

'宣言
Function Remove ( _
    name As String _
) As Boolean

bool Remove(
    string name
)

パラメーター

name
型: System.String
ControlCollection インスタンスから削除するコントロールの名前。

戻り値

型: System.Boolean

解説

デザイン時に追加されたコントロールは ControlCollection インスタンスから削除できません。 Remove メソッドを使用して削除できるのは、実行時に追加したコントロールのみです。

例

次のコード例は、Button コントロールと MonthCalendar コントロールをワークシートに追加します。ボタンがクリックされると、MonthCalendar コントロールを削除します。

Private Sub ExcelControlRemove()

    Dim Button1 As Microsoft.Office.Tools.Excel. _
        Controls.Button = Me.Controls.AddButton( _
        0, 0, 56.25, 17.25, "Button1")
    Dim MonthCalendar1 As Microsoft.Office.Tools. _
        Excel.Controls.MonthCalendar = Me.Controls. _
        AddMonthCalendar(0, 20, 75, 15, "MonthCalendar1")

    Button1.Text = "Remove"

    AddHandler Button1.Click, AddressOf Button1_Click

End Sub
Private Sub Button1_Click(ByVal sender As Object, ByVal e As _
    EventArgs)

    Me.Controls.Remove("MonthCalendar1")

End Sub

private void ExcelControlRemove()
{

    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25, 17.25,
        "button1");
    Microsoft.Office.Tools.Excel.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         0, 20, 75, 15, "monthCalendar1");
    button1.Text = "Remove";
    button1.Click += new EventHandler(button1_Click);

}

void button1_Click(object sender, EventArgs e)
{
    this.Controls.Remove("monthCalendar1");
}