StatusBarPanelBorderStyle Enumeration
Specifies the appearance of the border for a StatusBarPanel on a StatusBar control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| None | No border is displayed. | |
| Raised | The StatusBarPanel is displayed with a three-dimensional raised border. | |
| Sunken | The StatusBarPanel is displayed with a three-dimensional sunken border. |
This enumeration is used by the BorderStyle property of the StatusBarPanel class. The BorderStyle property enables you to specify the style of border to display on a StatusBarPanel within a StatusBar.
The following code example demonstrates how to use the StatusBarPanelBorderStyle enumeration 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 event-handling method.
internal: System::Windows::Forms::StatusBar^ statusBar1; private: 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(); } }
Available since 1.1