Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

StatusBarPanelAutoSize Enumeration

Specifies how a StatusBarPanel on a StatusBar control behaves when the control resizes.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public enum StatusBarPanelAutoSize
public enum StatusBarPanelAutoSize
public enum StatusBarPanelAutoSize
 Member nameDescription
ContentsThe width of the StatusBarPanel is determined by its contents. 
NoneThe StatusBarPanel does not change size when the StatusBar control resizes. 
SpringThe StatusBarPanel shares the available space on the StatusBar (the space not taken up by other panels whose AutoSize property is set to None or Contents) with other panels that have their AutoSize property set to Spring

This enumeration is used by the StatusBarPanel.AutoSize property. The AutoSize property specifies how a StatusBarPanel is autosized on a StatusBar control.

The following code example demonstrates how to use the StatusBarPanelAutoSize 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();
    }
}

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.set_Dock(DockStyle.Top);
    // Set the SizingGrip property to false so the user cannot 
    // resize the status bar.
    statusBar1.set_SizingGrip(false);
    // Associate the event-handling method with the 
    // PanelClick event.
    statusBar1.add_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.set_Width(80);
    panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);
    // Set the text alignment within each panel.
    panel1.set_Alignment(HorizontalAlignment.Left);
    panel2.set_Alignment(HorizontalAlignment.Right);
    // Display the first panel without a border and the second
    // with a raised border.
    panel1.set_BorderStyle(StatusBarPanelBorderStyle.None);
    panel2.set_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.set_Text("Reserved for important information.");
    panel2.set_Text(System.DateTime.get_Now().ToShortTimeString());
    // Set a tooltip for panel2
    panel2.set_ToolTipText("Click time to display seconds");
    // Display panels in statusBar1 and add them to the
    // status bar's StatusBarPanelCollection.
    statusBar1.set_ShowPanels(true);
    statusBar1.get_Panels().Add(panel1);
    statusBar1.get_Panels().Add(panel2);
    // Add the StatusBar to the form.
    this.get_Controls().Add(statusBar1);
} //InitializeStatusBarPanels

// 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.get_StatusBarPanel().get_Text().Equals(
        System.DateTime.get_Now().ToShortTimeString())) {
        e.get_StatusBarPanel().set_Text(System.DateTime.get_Now().
            ToLongTimeString());
    }
} //statusBar1_PanelClick

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.