StatusBar.StatusBarPanelCollection 클래스

아티클
08/21/2007

StatusBar에 있는 패널의 컬렉션을 나타냅니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
Public Class StatusBarPanelCollection
    Implements IList, ICollection, IEnumerable
‘사용 방법
Dim instance As StatusBarPanelCollection

public class StatusBarPanelCollection : IList, ICollection, IEnumerable

public ref class StatusBarPanelCollection : IList, ICollection, IEnumerable

public class StatusBarPanelCollection implements IList, ICollection, 
    IEnumerable

public class StatusBarPanelCollection implements IList, ICollection, 
    IEnumerable

설명

StatusBar.StatusBarPanelCollection 클래스는 StatusBar에 표시된 패널을 저장합니다. 컬렉션에 있는 각 개체는 StatusBar에 표시되는 패널의 표시 특성과 동작을 정의하는 StatusBarPanel 클래스의 인스턴스입니다.

컬렉션에 패널을 추가하는 데에는 여러 가지 방법이 있습니다. Add 메서드를 사용하면 컬렉션에 하나의 패널을 추가할 수 있습니다. 컬렉션에 여러 패널을 추가하려면 StatusBarPanel 개체 배열을 만든 다음 AddRange 메서드에 할당합니다. 컬렉션 내의 특정 위치에 패널을 삽입하려면 Insert 메서드를 사용합니다. 패널을 제거하려면 Remove 메서드를 사용하거나, 컬렉션 내의 패널 위치를 아는 경우에는 RemoveAt 메서드를 사용합니다. 한 번에 하나의 패널을 제거하는 Remove 메서드 대신 Clear 메서드를 사용하면 컬렉션의 모든 패널을 제거할 수 있습니다.

StatusBar.StatusBarPanelCollection은 패널을 추가하거나 삭제하는 데 필요한 메서드 및 속성 외에 컬렉션에서 패널을 찾는 데 필요한 메서드도 제공합니다. Contains 메서드를 사용하면 해당 패널이 컬렉션의 멤버인지 확인할 수 있습니다. 패널이 컬렉션 내에 있다는 것이 확인되면 IndexOf 메서드를 사용하여 컬렉션에서 해당 패널의 위치를 확인할 수 있습니다.

예제

다음 코드 예제에서는 폼에 StatusBar 컨트롤을 만들고 StatusBarPanel 개체를 두 개 추가합니다. 두 StatusBarPanel 중 하나인 panel1은 응용 프로그램에 대한 상태 텍스트를 표시합니다. 두 번째 StatusBarPanel인 panel2는 현재 날짜를 표시하고 StatusBarPanel 클래스의 ToolTipText 속성을 사용하여 현재 시간을 표시합니다. 예제에서는 ShowPanels 속성을 사용하여 표준 패널 대신 해당 패널이 표시되게 하고, Panels 속성을 사용하여 StatusBar.StatusBarPanelCollection의 Add 메서드에 액세스해서 StatusBar에 패널을 추가합니다. 또한 AutoSize, BorderStyle, ToolTipText 및 Text 속성을 사용하여 StatusBarPanel 개체를 초기화합니다. 이 예제에서 정의되는 메서드는 Form의 생성자에서 정의되고 호출되는 것으로 가정합니다.

Private Sub CreateMyStatusBar()
   ' Create a StatusBar control.
   Dim statusBar1 As New StatusBar()

   ' Create two StatusBarPanel objects to display in the StatusBar.
   Dim panel1 As New StatusBarPanel()
   Dim panel2 As New StatusBarPanel()

   ' Display the first panel with a sunken border style.
   panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken

   ' Initialize the text of the panel.
   panel1.Text = "Ready..."

   ' Set the AutoSize property to use all remaining space on the StatusBar.
   panel1.AutoSize = StatusBarPanelAutoSize.Spring
   
   ' Display the second panel with a raised border style.
   panel2.BorderStyle = StatusBarPanelBorderStyle.Raised
   
   ' Create ToolTip text that displays the time the application was started.
   panel2.ToolTipText = "Started: " & System.DateTime.Now.ToShortTimeString()

   ' Set the text of the panel to the current date.
   panel2.Text = System.DateTime.Today.ToLongDateString()

   ' Set the AutoSize property to size the panel to the size of the contents.
   panel2.AutoSize = StatusBarPanelAutoSize.Contents

   ' Display panels in the StatusBar control.
   statusBar1.ShowPanels = True

   ' Add both panels to the StatusBarPanelCollection of the StatusBar.            
   statusBar1.Panels.Add(panel1)
   statusBar1.Panels.Add(panel2)

   ' Add the StatusBar to the form.
   Me.Controls.Add(statusBar1)
