Classe ProgressBar

A ProgressBar controle indica visualmente o progresso de uma operação demorada em um dos três estilos:

• Blocos segmentados que aumentam em etapas da esquerda para a direita.

• Uma BAR contínua que preencha da esquerda para a direita.

• Um bloco que rola através de um ProgressBar de maneira letreiro digital.

The Style propriedade determina o estilo do ProgressBar é exibida. Observe que o ProgressBar controle só pode ser orientado horizontalmente. Para obter um exemplo de como criar um orientado verticalmente ProgressBar, consulte o ProgressBarRenderer classe. The ProgressBar o controle é normalmente usado quando um aplicativo realiza tarefas sistema autônomo cópia de arquivos ou impressão de documentos. Usuários de um aplicativo podem considerar um aplicativo sem resposta se não houver nenhuma indicação visual. Usando o ProgressBar em seu aplicativo, você alertar o usuário que o aplicativo está executando uma longa tarefa e que o aplicativo ainda está respondendo.

The Maximum e Minimum propriedades definem o intervalo de valores para representar o andamento de uma tarefa. The Minimum propriedade costuma conjunto para um valor de 0 e o Maximum propriedade costuma conjunto para um valor que indica a conclusão de uma tarefa. Por exemplo, para exibir adequadamente o progresso ao copiar um agrupar de arquivos, o Maximum propriedade pode ser definida como o número total de arquivos a serem copiados.

The Value propriedade representa o progresso que fez o aplicativo para concluir a operação. O valor exibido pelo ProgressBar somente aproxima qual será o valor corrente das Value propriedade. Com base no dimensionar do ProgressBar, o Value propriedade determina quando exibir o próximo bloco ou aumente o dimensionar da BAR.

Há várias maneiras de modificar o valor exibido pelo ProgressBar diferente alterando o Value propriedade diretamente. Você pode usar o Step propriedade para especificar um valor específico para incrementar o Value propriedade por e, em seguida, telefonar a PerformStep método para aumentar o valor. Para variar o valor de incremento, você pode usar o Increment método e especifique um valor com o qual incrementar o Value propriedade.

Observação:
ForeColor e BackColor Altera para o ProgressBar não serão respeitadas quando estilos visuais são ativados no Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e acima.

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE Observação Zoom, Para Cima e Ampliar:

Essa classe estiver selada no .NET Compact estrutura.

O exemplo de código a seguir usa um ProgressBar controle para exibir o andamento de um arquivo operação de cópia. O exemplo usa o Minimum e Maximum propriedades para especificar um intervalo para o ProgressBar que é equivalente ao número de arquivos para copiar. O código também usa o Step propriedade com o PerformStep método para incrementar o valor da ProgressBar sistema autônomo um arquivo é copiado. Este exemplo requer que você tenha um ProgressBar controle criado chamado pBar1 que é criado dentro de um Form e que há um método criado chamado CopyFile (que retorna um valor boolianoo que indica o arquivo operação de cópia concluída com êxito) que executa o arquivo operação de cópia. O código também requer que uma matriz de seqüências de caracteres que contém os arquivos para copiar é criada e passada para o CopyWithProgress método definido em exemplo e que o método é chamado de outro método ou evento no Form.

privatevoid 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();
				}
			}
		}

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

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework

.NET Compact Framework

Referência