Cómo crear una barra de progreso suave en Visual C#

Seleccione idioma Seleccione idioma
Id. de artículo: 323116 - Ver los productos a los que se aplica este artículo
Para obtener una versión de Microsoft Visual Basic .NET de este artículo, consulte 323088.
Expandir todo | Contraer todo

En esta página

Resumen

En este artículo se muestra cómo crear un sencillo y personalizado UserControl para crear un suave, desplazamiento control ProgressBar .

En versiones anteriores del control ProgressBar , como la versión que se proporciona con el control ActiveX de controles comunes de Microsoft Windows, puede ver el progreso en dos vistas distintas. Para controlar estas vistas, utilice la propiedad de desplazamiento , que incluye la configuración estándar y suave. Desplazamiento suave genera un bloque sólido del color que representa el progreso y desplazamiento estándar aparece segmentada y se compone de una serie de bloques pequeños o rectángulos.

El control ProgressBar se incluye con Microsoft Visual C# admite sólo la configuración estándar.

El código de ejemplo en este artículo muestra cómo crear un control que admite las siguientes propiedades:
  • como mínimo . Esta propiedad obtiene o establece el valor inferior para el rango de valores válidos para el progreso. El valor predeterminado de esta propiedad es cero (0); no se puede establecer esta propiedad en un valor negativo.
  • máximo . Esta propiedad obtiene o establece el valor superior para el rango de valores válidos para el progreso. El valor predeterminado de esta propiedad es 100.
  • valor . Esta propiedad obtiene o establece el nivel actual de progreso. El valor debe estar en el intervalo que definen propiedades máximo y mínimo .
  • ProgressBarColor . Esta propiedad obtiene o establece el color de la barra de progreso.

Crear un control ProgressBar personalizado

  1. Siga estos pasos para crear un nuevo proyecto de biblioteca de controles de Windows en Visual C#:
    1. Inicie Microsoft Visual Studio.
    2. En el menú archivo , seleccione nuevo y, a continuación, haga clic en proyecto .
    3. En el cuadro de diálogo Nuevo proyecto , haga clic en C# en Tipos de proyecto y, a continuación, haga clic en Biblioteca de controles de Windows Forms en plantillas .

      Nota En Visual Studio .NET 2003, haga clic en Proyectos de Visual C# en lugar de C# .
    4. En el cuadro nombre , escriba SmoothProgressBar y, a continuación, haga clic en Aceptar .
    5. En el Explorador de proyectos, cambiar el nombre del módulo de clase predeterminado desde UserControl1.cs a SmoothProgressBar.cs.
    6. En la ventana Propiedades para el objeto UserControl , cambie la propiedad de nombre de UserControl1 a SmoothProgressBar .
  2. En este momento, habitualmente se hereda de la clase de ese control y, a continuación, agregar la funcionalidad adicional para extender un control existente. Sin embargo, la clase ProgressBar es sealed y no se puede heredar. Por lo tanto, debe generar el control desde el principio.

    Agregue el código siguiente al archivo SmoothProgressBar.cs, en la clase que se deriva de UserControl.

    Nota En Visual Studio .NET 2003, agregue el código al módulo de clase de la clase derivada de UserControl, sólo después de la sección ? código generado por el Diseñador de Windows Forms ?.
    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)
    		{
    			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. En el menú Generar , haga clic en Generar solución para compilar el proyecto.

Crear una aplicación de cliente de ejemplo

  1. En el menú archivo , seleccione nuevo y, a continuación, haga clic en proyecto .
  2. En el cuadro de diálogo Agregar nuevo proyecto , haga clic en C# en Tipos de proyecto , haga clic en Aplicación de Windows Forms en plantillas y, a continuación, haga clic en Aceptar .

    Nota En Visual Studio .NET 2003, haga clic en Proyectos de Visual C# en lugar de C# .
  3. Siga estos pasos para agregar dos instancias del control SmoothProgressBar al formulario:
    1. En el menú Herramientas , haga clic en Elegir elementos del cuadro de herramientas .

      Nota En Visual Studio .NET 2003, haga clic en Personalizar cuadro de herramientas en lugar de Elegir elementos del cuadro de herramientas .
    2. Haga clic en la ficha Componentes de .NET Framework .
    3. Haga clic en Examinar y, a continuación, busque el archivo SmoothProgressBar.dll, que creó en la sección "Create a custom ProgressBar control".
    4. Haga clic en Aceptar . Observe que el control SmoothProgressBar se agrega al cuadro de herramientas.
    5. Arrastre dos instancias del control SmoothProgressBar desde el cuadro de herramientas al formulario predeterminado del proyecto de aplicación para Windows.
  4. Arrastre un control Timer desde el cuadro de herramientas hasta el formulario.
  5. Agregue el código siguiente al evento Tick del control Timer :
    if (this.smoothProgressBar1.Value > 0)
    {
    	this.smoothProgressBar1.Value--;
    	this.smoothProgressBar2.Value++;
    }
    else
    {
    	this.timer1.Enabled = false;
    } 
    					
  6. Arrastre un control Button desde el cuadro de herramientas al formulario.
  7. Agregue el código siguiente al evento Click del control Button :
    this.smoothProgressBar1.Value = 100;
    this.smoothProgressBar2.Value = 0;
    			
    this.timer1.Interval = 1;
    this.timer1.Enabled = true; 
    					
  8. En el menú Depurar , haga clic en iniciar para ejecutar el proyecto de ejemplo.
  9. Haga clic en el button. Observe que los indicadores de dos progreso mostrar el texto "progreso". Un indicador de progreso muestra el progreso de una manera creciente y el indicador de progreso muestra el progreso en una disminución o un modo de cuenta atrás.

Propiedades

Id. de artículo: 323116 - Última revisión: viernes, 01 de agosto de 2008 - Versión: 4.1
La información de este artículo se refiere a:
  • Microsoft Visual C# 2008 Express Edition
  • Microsoft Visual C# 2005 Express Edition
Palabras clave: 
kbmt kbsweptvs2008 kbhowtomaster KB323116 KbMtes
Traducción automática
IMPORTANTE: Este artículo ha sido traducido por un software de traducción automática de Microsoft (http://support.microsoft.com/gp/mtdetails) en lugar de un traductor humano. Microsoft le ofrece artículos traducidos por un traductor humano y artículos traducidos automáticamente para que tenga acceso en su propio idioma a todos los artículos de nuestra base de conocimientos (Knowledge Base). Sin embargo, los artículos traducidos automáticamente pueden contener errores en el vocabulario, la sintaxis o la gramática, como los que un extranjero podría cometer al hablar el idioma. Microsoft no se hace responsable de cualquier imprecisión, error o daño ocasionado por una mala traducción del contenido o como consecuencia de su utilización por nuestros clientes. Microsoft suele actualizar el software de traducción frecuentemente.
Haga clic aquí para ver el artículo original (en inglés): 323116

Enviar comentarios

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com