End Sub

private void CreateMyStatusBar()
{
    // Create a StatusBar control.
    StatusBar statusBar1 = new StatusBar();
    // Create two StatusBarPanel objects to display in the StatusBar.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Display the first panel with a sunken border style.
    panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken;
    // Initialize the text of the panel.
    panel1.Text = "Ready...";
    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.AutoSize = StatusBarPanelAutoSize.Spring;
    
    // Display the second panel with a raised border style.
    panel2.BorderStyle = StatusBarPanelBorderStyle.Raised;
    
    // Create ToolTip text that displays time the application was 
          //started.
    panel2.ToolTipText = "Started: " + System.DateTime.Now.ToShortTimeString();
    // Set the text of the panel to the current date.
    panel2.Text = System.DateTime.Today.ToLongDateString();
    // Set the AutoSize property to size the panel to the size of the contents.
    panel2.AutoSize = StatusBarPanelAutoSize.Contents;
                
    // Display panels in the StatusBar control.
    statusBar1.ShowPanels = true;

    // Add both panels to the StatusBarPanelCollection of the StatusBar.            
    statusBar1.Panels.Add(panel1);
    statusBar1.Panels.Add(panel2);

    // Add the StatusBar to the form.
    this.Controls.Add(statusBar1);
}

private:
   void CreateMyStatusBar()
   {
      // Create a StatusBar control.
      StatusBar^ statusBar1 = gcnew StatusBar;

      // Create two StatusBarPanel objects to display in the StatusBar.
      StatusBarPanel^ panel1 = gcnew StatusBarPanel;
      StatusBarPanel^ panel2 = gcnew StatusBarPanel;

      // Display the first panel with a sunken border style.
      panel1->BorderStyle = StatusBarPanelBorderStyle::Sunken;

      // Initialize the text of the panel.
      panel1->Text = "Ready...";

      // Set the AutoSize property to use all remaining space on the StatusBar.
      panel1->AutoSize = StatusBarPanelAutoSize::Spring;

      // Display the second panel with a raised border style.
      panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;

      // Create ToolTip text that displays the time the application
      // was started.
      panel2->ToolTipText = System::DateTime::Now.ToShortTimeString();

      // Set the text of the panel to the current date.
      panel2->Text = "Started: " + System::DateTime::Today.ToLongDateString();

      // Set the AutoSize property to size the panel to the size of the contents.
      panel2->AutoSize = StatusBarPanelAutoSize::Contents;

      // Display panels in the StatusBar control.
      statusBar1->ShowPanels = true;

      // Add both panels to the StatusBarPanelCollection of the StatusBar.   
      statusBar1->Panels->Add( panel1 );
      statusBar1->Panels->Add( panel2 );

      // Add the StatusBar to the form.
      this->Controls->Add( statusBar1 );
   }

private void CreateMyStatusBar()
{
    // Create a StatusBar control.
    StatusBar statusBar1 = new StatusBar();

    // Create two StatusBarPanel objects to display in the StatusBar.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Display the first panel with a sunken border style.
    panel1.set_BorderStyle(StatusBarPanelBorderStyle.Sunken);

    // Initialize the text of the panel.
    panel1.set_Text("Ready...");

    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);

    // Display the second panel with a raised border style.
    panel2.set_BorderStyle(StatusBarPanelBorderStyle.Raised);

    // Create ToolTip text that displays the time the application was started.
    panel2.set_ToolTipText("Started: " + System.DateTime.get_Now().ToShortTimeString());
    
// Set the text of the panel to the current date.
    panel2.set_Text(System.DateTime.get_Today().ToLongDateString());
    
// Set the AutoSize property to size the panel to the size of the 
    // contents.
    panel2.set_AutoSize(StatusBarPanelAutoSize.Contents);
    // Display panels in the StatusBar control.
    statusBar1.set_ShowPanels(true);
    // Add both panels to the StatusBarPanelCollection of the StatusBar.    
    statusBar1.get_Panels().Add(panel1);
    statusBar1.get_Panels().Add(panel2);
    // Add the StatusBar to the form.
    this.get_Controls().Add(statusBar1);
} //CreateMyStatusBar

상속 계층 구조

System.Object
System.Windows.Forms.StatusBar.StatusBarPanelCollection

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

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

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

StatusBar.StatusBarPanelCollection 멤버
System.Windows.Forms 네임스페이스
StatusBarPanel

다음을 통해 공유