Verwenden von Visual C# zum Erstellen einer reibungslosen Statusanzeige

2024-12-14

Dieser Artikel enthält Informationen zum Erstellen eines benutzerdefinierten UserControl-Steuerelements zum Erstellen eines reibungslosen ProgressBar-Steuerelements.

Originalproduktversion: Visual C#
Ursprüngliche KB-Nummer: 323116

Zusammenfassung

In diesem Artikel wird veranschaulicht, wie Sie ein einfaches, benutzerdefiniertes UserControl-Steuerelement erstellen, um ein reibungsloses ProgressBar-Steuerelement zu erstellen.

In früheren Versionen des ProgressBar-Steuerelements, z. B. der Version, die mit dem ActiveX-Steuerelement für allgemeine Steuerelemente von Microsoft Windows bereitgestellt wird, können Sie den Fortschritt in zwei verschiedenen Ansichten anzeigen. Um diese Ansichten zu steuern, verwenden Sie die Scrolling-Eigenschaft, die Standard- und glatte Einstellungen enthält. Das reibungslose Scrollen erzeugt einen einfarbigen Farbblock, der den Fortschritt darstellt, und standardmäßiger Bildlauf wird segmentiert angezeigt und besteht aus einer Reihe kleiner Blöcke oder Rechtecke.

Das ProgressBar-Steuerelement, das in Microsoft Visual C# enthalten ist, unterstützt nur die Standardeinstellung.

Der Beispielcode in diesem Artikel veranschaulicht das Erstellen eines Steuerelements, das die folgenden Eigenschaften unterstützt:

Minimum: Diese Eigenschaft ruft den niedrigeren Wert für den Bereich gültiger Werte für den Fortschritt ab oder legt diesen fest. Der Standardwert dieser Eigenschaft ist Null (0); Sie können diese Eigenschaft nicht auf einen negativen Wert festlegen.
Maximum: Diese Eigenschaft ruft den oberen Wert für den Bereich gültiger Werte für den Fortschritt ab oder legt diesen fest. Der Standardwert dieser Eigenschaft ist 100.
Wert: Diese Eigenschaft ruft die aktuelle Statusstufe ab oder legt sie fest. Der Wert muss sich im Bereich befinden, in dem die Eigenschaft "Minimum" und "Maximum" definiert sind.
ProgressBarColor: Diese Eigenschaft ruft die Farbe der Statusanzeige ab oder legt sie fest.

Erstellen eines benutzerdefinierten ProgressBar-Steuerelements

Führen Sie die folgenden Schritte aus, um ein neues Windows Control Library-Projekt in Visual C# zu erstellen:
1. Starten Sie Microsoft Visual Studio.
2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
3. Klicken Sie im Dialogfeld "Neues Projekt" unter "Projekttypen" auf "Visual C#", und klicken Sie dann unter "Vorlagen" auf "Windows Forms-Steuerelementbibliothek".
4. Geben Sie im Feld "Name " die Leiste "SmoothProgressBar" ein, und klicken Sie dann auf "OK".
5. Benennen Sie im Projekt-Explorer das Standardklassenmodul von UserControl1.cs in SmoothProgressBar.cs um.
6. Ändern Sie im Eigenschaftenfenster für das UserControl-Objekt die Name-Eigenschaft von UserControl1 in SmoothProgressBar.

An diesem Punkt erben Sie in der Regel von der Klasse dieses Steuerelements und fügen dann die zusätzliche Funktionalität hinzu, um ein vorhandenes Steuerelement zu erweitern. Die ProgressBar-Klasse ist jedoch versiegelt und kann nicht geerbt werden. Daher müssen Sie das Steuerelement von Anfang an erstellen.

Fügen Sie der SmoothProgressBar.cs-Datei den folgenden Code in der Klasse hinzu, die von UserControl abgeleitet wird.

int min = 0;// Minimum value for progress range
int max = 100;// Maximum value for progress range
int val = 0;// Current progress
Color BarColor = Color.Blue;// Color of progress meter

protected override void OnResize(EventArgs e)
{
    // Invalidate the control to get a repaint.
    this.Invalidate();
}

protected override void OnPaint(PaintEventArgs e)
{
    Graphics g = e.Graphics;
    SolidBrush brush = new SolidBrush(BarColor);
    float percent = (float)(val - min) / (float)(max - min);
    Rectangle rect = this.ClientRectangle;

    // Calculate area for drawing the progress.
    rect.Width = (int)((float)rect.Width * percent);

    // Draw the progress meter.
    g.FillRectangle(brush, rect);

    // Draw a three-dimensional border around the control.
    Draw3DBorder(g);

    // Clean up.
    brush.Dispose();
    g.Dispose();
}

public int Minimum
{
    get
    {
        return min;
    }

    set
    {
        // Prevent a negative value.
        if (value < 0)
        {
            value = 0;
        }

        // Make sure that the minimum value is never set higher than the maximum value.
        if (value > max)
        {
            max = value;
        }

        min = value;

        // Ensure value is still in range
        if (val < min)
        {
            val = min;
        }

        // Invalidate the control to get a repaint.
        this.Invalidate();
    }
}

public int Maximum
{
    get
    {
        return max;
    }

    set
    {
        // Make sure that the maximum value is never set lower than the minimum value.
        if (value < min)
        {
            min = value;
        }

        max = value;

        // Make sure that value is still in range.
        if (val > max)
        {
            val = max;
        }

        // Invalidate the control to get a repaint.
        this.Invalidate();
    }
}

