TabControl.TabPageCollection.Contains-Methode

Bestimmt, ob sich eine angegebene Registerkarte in der Auflistung befindet.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Function Contains ( _
    page As TabPage _
) As Boolean
'Usage
Dim instance As TabPageCollection
Dim page As TabPage
Dim returnValue As Boolean

returnValue = instance.Contains(page)

public bool Contains (
    TabPage page
)

public:
bool Contains (
    TabPage^ page
)

public boolean Contains (
    TabPage page
)

public function Contains (
    page : TabPage
) : boolean

Parameter

• page
  Die TabPage, die in der Auflistung gesucht werden soll.

Rückgabewert

true, wenn sich die angegebene TabPage in der Auflistung befindet, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der Wert von page ist NULL (Nothing in Visual Basic).

Beispiel

Im folgenden Codebeispiel wird zunächst ein TabControl mit drei TabPage-Objekten erstellt. Die beiden ersten Registerkarten werden mit der AddRange-Methode direkt zu tabControl1 hinzugefügt. Mit der Contains-Methode wird bestimmt, ob tabPage3 Teil der Controls-Auflistung von tabControl1 ist. Da die tabPage3-Registerkarte nicht in dieser Auflistung gefunden wird, wird sie durch die Add-Methode hinzugefügt.

Verwenden Sie für dieses Beispiel den System.Drawing-Namespace und den System.Windows.Forms-Namespace.

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()
        Dim tabText As String() = {"tabPage1", "tabPage2", "tabPage3"}
        Me.tabPage1 = New TabPage(tabText(0))
        Me.tabPage2 = New TabPage(tabText(1))
        Me.tabPage3 = New TabPage(tabText(2))

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

        ' Checks the tabControl1 controls collection for tabPage3.
        ' Adds tabPage3 to tabControl1 if it is not in the collection.
        If tabControl1.TabPages.Contains(tabPage3) = False Then
            Me.tabControl1.TabPages.Add(tabPage3)
        End If

        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

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();
        string[] tabText = {"tabPage1", "tabPage2", "tabPage3"};
        this.tabPage1 = new TabPage(tabText[0]);
        this.tabPage2 = new TabPage(tabText[1]);
        this.tabPage3 = new TabPage(tabText[2]);

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

        // Checks the tabControl1 controls collection for tabPage3.
        // Adds tabPage3 to tabControl1 if it is not in the collection.
        if (tabControl1.TabPages.Contains(tabPage3) == false)
            this.tabControl1.TabPages.Add(tabPage3);

        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());
    }
}

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;
      array<System::String^>^tabText = {"tabPage1","tabPage2","tabPage3"};
      this->tabPage1 = gcnew TabPage( tabText[ 0 ]->ToString() );
      this->tabPage2 = gcnew TabPage( tabText[ 1 ]->ToString() );
      this->tabPage3 = gcnew TabPage( tabText[ 2 ]->ToString() );
      
      // Populates the tabControl1 with two tab pages.
      array<TabPage^>^tabPages = {tabPage1,tabPage2};
      this->tabControl1->TabPages->AddRange( tabPages );
      
      // Checks the tabControl1 controls collection for tabPage3.
      // Adds tabPage3 to tabControl1 if it is not in the collection.
      if ( tabControl1->TabPages->Contains( tabPage3 ) == false )
            this->tabControl1->TabPages->Add( tabPage3 );

      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 );
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TabControl.TabPageCollection-Klasse
TabControl.TabPageCollection-Member
System.Windows.Forms-Namespace
Item
IndexOf
GetEnumerator
TabPage