StatusBar 클래스

아티클
08/21/2007

Windows 상태 표시줄 컨트롤을 나타냅니다. ToolStripStatusLabel에 의해 이전 버전의 StatusBar 컨트롤의 여러 기능이 교체 및 추가되었지만 StatusBar은 이전 버전과의 호환성을 위해 유지되었으며, 필요한 경우 선택하여 사용할 수 있습니다.

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

구문

‘선언
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class StatusBar
    Inherits Control
‘사용 방법
Dim instance As StatusBar

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class StatusBar : Control

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class StatusBar : public Control

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class StatusBar extends Control

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class StatusBar extends Control

설명

일반적으로 StatusBar 컨트롤은 각각 텍스트 및/또는 아이콘을 표시하는 StatusBarPanel 개체로 구성됩니다. 또한 소유자가 그린 패널을 제공하여 진행률 표시줄이나 사용자 응용 프로그램의 상태를 표시하는 일련의 이미지 같은 패널을 사용자 지정할 수도 있습니다. StatusBar 컨트롤은 일반적으로 Form에서 현재 보고 있는 개체에 대한 정보, 해당 개체의 구성 요소 또는 응용 프로그램 내에서의 개체 동작과 관련한 컨텍스트 정보를 표시합니다.

StatusBar 컨트롤은 컨트롤의 모양을 사용자 지정할 수 있도록 하는 속성을 제공합니다. StatusBar가 크기를 조정할 수 있는 폼에 표시되어 있으면 SizingGrip 속성을 사용하여 폼의 오른쪽 아래 모퉁이에 크기 조정 그립을 표시해서 해당 폼의 크기를 조정할 수 있음을 나타낼 수 있습니다. ShowPanels 속성을 사용하면 StatusBar 내에 패널을 표시하거나 컨트롤의 Text 속성 값만 표시할 수 있습니다.

기본 StatusBar에는 패널이 없습니다. StatusBar에 패널을 추가하려면 컨트롤의 Panels 속성을 통해 액세스할 수 있는 StatusBar.StatusBarPanelCollection 클래스의 Add 메서드를 사용합니다. 또한 Panels 속성을 통해 제공되는 StatusBar.StatusBarPanelCollection 개체를 사용하면 컨트롤에서 패널을 제거할 수 있으며, 특정 StatusBarPanel에 액세스하여 패널을 조작할 수도 있습니다.

StatusBar 컨트롤 내에 있는 StatusBarPanel 개체를 클릭한 시간을 확인하려면 PanelClick 이벤트에 대한 이벤트 처리기를 만듭니다. 패널에서 사용자 그리기 작업을 수행하려면 DrawItem 이벤트에 대한 이벤트 처리기를 만듭니다. 이벤트 처리기에 전달되는 이벤트 데이터는 그릴 패널에 대한 정보와 그리기 작업을 수행하기 위해 사용할 Graphics 개체에 대한 정보를 제공합니다.

StatusBar의 인스턴스를 만드는 경우 읽기/쓰기 속성이 초기 값으로 설정됩니다. 이러한 값에 대한 목록은 StatusBar 생성자를 참조하십시오.

예제

다음 코드 예제에서는 폼에 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.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.StatusBar

스레드로부터의 안전성

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

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, 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에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

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

다음을 통해 공유