Como usar controles de barra de progresso

Este tópico explica como usar uma barra de progresso para indicar o andamento de uma longa operação de análise de arquivos.

O que você precisa saber

Tecnologias

Pré-requisitos

  • C/C++
  • Programação da interface do usuário do Windows

Instruções

Criar um controle da barra de progresso

O código de exemplo a seguir cria uma barra de progresso e a posiciona ao longo da parte inferior da área do cliente da janela pai. A altura da barra de progresso é baseada na altura do bitmap de seta usado em uma barra de rolagem. O intervalo é baseado no tamanho do arquivo dividido por 2.048, que é o tamanho de cada "pedaço" de dados que é lido do arquivo. O exemplo também define um incremento e avança a posição atual da barra de progresso pelo incremento depois de analisar cada bloco.

// ParseALargeFile - uses a progress bar to indicate the progress of a parsing operation.
//
// Returns TRUE if successful, or FALSE otherwise.
//
// hwndParent - parent window of the progress bar.
//
// lpszFileName - name of the file to parse. 
// 
// Global variable 
//     g_hinst - instance handle.
//

extern HINSTANCE g_hinst; 

BOOL ParseALargeFile(HWND hwndParent, LPTSTR lpszFileName) 
{ 
    RECT rcClient;  // Client area of parent window.
    int cyVScroll;  // Height of scroll bar arrow.
    HWND hwndPB;    // Handle of progress bar.
    HANDLE hFile;   // Handle of file.
    DWORD cb;       // Size of file and count of bytes read.
    LPCH pch;       // Address of data read from file.
    LPCH pchTmp;    // Temporary pointer.

    // Ensure that the common control DLL is loaded, and create a progress bar 
    // along the bottom of the client area of the parent window. 
    //
    // Base the height of the progress bar on the height of a scroll bar arrow.
    
    InitCommonControls(); 
    
    GetClientRect(hwndParent, &rcClient); 
    
    cyVScroll = GetSystemMetrics(SM_CYVSCROLL); 

    hwndPB = CreateWindowEx(0, PROGRESS_CLASS, (LPTSTR) NULL, 
                            WS_CHILD | WS_VISIBLE, rcClient.left, 
                            rcClient.bottom - cyVScroll, 
                            rcClient.right, cyVScroll, 
                            hwndParent, (HMENU) 0, g_hinst, NULL);

    // Open the file for reading, and retrieve the size of the file. 

    hFile = CreateFile(lpszFileName, GENERIC_READ, FILE_SHARE_READ, 
                       (LPSECURITY_ATTRIBUTES) NULL, OPEN_EXISTING, 
                       FILE_ATTRIBUTE_NORMAL, (HANDLE) NULL); 

    if (hFile == (HANDLE) INVALID_HANDLE_VALUE)
        return FALSE; 

    cb = GetFileSize(hFile, (LPDWORD) NULL); 

    // Set the range and increment of the progress bar. 

    SendMessage(hwndPB, PBM_SETRANGE, 0, MAKELPARAM(0, cb / 2048));
    
    SendMessage(hwndPB, PBM_SETSTEP, (WPARAM) 1, 0); 

    // Parse the file. 
    pch = (LPCH) LocalAlloc(LPTR, sizeof(char) * 2048); 
    
    pchTmp = pch; 
    
    do { 
        ReadFile(hFile, pchTmp, sizeof(char) * 2048, &cb, (LPOVERLAPPED) NULL);
        
        // TODO: Write an error handler to check that all the
        // requested data was read.
        //
        // Include here any code that parses the
        // file. 
        //  
        //  
        //  
        // Advance the current position of the progress bar by the increment.
        
        SendMessage(hwndPB, PBM_STEPIT, 0, 0); 
        
    } while (cb); 

    CloseHandle((HANDLE) hFile);
    
    DestroyWindow(hwndPB);

    return TRUE; 
}

Comentários

Você deve certificar-se de usar a função ReadFile corretamente, para garantir a segurança do seu aplicativo. Por exemplo, no código de exemplo, você deve verificar se ReadFile realmente lê todos os dados solicitados.

Observe também que o quarto parâmetro de CreateFile—(LPSECURITY_ATTRIBUTES)NULL—define valores de segurança padrão. Se você precisar de configurações de segurança específicas, deverá definir os valores apropriados nos membros da estrutura. Chame sizeof para definir o tamanho correto da estrutura LPSECURITY_ATTRIBUTES .

Para obter mais informações, consulte Considerações de segurança: controles do Microsoft Windows.

Usando controles da barra de progresso

Considerações de segurança: Controles do Microsoft Windows

 

 

  • Last updated on