Usare Visual C# per creare un indicatore di stato uniforme

Articolo
07/17/2023

Questo articolo fornisce informazioni su come creare un controllo UserControl personalizzato per creare un controllo ProgressBar scorrevole e scorrevole.

Versione originale del prodotto: Oggetto visivo C#
Numero KB originale: 323116

Riepilogo

Questo articolo illustra come creare un controllo UserControl semplice e personalizzato per creare un controllo ProgressBar scorrevole e scorrevole.

Nelle versioni precedenti del controllo ProgressBar, ad esempio la versione fornita con il controllo ActiveX Controlli comuni di Microsoft Windows, è possibile visualizzare lo stato di avanzamento in due visualizzazioni diverse. Per controllare queste visualizzazioni, si usa la proprietà Scrolling, che include impostazioni standard e uniformi. Lo scorrimento uniforme produce un blocco di colore a tinta unita che rappresenta lo stato di avanzamento e lo scorrimento standard viene segmentato ed è costituito da una serie di piccoli blocchi o rettangoli.

Il controllo ProgressBar incluso in Microsoft Visual C# supporta solo l'impostazione standard.

Il codice di esempio in questo articolo illustra come creare un controllo che supporti le proprietà seguenti:

Minimo: questa proprietà ottiene o imposta il valore inferiore per l'intervallo di valori validi per lo stato di avanzamento. Il valore predefinito di questa proprietà è zero (0); non è possibile impostare questa proprietà su un valore negativo.
Massimo: questa proprietà ottiene o imposta il valore superiore per l'intervallo di valori validi per lo stato di avanzamento. Il valore predefinito di questa proprietà è 100.
Valore: questa proprietà ottiene o imposta il livello di avanzamento corrente. Il valore deve essere compreso nell'intervallo definito dalle proprietà Minimum e Maximum.
ProgressBarColor: questa proprietà ottiene o imposta il colore dell'indicatore di stato.

Creare un controllo ProgressBar personalizzato

Seguire questa procedura per creare un nuovo progetto libreria di controlli Windows in Visual C#:
1. Avviare Microsoft Visual Studio.
2. Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
3. Nella finestra di dialogo Nuovo progetto fare clic su Visual C# in Tipi di progetto e quindi su Windows Forms Libreria di controlli in Modelli.
4. Nella casella Nome digitare SmoothProgressBar e quindi fare clic su OK.
5. In Esplora progetti rinominare il modulo di classe predefinito da UserControl1.cs a SmoothProgressBar.cs.
6. Nella finestra Proprietà dell'oggetto UserControl modificare la proprietà Name da UserControl1 a SmoothProgressBar.

A questo punto, in genere si eredita dalla classe di tale controllo e quindi si aggiungono le funzionalità aggiuntive per estendere un controllo esistente. Tuttavia, la classe ProgressBar è sealed e non può essere ereditata. Pertanto, è necessario compilare il controllo dall'inizio.

Aggiungere il codice seguente al file SmoothProgressBar.cs nella classe derivata da 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));
}

Scegliere Compila soluzione dal menu Compila per compilare il progetto.

Creare un'applicazione client di esempio

Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nella finestra di dialogo Aggiungi nuovo progetto fare clic su Visual C# in Tipi di progetto, fare clic su Windows Forms'applicazione in Modelli e quindi fare clic su OK.
Seguire questa procedura per aggiungere due istanze del controllo SmoothProgressBar al modulo:
1. Nel menu Strumenti fare clic su Scegli elementi della casella degli strumenti.
2. Fare clic sulla scheda Componenti di .NET Framework .
3. Fare clic su Sfoglia e quindi individuare il file SmoothProgressBar.dll creato nella sezione Creare un controllo ProgressBar personalizzato .
4. Fare clic su OK.
  
  Nota
  
  Il controllo SmoothProgressBar viene aggiunto alla casella degli strumenti.
5. Trascinare due istanze del controllo SmoothProgressBar dalla casella degli strumenti al formato predefinito del progetto applicazione Windows.
Trascinare un controllo Timer dalla casella degli strumenti al form.

Aggiungere il codice seguente all'evento Tick del controllo Timer:

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

Trascinare un controllo Button dalla casella degli strumenti al form.

Aggiungere il codice seguente all'evento Click del controllo Button:

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

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

Scegliere Avvia dal menu Debug per eseguire il progetto di esempio.
Fare clic sul pulsante.

Nota

I due indicatori di stato visualizzano lo stato del testo. Un indicatore di stato visualizza lo stato di avanzamento in modo crescente e l'altro indicatore di stato visualizza lo stato in modo decrescente o conto alla rovescia.

Usare Visual C# per creare un indicatore di stato uniforme

Riepilogo

Creare un controllo ProgressBar personalizzato

Creare un'applicazione client di esempio

Commenti e suggerimenti

Commenti e suggerimenti

Risorse aggiuntive