Visual C# gebruiken om een vloeiende voortgangsbalk te maken

Dit artikel bevat informatie over het maken van een aangepast UserControl-besturingselement voor het maken van een vloeiende voortgangsbalk.

Oorspronkelijke productversie: Visual C#
Oorspronkelijk KB-nummer: 323116

Samenvatting

In dit artikel wordt gedemonstreert hoe u een eenvoudig, aangepast UserControl-besturingselement maakt om een vloeiend besturingselement voortgangsbalk te maken.

In eerdere versies van het besturingselement Voortgangsbalk, zoals de versie die is geleverd met het ActiveX-besturingselement Algemene besturingselementen van Microsoft Windows, kunt u de voortgang in twee verschillende weergaven bekijken. Als u deze weergaven wilt beheren, gebruikt u de eigenschap Scrolling, die standaard- en vloeiende instellingen bevat. Vloeiend schuiven produceert een effen kleurblok dat de voortgang vertegenwoordigt en standaard schuiven wordt gesegmenteerd en bestaat uit een reeks kleine blokken of rechthoeken.

Het besturingselement ProgressBar dat is opgenomen in Microsoft Visual C# ondersteunt alleen de standaardinstelling.

De voorbeeldcode in dit artikel laat zien hoe u een besturingselement maakt dat de volgende eigenschappen ondersteunt:

  • Minimum: Deze eigenschap verkrijgt of stelt de lagere waarde in voor het bereik van geldige waarden voor voortgang. De standaardwaarde van deze eigenschap is nul (0); u kunt deze eigenschap niet instellen op een negatieve waarde.
  • Maximum: Deze eigenschap verkrijgt of stelt de bovenste waarde in voor het bereik van geldige waarden voor voortgang. De standaardwaarde van deze eigenschap is 100.
  • Waarde: Met deze eigenschap wordt het huidige voortgangsniveau opgehaald of ingesteld. De waarde moet in het bereik liggen dat de eigenschappen Minimum en Maximum definiëren.
  • ProgressBarColor: Met deze eigenschap wordt de kleur van de voortgangsbalk verkregen of ingesteld.

Een aangepast besturingselement Voortgangsbalk maken

  1. Volg deze stappen om een nieuw Windows Control Library-project te maken in Visual C#:

    1. Start Microsoft Visual Studio.

    2. Wijs in het menu Bestand naar Nieuw en klik vervolgens op Project.

    3. Klik in het dialoogvenster Nieuw project op Visual C# onder Projecttypen en klik vervolgens onder Sjablonen op Besturingselementbibliotheek voor Windows Forms.

    4. Typ SmoothProgressBar in het vak Naam en klik op OK.

    5. Wijzig in Projectverkenner de naam van de standaardklassemodule van UserControl1.cs in SmoothProgressBar.cs.

    6. Wijzig in het venster Eigenschappen voor het object UserControl de eigenschap Name van UserControl1 in SmoothProgressBar.

  2. Op dit moment neemt u doorgaans de klasse van dat besturingselement over en voegt u vervolgens de extra functionaliteit toe om een bestaand besturingselement uit te breiden. De klasse ProgressBar is echter verzegeld en kan niet worden overgenomen. Daarom moet u het besturingselement vanaf het begin bouwen.

    Voeg de volgende code toe aan het bestand SmoothProgressBar.cs , in de klasse die is afgeleid van UserControl.

    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));
}

  3. Klik in het menu Build op Build Solution om het project te compileren.

Een voorbeeldclienttoepassing maken

  1. Wijs in het menu Bestand naar Nieuw en klik vervolgens op Project.

  2. Klik in het dialoogvenster Nieuw project toevoegen op Visual C# onder Projecttypen, klik onder Sjablonen op Windows Forms-toepassing en klik vervolgens op OK.

  3. Volg deze stappen om twee exemplaren van het besturingselement SmoothProgressBar toe te voegen aan het formulier:

    1. Klik in het menu Extra op Werksetitems kiezen.

    2. Klik op het tabblad .NET Framework Components .

    3. Klik op Bladeren en zoek het SmoothProgressBar.dll bestand dat u hebt gemaakt in het gedeelte Een aangepaste voortgangsbalk maken.

    4. Klik op OK.

      Notitie

      Het besturingselement SmoothProgressBar wordt toegevoegd aan de werkset.

    5. Sleep twee exemplaren van het besturingselement SmoothProgressBar van de werkset naar de standaardvorm van het Windows-toepassingsproject.

  4. Sleep een timerbesturingselement van de werkset naar het formulier.

  5. Voeg de volgende code toe aan de Tick gebeurtenis van het besturingselement Timer:

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

  6. Sleep een knopbesturingselement van de werkset naar het formulier.

  7. Voeg de volgende code toe aan de Click gebeurtenis van het besturingselement Knop:

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

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

  8. Klik in het menu Foutopsporing op Start om het voorbeeldproject uit te voeren.

  9. Klik op de knop .

    Notitie

    De twee voortgangsindicatoren geven de voortgang van de tekst weer. Eén voortgangsindicator geeft de voortgang op een toenemende manier weer en de andere voortgangsindicator geeft de voortgang weer op een aflopende of aftelwijze.

  • Last updated on