public int Value
{
    get
    {
        return val;
    }

    set
    {
        int oldValue = val;

        // Make sure that the value does not stray outside the valid range.
        if (value < min)
        {
            val = min;
        }
        else if (value > max)
        {
            val = max;
        }
        else
        {
            val = value;
        }

        // Invalidate only the changed area.
        float percent;

        Rectangle newValueRect = this.ClientRectangle;
        Rectangle oldValueRect = this.ClientRectangle;

        // Use a new value to calculate the rectangle for progress.
        percent = (float)(val - min) / (float)(max - min);
        newValueRect.Width = (int)((float)newValueRect.Width * percent);

        // Use an old value to calculate the rectangle for progress.
        percent = (float)(oldValue - min) / (float)(max - min);
        oldValueRect.Width = (int)((float)oldValueRect.Width * percent);

        Rectangle updateRect = new Rectangle();

        // Find only the part of the screen that must be updated.
        if (newValueRect.Width > oldValueRect.Width)
        {
            updateRect.X = oldValueRect.Size.Width;
            updateRect.Width = newValueRect.Width - oldValueRect.Width;
        }
        else
        {
            updateRect.X = newValueRect.Size.Width;
            updateRect.Width = oldValueRect.Width - newValueRect.Width;
        }

        updateRect.Height = this.Height;

        // Invalidate the intersection region only.
        this.Invalidate(updateRect);
    }
}

public Color ProgressBarColor
{
    get
    {
        return BarColor;
    }

    set
    {
        BarColor = value;

        // Invalidate the control to get a repaint.
        this.Invalidate();
    }
}

private void Draw3DBorder(Graphics g)
{
    int PenWidth = (int)Pens.White.Width;

    g.DrawLine(Pens.DarkGray,
    new Point(this.ClientRectangle.Left, this.ClientRectangle.Top),
    new Point(this.ClientRectangle.Width - PenWidth, this.ClientRectangle.Top));
    g.DrawLine(Pens.DarkGray,
    new Point(this.ClientRectangle.Left, this.ClientRectangle.Top),
    new Point(this.ClientRectangle.Left, this.ClientRectangle.Height - PenWidth));
    g.DrawLine(Pens.White,
    new Point(this.ClientRectangle.Left, this.ClientRectangle.Height - PenWidth),
    new Point(this.ClientRectangle.Width - PenWidth, this.ClientRectangle.Height - PenWidth));
    g.DrawLine(Pens.White,
    new Point(this.ClientRectangle.Width - PenWidth, this.ClientRectangle.Top),
    new Point(this.ClientRectangle.Width - PenWidth, this.ClientRectangle.Height - PenWidth));
}

Klicken Sie im Menü "Erstellen " auf " Projektmappe erstellen", um das Projekt zu kompilieren.

Erstellen einer Beispielclientanwendung

Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Klicken Sie im Dialogfeld "Neues Projekt hinzufügen" unter "Projekttypen" auf "Visual C#", klicken Sie unter "Vorlagen" auf "Windows Forms-Anwendung", und klicken Sie dann auf "OK".
Führen Sie die folgenden Schritte aus, um dem Formular zwei Instanzen des SmoothProgressBar-Steuerelements hinzuzufügen:
1. Klicken Sie im Menü Extras auf Toolboxelemente auswählen.
2. Klicken Sie auf die Registerkarte .NET Framework-Komponenten .
3. Klicken Sie auf " Durchsuchen", und suchen Sie dann die SmoothProgressBar.dll Datei, die Sie im Abschnitt "Erstellen eines benutzerdefinierten ProgressBar-Steuerelements " erstellt haben.
4. Klicken Sie auf OK.
  
  Notiz
  
  Das SmoothProgressBar-Steuerelement wird der Toolbox hinzugefügt.
5. Ziehen Sie zwei Instanzen des SmoothProgressBar-Steuerelements aus der Toolbox in das Standardformular des Windows-Anwendungsprojekts.
Ziehen Sie ein Timer-Steuerelement aus der Toolbox in das Formular.

Fügen Sie dem Tick Ereignis des Timer-Steuerelements den folgenden Code hinzu:

if (this.smoothProgressBar1.Value > 0)
{
    this.smoothProgressBar1.Value--;
    this.smoothProgressBar2.Value++;
}
else
{
    this.timer1.Enabled = false;
}

Ziehen Sie ein Schaltflächen-Steuerelement aus der Toolbox in das Formular.

Fügen Sie dem Click Ereignis des Schaltflächensteuerelements den folgenden Code hinzu:

this.smoothProgressBar1.Value = 100;
this.smoothProgressBar2.Value = 0;

this.timer1.Interval = 1;
this.timer1.Enabled = true;

Klicken Sie im Menü "Debuggen " auf "Start ", um das Beispielprojekt auszuführen.
Klicken Sie auf die Schaltfläche .

Notiz

Die beiden Statusanzeigen zeigen den Textfortschritt an. Eine Statusanzeige zeigt den Fortschritt zunehmend an, und die andere Statusanzeige zeigt den Fortschritt auf abnehmende oder countdown-Weise an.

Freigeben über

Verwenden von Visual C# zum Erstellen einer reibungslosen Statusanzeige

Zusammenfassung

Erstellen eines benutzerdefinierten ProgressBar-Steuerelements

Erstellen einer Beispielclientanwendung

Feedback

Zusätzliche Ressourcen