プログレスバー

ホーム

ATL/WTL

プログレスバー

ドキュメント種別	ATL/WTL に関する文書
最終更新日	2007/03/21
PR

　WTLではコモンコントロールのプログレスバーコントロールをCProgressBarCtrlT というクラステンプレートでカプセル化しています。テンプレート引数にはクラスを指定しますが、そのクラスはCProgressBarCtrlTの基底クラスとして使用されます。 atlctrls.hヘッダではtypedefによって次のように宣言されています。

// atlctrls.h
typedef CProgressBarCtrlT<ATL::CWindow>   CProgressBarCtrl;

これは、CProgressBarCtrlクラスはCWindowクラスの派生クラスであることを意味します。

　WTLのCProgressBarCtrlクラスは、MFCのCProgressCtrlクラスとほぼ同じメンバ関数を用意しています。以下に示すのは、CProgressBarCtrlクラスを使用する例です。［開始］ボタンを押すと100ミリ秒毎に1/10ずつバーを進めます。

	プロジェクトファイルダウンロード

// stdafx.h
#pragma once

#include <atlbase.h>
#include <atlapp.h>
extern CAppModule _Module;
#include <atlwin.h>

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlctrls.h>  // コントロール用クラスを使用するため

// MainDlg.h
#pragma once

class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    CProgressBarCtrl m_progress_sec;

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        COMMAND_ID_HANDLER_EX(IDC_BUTTON_START, OnButtonStart)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        // スクリーンの中央に配置
        CenterWindow();

        // 大きいアイコン設定
        HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));
        SetIcon(hIcon, TRUE);
        
        // 小さいアイコン設定
        HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));
        SetIcon(hIconSmall, FALSE);

        // コントロール設定
        m_progress_sec = GetDlgItem(IDC_PROGRESS_SEC);

        m_progress_sec.SetRange(0, 10);
        m_progress_sec.SetPos(0);

        return TRUE;
    }

    void OnButtonStart(UINT uNotifyCode, int nID, CWindow wndCtl){
        for(int i=0; i<=10; i++){
            m_progress_sec.SetPos(i);
            Sleep(100);
        }
    }

    void OnOK(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }
};

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "MainDlg.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, 
    HINSTANCE /*hPrevInstance*/, LPTSTR /*lpstrCmdLine*/, int /*nCmdShow*/)
{
    HRESULT hRes = ::CoInitialize(NULL);
    ATLASSERT(SUCCEEDED(hRes));

    ::DefWindowProc(NULL, 0, 0, 0L);

    AtlInitCommonControls(ICC_WIN95_CLASSES);

    hRes = _Module.Init(NULL, hInstance);
    ATLASSERT(SUCCEEDED(hRes));

    CMainDlg dlg;
    int nRet = (int) dlg.DoModal();

    _Module.Term();
    ::CoUninitialize();

    return nRet;
}

　まず、リソースを作成します。ダイアログにプログレスバーコントロールとボタンコントロールを配置し、それぞれの［Caption］と［ID］を次のように設定します。なお、プログレスバーコントロールの［プロパティ］では［Smooth］を［True］に設定します。

コントロール名	Caption	ID
プログレスバー	-	IDC_PROGRESS_SEC
ボタン	開始	IDC_BUTTON_START

　次に、stdafx.hヘッダでは、CProgressBarCtrlクラスを使用するためにatlctrls.hヘッダをインクルードします。

　CMainDlgクラスでは、まず、プログレスバーコントロール用にCProgressBarCtrlクラスのインスタンスをメンバ変数として宣言します。これを使うためには、WM_INITDIALOGメッセージハンドラでコントロールのハンドルを代入する必要があります。

　次に、WM_INITDIALOGメッセージハンドラでSetRange()とSetPos()を呼び出してプログレスバーコントロールの範囲と初期位置を設定します。

　次に、リソースIDがIDC_BUTTON_STARTのWM_COMMANDメッセージハンドラとしてOnButtonStart()を追加します。このハンドラ関数ではSetPos()を呼び出してバーを1/10ずつ進めます。なお、Sleep()で100ミリ秒毎にプログラムをスリープさせるため、バーが最後まで進むのに約１秒かかります。

　最後に_tWinMain()で、引数にICC_WIN95_CLASSESを指定してAtlInitCommonControls()を呼び出します。

　今回の例ではバーを進めるためにSetPos()を使用しましたが、 CProgressBarCtrlクラスは、バーを進めるために別の2つの方法を用意しています。

　1番目の方法は、OffsetPos()を使用する方法です。 OffsetPos()はバーの位置を現在の位置から相対的に設定します。

void OnButtonStart(UINT uNotifyCode, int nID, CWindow wndCtl){
    m_progress_sec.SetPos(0);
    for(int i=0; i<10; i++){
        m_progress_sec.OffsetPos(1);  // 現在の位置に対して 1 進める
        Sleep(100);
    }
}

　2番目の方法は、StepIt()を使用する方法です。 StepIt()を使用する場合は、あらかじめSetStep()で増分値を設定します。その後StepIt()を呼び出すたびに増分値ずつバーが進みます。

void OnButtonStart(UINT uNotifyCode, int nID, CWindow wndCtl){
    m_progress_sec.SetStep(1);
    for(int i=0; i<10; i++){
        m_progress_sec.StepIt();
        Sleep(100);
    }
}