ProgressBar, classe (System.Windows.Forms)

Bibliothèque de classes .NET Framework 
ProgressBar, classe 

Représente un contrôle de barre de progression Windows.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

SyntaxeSyntaxe


Visual Basic (Déclaration)
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class ProgressBar
    Inherits Control


Visual Basic (Utilisation)
Dim instance As ProgressBar


C#
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class ProgressBar : Control


C++
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
[ComVisibleAttribute(true)] 
public ref class ProgressBar : public Control


J#
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class ProgressBar extends Control


JScript
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class ProgressBar extends Control
NotesNotes

Un contrôle ProgressBar indique visuellement la progression d'une opération longue à l'aide de trois styles différents :

  • Blocs segmentés qui augmentent par étapes de gauche à droite.

  • Barre continue qui se remplit de gauche à droite.

  • Bloc qui défile le long de ProgressBar à la manière d'un texte défilant.

La propriété Style détermine le style de ProgressBar qui est affiché. Notez que le contrôle ProgressBar peut uniquement être orienté horizontalement. Pour obtenir un exemple de la façon de créer un ProgressBar orienté verticalement, consultez la classe ProgressBarRenderer. Le contrôle ProgressBar est en règle générale utilisé lorsqu'une application effectue des tâches telles que la copie de fichiers ou l'impression de documents. En l'absence d'indicateur visuel, les utilisateurs d'une application risquent de penser qu'elle ne répond pas. En utilisant ProgressBar dans votre application, vous alertez l'utilisateur que l'application effectue une tâche de longue durée et qu'elle répond toujours.

Les propriétés Maximum et Minimum définissent la plage de valeurs pour représenter la progression d'une tâche. La valeur attribuée à la propriété Minimum est généralement 0 et celle attribuée à la propriété Maximum indique généralement l'achèvement d'une tâche. Par exemple, pour afficher correctement la progression de la copie d'un groupe de fichiers, la valeur à attribuer à la propriété Maximum pourrait être le nombre total de fichiers à copier.

La propriété Value représente la progression de l'application dans l'achèvement de l'opération. La valeur affichée par ProgressBar n'est qu'une approximation de la valeur actuelle de la propriété Value. En fonction de la taille de ProgressBar, la propriété Value détermine quand afficher le bloc suivant ou augmenter la taille de la barre.

Il existe de nombreuses autres manières de modifier la valeur affichée par ProgressBar que de modifier directement la propriété Value. Vous pouvez utiliser la propriété Step pour définir une valeur d'incrément spécifique de la propriété Value, puis appeler la méthode PerformStep pour incrémenter la valeur. Pour faire varier la valeur d'incrément, vous pouvez utiliser la méthode Increment et spécifier une nouvelle valeur d'incrément de la propriété Value.

RemarqueRemarque

Les modifications de ForeColor pour le ProgressBar ne sont pas honorées lorsque les styles visuels sont activés sur Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003 et versions ultérieures.

ExempleExemple

L'exemple de code suivant utilise un contrôle ProgressBar pour afficher la progression d'une opération de copie d'un fichier. L'exemple utilise les propriétés Minimum et Maximum pour spécifier pour ProgressBar une plage équivalente au nombre de fichiers à copier. Le code utilise aussi la propriété Step avec la méthode PerformStep pour incrémenter la valeur de ProgressBar chaque fois qu'un fichier est copié. Cet exemple suppose que vous avez créé un contrôle ProgressBar nommé pBar1 dans Form et une méthode nommée CopyFile (qui retourne une valeur Boolean indiquant que l'opération de copie du fichier s'est achevée avec succès) qui effectue l'opération de copie des fichiers. Le code suppose également qu'un tableau de chaînes contenant les fichiers à copier est créé et passé à la méthode CopyWithProgress définie dans l'exemple et que la méthode est appelée depuis une autre méthode ou un autre événement dans Form.



Visual Basic
Private Sub CopyWithProgress(ByVal ParamArray filenames As String())
    ' Display the ProgressBar control.
    pBar1.Visible = True
    ' Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1
    ' Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length
    ' Set the initial value of the ProgressBar.
    pBar1.Value = 1
    ' Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1

    ' Loop through all files to copy.
    Dim x As Integer
    for x = 1 To filenames.Length - 1
        ' Copy the file and increment the ProgressBar if successful.
        If CopyFile(filenames(x - 1)) = True Then
            ' Perform the increment on the ProgressBar.
            pBar1.PerformStep()
        End If
    Next x
