TabControl.TabPageCollection.Clear Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Entfernt alle Registerkarten aus der Auflistung.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Implementiert

Clear()

Beispiele

Im folgenden Codebeispiel wird zunächst ein TabControl Mit drei TabPageerstellt. In diesem Beispiel wird die Clear Methode verwendet, um alle Steuerelemente in der tabControl1 Steuerelementsammlung in einer Instanz zu löschen. Anschließend fügt tabPage2 das Beispiel der Auflistung zurück. Beachten Sie, dass die TabPages Eigenschaft verwendet wird, um die tabControl1 Steuerelementsammlung zum Entfernen (und Hinzufügen) von Registerkartenseiten aus dieser Auflistung abzurufen.

using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   TabControl^ tabControl1;
   TabPage^ tabPage1;
   TabPage^ tabPage2;
   TabPage^ tabPage3;

public:
   Form1()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage( "tabPage1" );
      this->tabPage2 = gcnew TabPage( "tabPage2" );
      this->tabPage3 = gcnew TabPage( "tabPage3" );
      
      // Populates the tabControl1 with three tab pages.
      array<TabPage^>^tabPages = {tabPage1,tabPage2,tabPage3};
      this->tabControl1->TabPages->AddRange( tabPages );
      
      // Removes all the tab pages from tabControl1.
      this->tabControl1->TabPages->Clear();
      
      // Adds the tabPage1 back to tabControl1.
      this->tabControl1->TabPages->Add( tabPage2 );
      this->tabControl1->Location = Point(25,25);
      this->tabControl1->Size = System::Drawing::Size( 250, 250 );
      this->ClientSize = System::Drawing::Size( 300, 300 );
      this->Controls->Add( tabControl1 );
   }

};

int main()
{
   Application::Run( gcnew Form1 );
}

using System.Drawing;
using System.Windows.Forms;

public class Form1 : Form
{
    private TabControl tabControl1;
    private TabPage tabPage1;
    private TabPage tabPage2;
    private TabPage tabPage3;

    public Form1()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage("tabPage1");
        this.tabPage2 = new TabPage("tabPage2");
        this.tabPage3 = new TabPage("tabPage3");

        // Populates the tabControl1 with three tab pages.
        this.tabControl1.TabPages.AddRange(new TabPage[] {
            tabPage1, tabPage2, tabPage3});

        // Removes all the tab pages from tabControl1.
        this.tabControl1.TabPages.Clear();

        // Adds the tabPage1 back to tabControl1.
        this.tabControl1.TabPages.Add(tabPage2);

        this.tabControl1.Location = new Point(25, 25);
        this.tabControl1.Size = new Size(250, 250);
        this.ClientSize = new Size(300, 300);
        this.Controls.Add(tabControl1);
    }

    static void Main() 
    {
        Application.Run(new Form1());
    }
}

Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
    Inherits Form
    Private tabControl1 As TabControl
    Private tabPage1 As TabPage
    Private tabPage2 As TabPage
    Private tabPage3 As TabPage

    Public Sub New()
        Me.tabControl1 = New TabControl()
        Me.tabPage1 = New TabPage("tabPage1")
        Me.tabPage2 = New TabPage("tabPage2")
        Me.tabPage3 = New TabPage("tabPage3")

        ' Populates the tabControl1 with three tab pages.
        Me.tabControl1.TabPages.AddRange(New TabPage() {tabPage1, tabPage2, tabPage3})

        ' Removes all the tab pages from tabControl1.
        Me.tabControl1.TabPages.Clear()

        ' Adds the tabPage1 back to tabControl1.
        Me.tabControl1.TabPages.Add(tabPage2)

        Me.tabControl1.Location = New Point(25, 25)
        Me.tabControl1.Size = New Size(250, 250)
        Me.ClientSize = New Size(300, 300)
        Me.Controls.Add(tabControl1)
    End Sub

    Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class

Siehe auch

• Remove(TabPage)