ホーム ATL/WTL
プログレスバー
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2004/02/07
PR
 WTLではコモンコントロールのプログレスバーコントロールをCProgressBarCtrlT というテンプレートクラスでカプセル化しています。 テンプレート引数にはクラスを指定しますが、 そのクラスはCProgressBarCtrlTクラスの基底クラスとして使用されます。 atlctrls.hヘッダではtypedefによって次のように宣言されています。

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

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

 WTLのCProgressBarCtrlクラスは、MFCのCProgressCtrlクラスとほぼ同じメンバ関数を用意しています。 以下に示すのは、CProgressBarCtrlクラスを使用する例です。 100ミリ秒毎にバーを進めます。最後まで進むのに約1秒かかります。


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

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

// maindlg.h内
class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    CProgressBarCtrl m_progress_sec;

    // メッセージマップ
    BEGIN_MSG_MAP_EX(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()

    LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){
        // スクリーンの中央に配置
        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, HWND hWndCtl){
        for(int i=0; i<=10; i++){
            m_progress_sec.SetPos(i);
            Sleep(100);
        }
    }

    void OnOK(UINT uNotifyCode, int nID, HWND hWndCtl){
        EndDialog(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, HWND hWndCtl){
        EndDialog(nID);
    }
};
			

// Control.cpp内
#include "stdafx.h"

#include "resource.h"

#include "maindlg.h"

CAppModule _Module;

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

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

    AtlInitCommonControls(ICC_COOL_CLASSES | ICC_WIN95_CLASSES);

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

    int nRet = 0;
    // BLOCK: アプリケーション実行
    {
        CMainDlg dlgMain;
        nRet = dlgMain.DoModal();
    }

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

    return nRet;
}
			

 まず、リソースを作成します。ダイアログにプログレスバーコントロールを配置し、 リソースIDを次のように指定します。 なお、プログレスバーコントロールの[スタイル]ではデフォルトに加え[スムーズ]にチェックを入れます。

コントロール名 リソースID
プログレスバー IDC_PROGRESS_SEC

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

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

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

 次に、ボタンコントロール用コマンドメッセージハンドラを追加します。 そのハンドラではSetPos()によってバーを1/10ずつ進めます。 なお、Sleep()によって100ミリ秒毎に進めるため、 最後まで進むのに約1秒かかります。

 上の例ではバーを進めるためにSetPos()を使用しましたが、 プログレスバーコントロールは、バーを進めるために別の2つの方法を用意しています。

 一つ目の方法は、OffsetPos()を使用する方法です。 OffsetPos()はバーの位置を現在の位置に対して相対的な位置に設定します。

for(int i=0; i<10; i++){
    m_progress_sec.OffsetPos(1);  // 現在の位置に対して 1 進める
    Sleep(100);
}
			

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

m_progress_sec.SetStep(1);

for(int i=0; i<10; i++){
    m_progress_sec.StepIt();
    Sleep(100);
}