StatusBarPanel::Alignment Property

 

Gets or sets the alignment of text and icons within the status bar panel.

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

public:
property HorizontalAlignment Alignment {
	HorizontalAlignment get();
	void set(HorizontalAlignment value);
}

Property Value

Type: System.Windows.Forms::HorizontalAlignment

One of the HorizontalAlignment values. The default is Left.

Exception Condition
InvalidEnumArgumentException

The value assigned to the property is not a member of the HorizontalAlignment enumeration.

You can use this property to horizontally align the text and/or icon assigned to the Icon property within the borders of the panel. Text and icons can be aligned to the left, right, or center of the StatusBarPanel. There is no way to independently position an icon within the StatusBarPanel. For example, you cannot position an icon to the left side of the StatusBarPanel while aligning the text on the right side. The icon is always positioned to the left side of the text regardless of how the text is aligned.

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

To run the example, paste the following code into 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();
      }
   }

.NET Framework
Available since 1.1
Return to top
Show: