StatusBarPanel Klas

Definitie

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Overname

Object

MarshalByRefObject

Component

StatusBarPanel

Implementeringen

ISupportInitialize

Voorbeelden

In het volgende codevoorbeeld wordt een StatusBar besturingselement op een formulier gemaakt en worden twee StatusBarPanel objecten toegevoegd. De eerste StatusBarPanel, benoemde panel1, geeft statustekst weer voor een toepassing. De tweede StatusBarPanel, benoemde panel2, geeft de huidige datum weer en gebruikt de ToolTipText eigenschap van de StatusBarPanel klasse om de huidige tijd weer te geven. In het voorbeeld wordt de ShowPanels eigenschap gebruikt om ervoor te zorgen dat de panelen worden weergegeven in plaats van een standaardpaneel en wordt de Panels eigenschap gebruikt voor toegang tot de Add methode van de StatusBar.StatusBarPanelCollection deelvensters om de panelen toe te voegen aan de StatusBar. In het voorbeeld worden ook de AutoSizeeigenschappen , BorderStyleen TextToolTipTexteigenschappen gebruikt om de StatusBarPanel objecten te initialiseren. In dit voorbeeld wordt ervan uitgegaan dat de in het voorbeeld gedefinieerde methode wordt gedefinieerd en aangeroepen vanuit de constructor van een Form.

private:
   void CreateMyStatusBar()
   {
      // Create a StatusBar control.
      StatusBar^ statusBar1 = gcnew StatusBar;

      // Create two StatusBarPanel objects to display in the StatusBar.
      StatusBarPanel^ panel1 = gcnew StatusBarPanel;
      StatusBarPanel^ panel2 = gcnew StatusBarPanel;

      // Display the first panel with a sunken border style.
      panel1->BorderStyle = StatusBarPanelBorderStyle::Sunken;

      // Initialize the text of the panel.
      panel1->Text = "Ready...";

      // Set the AutoSize property to use all remaining space on the StatusBar.
      panel1->AutoSize = StatusBarPanelAutoSize::Spring;

      // Display the second panel with a raised border style.
      panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;

      // Create ToolTip text that displays the time the application
      // was started.
      panel2->ToolTipText = System::DateTime::Now.ToShortTimeString();

      // Set the text of the panel to the current date.
      panel2->Text = "Started: " + System::DateTime::Today.ToLongDateString();

      // Set the AutoSize property to size the panel to the size of the contents.
      panel2->AutoSize = StatusBarPanelAutoSize::Contents;

      // Display panels in the StatusBar control.
      statusBar1->ShowPanels = true;

      // Add both panels to the StatusBarPanelCollection of the StatusBar.   
      statusBar1->Panels->Add( panel1 );
      statusBar1->Panels->Add( panel2 );

      // Add the StatusBar to the form.
      this->Controls->Add( statusBar1 );
   }

private void CreateMyStatusBar()
{
    // Create a StatusBar control.
    StatusBar statusBar1 = new StatusBar();
    // Create two StatusBarPanel objects to display in the StatusBar.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Display the first panel with a sunken border style.
    panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken;
    // Initialize the text of the panel.
    panel1.Text = "Ready...";
    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.AutoSize = StatusBarPanelAutoSize.Spring;
    
    // Display the second panel with a raised border style.
    panel2.BorderStyle = StatusBarPanelBorderStyle.Raised;
    
    // Create ToolTip text that displays time the application was started.
    panel2.ToolTipText = "Started: " + System.DateTime.Now.ToShortTimeString();
    // Set the text of the panel to the current date.
    panel2.Text = System.DateTime.Today.ToLongDateString();
    // Set the AutoSize property to size the panel to the size of the contents.
    panel2.AutoSize = StatusBarPanelAutoSize.Contents;
                
    // Display panels in the StatusBar control.
    statusBar1.ShowPanels = true;

    // Add both panels to the StatusBarPanelCollection of the StatusBar.			
    statusBar1.Panels.Add(panel1);
    statusBar1.Panels.Add(panel2);

    // Add the StatusBar to the form.
    this.Controls.Add(statusBar1);
}

