Button.Delete-Methode

Artikel
08/10/2011

Löscht ein dynamisch erstelltes Button aus dem Dokument und entfernt es aus der ControlCollection.

Namespace: Microsoft.Office.Tools.Word.Controls
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
Public Sub Delete

public void Delete()

Hinweise

Diese Methode darf nur mit einem Button verwendet werden, das zur Laufzeit programmgesteuert erstellt wird. Wenn Sie diese Methode für ein Button aufrufen, das dem Dokument zur Entwurfszeit hinzugefügt wurde, wird eine Ausnahme ausgelöst.

Beispiele

Im folgenden Codebeispiel wird ein Button-Steuerelement veranschaulicht, das sich selbst löscht, wenn darauf geklickt wird. Der Click-Ereignishandler der Schaltfläche ruft die Delete-Methode auf, um die Schaltfläche zu löschen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub DeleteControl()
    Dim DeleteButton As Microsoft.Office.Tools.Word.Controls.Button = _
        Me.Controls.AddButton(25, 75, 80, 30, "DeleteButton")
    DeleteButton.Text = "Click to delete"
    AddHandler DeleteButton.Click, AddressOf DeleteButton_Click
End Sub

' Delete the clicked button.
Private Sub DeleteButton_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim ClickedButton As Microsoft.Office.Tools.Word.Controls.Button = _
        CType(sender, Microsoft.Office.Tools.Word.Controls.Button)

    ClickedButton.Delete()
End Sub

private void DeleteControl()
{
    Microsoft.Office.Tools.Word.Controls.Button deleteButton =
        this.Controls.AddButton(25, 75, 80, 30, "deleteButton");
    deleteButton.Text = "Click to delete";
    deleteButton.Click += new EventHandler(deleteButton_Click);
}

// Delete the clicked button.
void deleteButton_Click(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Word.Controls.Button clickedButton =
        (Microsoft.Office.Tools.Word.Controls.Button)sender;

    clickedButton.Delete();
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Button Klasse

Microsoft.Office.Tools.Word.Controls-Namespace

Freigeben über