StatusBarPanelBorderStyle Enumeration
TOC
Collapse the table of content
Expand the table of content

StatusBarPanelBorderStyle Enumeration

 

Specifies the appearance of the border for a StatusBarPanel on a StatusBar control.

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

public enum StatusBarPanelBorderStyle

Member nameDescription
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 = new 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 += 
		new StatusBarPanelClickEventHandler(statusBar1_PanelClick);

	// Create two StatusBarPanel objects to display in statusBar1.
	StatusBarPanel panel1 = new StatusBarPanel();
	StatusBarPanel panel2 = new 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.
private void statusBar1_PanelClick(object sender, 
	StatusBarPanelClickEventArgs e)
{
	if (e.StatusBarPanel.Text == 
		System.DateTime.Now.ToShortTimeString())
	{
		e.StatusBarPanel.Text = 
			System.DateTime.Now.ToLongTimeString();
	}
}

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft