Comment créer une barre de progression sans heurts dans Visual C#

Pour obtenir une version Microsoft Visual Basic .NET de cet article, reportez-vous à la section 323088 .

Résumé

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

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

Le contrôle ProgressBar qui est inclus avec Microsoft Visual C# prend en charge uniquement le paramètre par défaut.

L’exemple de code dans 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 le cours. La valeur par défaut de cette propriété est zéro (0) ; Vous ne pouvez pas définir cette propriété à une valeur négative.
  • Maximum. Cette propriété obtient ou définit la valeur supérieure de la plage de valeurs valides pour le cours. La valeur par défaut de cette propriété est 100.
  • Valeur. Cette propriété obtient ou définit le niveau actuel de la progression. La valeur doit être dans la plage minimale et maximale propriétés définissent.
  • ProgressBarColor. Cette propriété obtient ou définit la couleur de la barre de progression.

Créer un contrôle personnalisé de ProgressBar

  1. Suivez ces étapes pour créer un nouveau 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 cliquez sur Bibliothèque de contrôles Windows Forms sous modèles.

      Remarque Dans Visual Studio .NET 2003, cliquez sur Projets Visual C# , au lieu de Visual C#.
    4. Dans la zone nom , tapez SmoothProgressBar, puis cliquez sur OK.
    5. Dans l’Explorateur de projet, renommez le module de classe par défaut à partir de UserControl1.cs à SmoothProgressBar.cs.
    6. Dans la fenêtre Propriétés de l’objet UserControl , modifiez la propriété nom UserControl1 à SmoothProgressBar.
  2. À ce stade, vous héritez généralement de la classe du contrôle et puis ajoutez des fonctionnalités supplémentaires pour étendre un contrôle existant. Toutefois, la classe ProgressBar est sealed et ne peut pas être héritée. Par conséquent, vous devez créer le contrôle à partir du début.

    Ajoutez le code suivant au fichier SmoothProgressBar.cs, dans la classe qui est dérivée de UserControl.

    Remarque Dans Visual Studio .NET 2003, ajoutez le code au module de classe de la classe dérivée de UserControl, juste après la section « Code généré par le Concepteur Windows Form ».
    int min = 0;// Minimum value for progress rangeint 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)
    {
    min = 0;
    }

    // Make sure that the minimum value is never set higher than the maximum value.
    if (value > max)
    {
    min = 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, cliquez sur Application Windows Forms sous modèles, puis cliquez sur OK.

    Remarque Dans Visual Studio .NET 2003, cliquez sur Projets Visual C# , au lieu de Visual C#.
  3. Suivez ces étapes 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.

      Remarque Dans Visual Studio .NET 2003, cliquez sur Personnaliser la boîte à outils au lieu de Choisir des éléments de boîte à outils.
    2. Cliquez sur l’onglet Composants de.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. Notez que le contrôle SmoothProgressBar est ajouté à la boîte à outils.
    5. Faites glisser deux instances du contrôle SmoothProgressBar à partir de la boîte à outils vers le formulaire par défaut du projet Application Windows.
  4. Faites glisser un contrôle Timer à partir de la boîte à outils vers le formulaire.
  5. Ajoutez le code suivant à l’événement Tick du contrôle Timer :
    if (this.smoothProgressBar1.Value > 0){
    this.smoothProgressBar1.Value--;
    this.smoothProgressBar2.Value++;
    }
    else
    {
    this.timer1.Enabled = false;
    }

  6. Faites glisser un contrôle Button à partir 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éboguer , cliquez sur Démarrer pour exécuter l’exemple de projet.
  9. Cliquez sur le bouton. Notez que les indicateurs de deux progression affichent le texte « en cours ». Un indicateur de progression affiche la progression de façon croissante, et l’autre indicateur de progression affiche la progression dans une réduction ou d’une manière de compte à rebours.
Propriétés

ID d'article : 323116 - Dernière mise à jour : 27 janv. 2017 - Révision : 1

Commentaires