Compartilhar via


Método Button.Delete

Exclui Button criado dinamicamente a planilha e remova-o de ControlCollection.

Namespace:  Microsoft.Office.Tools.Excel.Controls
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Function Delete As Object
public Object Delete()

Valor de retorno

Tipo: System.Object

Comentários

Este método só deve ser usado com Button que é criado por programação em tempo de execução. Uma exceção é lançada se você chamar esse método em Button que é adicionado à planilha em tempo de design.

Exemplos

O exemplo de código a seguir demonstra um controle de Button que se excluir quando o usuário clica. O manipulador de eventos Click do botão chama o método de Delete para excluir o botão.

Este exemplo é para uma personalização de um documento nível.

Private Sub DeleteControl()
    Dim DeleteButton As Microsoft.Office.Tools.Excel.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.Excel.Controls.Button = _
        CType(sender, Microsoft.Office.Tools.Excel.Controls.Button)

    ClickedButton.Delete()
End Sub
        private void DeleteControl()
        {
            Microsoft.Office.Tools.Excel.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.Excel.Controls.Button clickedButton =
                (Microsoft.Office.Tools.Excel.Controls.Button)sender;

            clickedButton.Delete();
        }

Segurança do .NET Framework

Consulte também

Referência

Button Classe

Namespace Microsoft.Office.Tools.Excel.Controls