Private Sub CreateMyStatusBar()
   ' Create a StatusBar control.
   Dim statusBar1 As New StatusBar()

   ' Create two StatusBarPanel objects to display in the StatusBar.
   Dim panel1 As New StatusBarPanel()
   Dim panel2 As New StatusBarPanel()

   ' Display the first panel with a sunken border style.
   panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken

   ' Initialize the text of the panel.
   panel1.Text = "Ready..."

   ' Set the AutoSize property to use all remaining space on the StatusBar.
   panel1.AutoSize = StatusBarPanelAutoSize.Spring
   
   ' Display the second panel with a raised border style.
   panel2.BorderStyle = StatusBarPanelBorderStyle.Raised
   
   ' Create ToolTip text that displays the time the application was started.
   panel2.ToolTipText = "Started: " & System.DateTime.Now.ToShortTimeString()

   ' Set the text of the panel to the current date.
   panel2.Text = System.DateTime.Today.ToLongDateString()

   ' Set the AutoSize property to size the panel to the size of the contents.
   panel2.AutoSize = StatusBarPanelAutoSize.Contents

   ' Display panels in the StatusBar control.
   statusBar1.ShowPanels = True

   ' Add both panels to the StatusBarPanelCollection of the StatusBar.			
   statusBar1.Panels.Add(panel1)
   statusBar1.Panels.Add(panel2)

   ' Add the StatusBar to the form.
   Me.Controls.Add(statusBar1)
End Sub

Opmerkingen

Deze klasse is niet beschikbaar in .NET 5 en nieuwere versies. Gebruik in plaats daarvan het ToolStripStatusLabel besturingselement.

A StatusBarPanel vertegenwoordigt een afzonderlijk paneel in een StatusBar.StatusBarPanelCollectionStatusBar besturingselement. Een StatusBarPanel kan tekst en/of een pictogram bevatten dat kan worden gebruikt om de status van een toepassing weer te geven. Gebruik de StatusBar.StatusBarPanelCollectioneigenschap , toegankelijk via de StatusBar.Panels eigenschap van een StatusBar besturingselement, om een persoon StatusBarPanelop te halen, toe te voegen of te verwijderen.

De StatusBarPanel bevat eigenschappen waarmee u het weergavegedrag van een paneel in een StatusBar besturingselement kunt wijzigen. U kunt de Icon eigenschap gebruiken om een pictogram in een deelvenster weer te geven. Deze eigenschap kan worden gebruikt om een grafische weergave van de status in een toepassing te bieden. Met de Alignment eigenschap kunt u opgeven hoe tekst en/of een pictogram in het deelvenster worden uitgelijnd. Als u ervoor wilt zorgen dat het paneel op de juiste grootte past bij de tekst van het deelvenster, kunt u de AutoSize eigenschap gebruiken om het deelvenster automatisch te wijzigen om de tekst van het deelvenster aan te passen of om de resterende ruimte in het StatusBar besturingselement te vullen. Met MinWidth de eigenschap kunt u een minimale breedte voor het deelvenster opgeven om ervoor te zorgen dat deze niet kleiner wordt dan de gegevens die moeten worden weergegeven.

Het StatusBar besturingselement wordt meestal gebruikt om Help-informatie of statusinformatie over uw toepassing weer te geven. Vaak is het belangrijk om aanvullende informatie weer te geven over gegevens die in een paneel worden gepresenteerd. U kunt de ToolTipText eigenschap gebruiken om informatie weer te geven wanneer de muiswijzer op een paneel rust.

Hoewel het StatusBar besturingselement doorgaans wordt gebruikt om tekstuele informatie weer te geven, kunt u ook uw eigen type weergave aan een StatusBarPanel. Met de Style eigenschap kunt u opgeven hoe de StatusBarPanel tekenwijze wordt getekend. De eigenschap wordt standaard Style gebruikt om de waarde van de Text eigenschap weer te geven (en een pictogram, indien opgegeven in de Icon eigenschap). Als de eigenschap is ingesteld op OwnerDraw, kunt u uw eigen informatie in het deelvenster tekenen. U kunt deze functie gebruiken om een voortgangsbalk of een animatiepictogram in het deelvenster te tekenen.

Wanneer u een exemplaar van de StatusBarPanel klasse maakt, worden de eigenschappen voor lezen/schrijven ingesteld op initiële waarden. Zie de StatusBarPanel constructor voor een lijst met deze waarden.

Zie ook

• StatusBarPanel