This documentation is archived and is not being maintained.

StatusBar::PanelClick Event

Occurs when a StatusBarPanel object on a StatusBar control is clicked.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

 event StatusBarPanelClickEventHandler^ PanelClick {
	void add (StatusBarPanelClickEventHandler^ value);
	void remove (StatusBarPanelClickEventHandler^ value);

You can use this event to perform tasks when a panel within a StatusBar control is clicked. The data provided to the event through the StatusBarPanelClickEventArgs passed as a parameter to the event handler enables you to determine the StatusBarPanel that was clicked by the user in order to perform tasks on the selected panel.

For more information about handling events, see Consuming Events.

The following code example demonstrates how to use the SizingGrip, StatusBarPanel::Alignment, StatusBarPanel::Width, StatusBarPanel::AutoSize, and StatusBarPanel::BorderStyle members and how to handle the PanelClick event.

To run the example, paste the following code in a form. Call the InitializeStatusBarPanels method in the form's constructor or Load method.

   System::Windows::Forms::StatusBar^ statusBar1;

   void InitializeStatusBarPanels()

      // Create a StatusBar control.
      statusBar1 = gcnew StatusBar;

      // Dock the status bar at the top of the form. 
      statusBar1->Dock = DockStyle::Top;

      // Set the SizingGrip property to false so the user cannot 
      // resize the status bar.
      statusBar1->SizingGrip = false;

      // Associate the event-handling method with the 
      // PanelClick event.
      statusBar1->PanelClick += gcnew StatusBarPanelClickEventHandler( this, &Form1::statusBar1_PanelClick );

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

      // Set the width of panel2 explicitly and set
      // panel1 to fill in the remaining space.
      panel2->Width = 80;
      panel1->AutoSize = StatusBarPanelAutoSize::Spring;

      // Set the text alignment within each panel.
      panel1->Alignment = HorizontalAlignment::Left;
      panel2->Alignment = HorizontalAlignment::Right;

      // Display the first panel without a border and the second
      // with a raised border.
      panel1->BorderStyle = StatusBarPanelBorderStyle::None;
      panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;

      // Set the text of the panels. The panel1 object is reserved
      // for line numbers, while panel2 is set to the current time.
      panel1->Text = "Reserved for important information.";
      panel2->Text = System::DateTime::Now.ToShortTimeString();

      // Set a tooltip for panel2
      panel2->ToolTipText = "Click time to display seconds";

      // Display panels in statusBar1 and add them to the
      // status bar's StatusBarPanelCollection.
      statusBar1->ShowPanels = true;
      statusBar1->Panels->Add( panel1 );
      statusBar1->Panels->Add( panel2 );

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

   // If the user clicks the status bar, check the text of the 
   // StatusBarPanel.  If the text equals a short time string,
   // change it to long time display.
   void statusBar1_PanelClick( Object^ /*sender*/, StatusBarPanelClickEventArgs^ e )
      if ( e->StatusBarPanel->Text == System::DateTime::Now.ToShortTimeString() )
         e->StatusBarPanel->Text = System::DateTime::Now.ToLongTimeString();

The following code example demonstrates how to use the StatusBar.SizingGrip, StatusBarPanel.Alignment, StatusBarPanel.Width, StatusBarPanel.AutoSize, and StatusBarPanel.BorderStyle members and how to handle the StatusBar.PanelClick event.

To run the example, paste the following code in a form. Call the InitializeStatusBarPanels method in the form's constructor or Load method.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.