ControlCollection.Remove メソッド (String)

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

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

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

構文

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

bool Remove(
    string name
)

パラメーター

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

戻り値

型: System.Boolean

解説

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

例

次のコード例は、Button コントロールと MonthCalendar コントロールを文書に追加し、Button コントロールを削除します。

Private Sub WordControlRemove()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(0, 0, 56.25F, 17.25F, "Button1")
    Dim MonthCalendar1 As Microsoft.Office.Tools.Word.Controls. _
        MonthCalendar = Me.Controls.AddMonthCalendar(0, 20, _
        75, 15, "MonthCalendar1")
    Me.Controls.Remove("Button1")
End Sub

private void WordControlRemove()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25F, 17.25F,
        "button1");
    Microsoft.Office.Tools.Word.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         0, 20, 75, 15, "monthCalendar1");
    this.Controls.Remove("button1");
}