StatusBar.SizingGrip Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets a value indicating whether a sizing grip is displayed in the lower-right corner of the control.

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

public bool SizingGrip { get; set; }

Property Value

Type: System.Boolean

true if a sizing grip is displayed; otherwise, false. The default is true.

You can use this property to display a sizing grip to provide an indication to the user when a form is resizable. If the FormBorderStyle property of your Form is set to a border style that is not resizable, such asFixed3D or FixedDialog, you should set the SizingGrip property to false to prevent the user from thinking that the form can be resized.

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 event handler.


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: