このトピックでは、進行状況バーを使用して、時間のかかるファイル解析操作の進行状況を示す方法について説明します。
知っておくべきこと
テクノロジ
前提条件
- C/C++
- Windows ユーザー インターフェイス プログラミング
手順
進行状況バー コントロールを作成する
次のコード例では、進行状況バーを作成し、親ウィンドウのクライアント領域の下部に配置します。 進行状況バーの高さは、スクロール バーで使用される矢印ビットマップの高さに基づきます。 範囲は、ファイルのサイズを 2,048 で割った値に基づきます。これは、ファイルから読み取られたデータの各 "チャンク" のサイズです。 また、この例では、増分を設定し、各チャンクを解析した後に進行状況バーの現在位置を増分の分だけ進めます。
// 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;
}
解説
アプリケーションのセキュリティを確保するためには、ReadFile 関数を正しく使用する必要があります。 たとえば、このコード例では、ReadFile が、要求されたすべてのデータを実際に読み取っているか確認する必要があります。
また、CreateFile の 4 番目のパラメーター (LPSECURITY_ATTRIBUTES)NULL で、既定のセキュリティ値が設定されていることに注目してください。 特定のセキュリティ設定が必要な場合は、構造体のメンバーに適切な値を設定する必要があります。 sizeof を呼び出して、LPSECURITY_ATTRIBUTES 構造体の正しいサイズを設定します。
詳細については、「セキュリティの考慮事項: Microsoft Windows コントロール」を参照してください。
関連トピック