Partager via

Utiliser Visual C# pour créer une barre de progression fluide

Cet article fournit des informations sur la création d’un Contrôle UserControl personnalisé pour créer un contrôle ProgressBar lisse et à défilement.

Version du produit d’origine : Visual C#
Numéro de base de connaissances d’origine : 323116

Résumé

Cet article montre comment créer un contrôle UserControl simple et personnalisé pour créer un contrôle ProgressBar lisse et à défilement.

Dans les versions antérieures du contrôle ProgressBar, comme la version fournie avec le contrôle Microsoft Windows Common Controls ActiveX, vous pouvez afficher la progression dans deux vues différentes. Pour contrôler ces vues, vous utilisez la propriété Scrolling, qui inclut des paramètres standard et lisses. Le défilement lisse produit un bloc de couleur unie qui représente la progression, et le défilement standard apparaît segmenté et est constitué d’une série de petits blocs ou rectangles.

Le contrôle ProgressBar inclus dans Microsoft Visual C# prend uniquement en charge le paramètre standard.

L’exemple de code de cet article montre comment créer un contrôle qui prend en charge les propriétés suivantes :

  • Minimum : cette propriété obtient ou définit la valeur inférieure de la plage de valeurs valides pour la progression. La valeur par défaut de cette propriété est zéro (0) ; vous ne pouvez pas définir cette propriété sur une valeur négative.
  • Maximum : cette propriété obtient ou définit la valeur supérieure de la plage de valeurs valides pour la progression. La valeur par défaut de cette propriété est 100.
  • Valeur : cette propriété obtient ou définit le niveau de progression actuel. La valeur doit être dans la plage définie par les propriétés Minimum et Maximum.
  • ProgressBarColor : cette propriété obtient ou définit la couleur de la barre de progression.

Créer un contrôle ProgressBar personnalisé

  1. Procédez comme suit pour créer un projet de bibliothèque de contrôles Windows dans Visual C# :

    1. Démarrez Microsoft Visual Studio.

    2. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.

    3. Dans la boîte de dialogue Nouveau projet , cliquez sur Visual C# sous Types de projets, puis sur Bibliothèque de contrôle Windows Forms sous Modèles.

    4. Dans la zone Nom , tapez SmoothProgressBar, puis cliquez sur OK.

    5. Dans l’Explorateur de projets, renommez le module de classe par défaut de UserControl1.cs en SmoothProgressBar.cs.

    6. Dans la fenêtre Propriétés de l’objet UserControl, remplacez la propriété Name de UserControl1 par SmoothProgressBar.

  2. À ce stade, vous héritez généralement de la classe de ce contrôle, puis ajoutez les fonctionnalités supplémentaires pour étendre un contrôle existant. Toutefois, la classe ProgressBar est scellée et ne peut pas être héritée. Par conséquent, vous devez générer le contrôle à partir du début.

    Ajoutez le code suivant au fichier SmoothProgressBar.cs , dans la classe dérivée de 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. Dans le menu Générer , cliquez sur Générer la solution pour compiler le projet.

Créer un exemple d’application cliente

  1. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.

  2. Dans la boîte de dialogue Ajouter un nouveau projet , cliquez sur Visual C# sous Types de projets, sur Application Windows Forms sous Modèles, puis sur OK.

  3. Procédez comme suit pour ajouter deux instances du contrôle SmoothProgressBar au formulaire :

    1. Dans le menu Outils , cliquez sur Choisir des éléments de boîte à outils.

    2. Cliquez sur l’onglet Composants .NET Framework.

    3. Cliquez sur Parcourir, puis recherchez le fichier SmoothProgressBar.dll que vous avez créé dans la section Créer un contrôle ProgressBar personnalisé.

    4. Cliquez sur OK.

      Note

      Le contrôle SmoothProgressBar est ajouté à la boîte à outils.

    5. Faites glisser deux instances du contrôle SmoothProgressBar de la boîte à outils vers la forme par défaut du projet d’application Windows.

  4. Faites glisser un contrôle Minuteur de la boîte à outils vers le formulaire.

  5. Ajoutez le code suivant à l’événement Tick du contrôle Minuteur :

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

  6. Faites glisser un contrôle Button de la boîte à outils vers le formulaire.

  7. Ajoutez le code suivant à l’événement Click du contrôle Button :

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

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

  8. Dans le menu Débogage , cliquez sur Démarrer pour exécuter l’exemple de projet.

  9. Cliquez sur le bouton .

    Note

    Les deux indicateurs de progression affichent la progression du texte. Un indicateur de progression affiche la progression de manière croissante, et l’autre indicateur de progression affiche la progression de manière décroissante ou de compte à rebours.

  • Last updated on