End Sub


C#
private void CopyWithProgress(string[] filenames)
{
    // Display the ProgressBar control.
    pBar1.Visible = true;
    // Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1;
    // Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length;
    // Set the initial value of the ProgressBar.
    pBar1.Value = 1;
    // Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1;
    
    // Loop through all files to copy.
    for (int x = 1; x <= filenames.Length; x++)
    {
        // Copy the file and increment the ProgressBar if successful.
        if(CopyFile(filenames[x-1]) == true)
        {
            // Perform the increment on the ProgressBar.
            pBar1.PerformStep();
        }
    }
}


C++
private:
   void CopyWithProgress( array<String^>^filenames )
   {
      // Display the ProgressBar control.
      pBar1->Visible = true;

      // Set Minimum to 1 to represent the first file being copied.
      pBar1->Minimum = 1;

      // Set Maximum to the total number of files to copy.
      pBar1->Maximum = filenames->Length;

      // Set the initial value of the ProgressBar.
      pBar1->Value = 1;

      // Set the Step property to a value of 1 to represent each file being copied.
      pBar1->Step = 1;

      // Loop through all files to copy.
      for ( int x = 1; x <= filenames->Length; x++ )
      {
         // Copy the file and increment the ProgressBar if successful.
         if ( CopyFile( filenames[ x - 1 ] ) == true )
         {
            // Perform the increment on the ProgressBar.
            pBar1->PerformStep();
         }
      }
   }


J#
private void CopyWithProgress(String fileNames[])
{
    // Display the ProgressBar control.
    pBar1.set_Visible(true);
    // Set Minimum to 1 to represent the first file being copied.
    pBar1.set_Minimum(1);
    // Set Maximum to the total number of files to copy.
    pBar1.set_Maximum(fileNames.get_Length());
    // Set the initial value of the ProgressBar.
    pBar1.set_Value(1);
    // Set the Step property to a value of 1 to represent each file
    // being copied.
    pBar1.set_Step(1);
    // Loop through all files to copy.
    for (int x = 1; x <= fileNames.get_Length(); x++) {
        // Copy the file and increment the ProgressBar if successful.
        if (CopyFile(fileNames[(x - 1)]) == true) {
            // Perform the increment on the ProgressBar.
            pBar1.PerformStep();
        }
    }
} //CopyWithProgress
Hiérarchie d'héritageHiérarchie d'héritage
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.ProgressBar
Sécurité des threadsSécurité des threads
Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Plates-formesPlates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de versionInformations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Voir aussiVoir aussi

Ces informations proviennent du site de http://msdn2.microsoft.com
Source de cette page : http://msdn2.microsoft.com/fr-fr/library/system.windows.forms.progressbar.aspx

Réseaux sociaux

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

 

Nuage de mots clés

9 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

 

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html
Aucun commentaire pour cette page

© Ce document issu de l′infobrol est enregistré sous le certificat Cyber PrInterDeposit Digital Numbertection. Enregistrement IDDN n° 5329-4332
Document créé le 12/10/06 23:51, dernière modification le Vendredi 17 Juin 2011, 12:11
Source du document imprimé : http://www.gaudry.be/dotnet-rf-system.windows.forms.progressbar.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02
Outils (masquer)
||
Recherche (afficher)
Recherche :

Utilisateur (masquer)
Apparence (afficher)
Stats (afficher)
15832 documents
452 astuces.
549 niouzes.
3099 definitions.
447 membres.
8115 messages.

Document genere en :
0,40 seconde

Mises à jour :
Mises à jour du site
Citation (masquer)
Si vous parlez à Dieu, vous êtes croyant. S'il vous répond, vous êtes schizophrène

Dr House [Les fameuses phrases de Dr House]
 
l'infobrol
Nous sommes le Vendredi 01 Juin 2012, 05:43, toutes les heures sont au format GMT+1.00 Heure, heure d'été (+1)