ホーム WTL Mobile
InkX
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/11/07
PR
 InkXコントロールは、RichInkコントロールに音声の録音と再生機能を追加したコントロールです。

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

// atlwince.h
typedef CInkXCtrlT<ATL::CWindow> CInkXCtrl;
			

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

 以下に示すのは、CInkXCtrlクラスを使用する例です。 コンボボックスコントロールのアイテムを選択することで、 InkXコントロールのペンモードを切り替えます。また、InkXコントロールの上部に音声バーを表示します。


プロジェクトファイル ダウンロード
// stdafx.h
#pragma once

#define WINVER 0x0420
#include <atlbase.h>
#if _ATL_VER == 0x900
#define _SECURE_ATL 1
#endif

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

#include <tpcshell.h>
#include <aygshell.h>
#pragma comment(lib, "aygshell.lib")

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlframe.h>
#include <atlctrls.h>
#define _WTL_CE_NO_ZOOMSCROLL
#define _WTL_CE_NO_FULLSCREEN
#include <atlwince.h>
			

// SampleProjectDialog.h
#pragma once

class CSampleProjectDialog : 
    public CAppStdDialogImpl<CSampleProjectDialog>,
    public CUpdateUI<CSampleProjectDialog>,
    public CMessageFilter, public CIdleHandler
{
public:
    DECLARE_APP_DLG_CLASS(NULL, IDR_MAINFRAME, L"Software\\WTL")

    enum { IDD = IDD_MAINDLG };

    enum { IDC_INKX = 1200 };
    CInkXCtrl m_inkx;
    CComboBox m_combo_mode;

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        return CWindow::IsDialogMessage(pMsg);
    }

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_UPDATE_UI_MAP(CSampleProjectDialog)
    END_UPDATE_UI_MAP()

    BEGIN_MSG_MAP(CSampleProjectDialog)
        MSG_WM_INITDIALOG(OnInitDialog)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_HANDLER_EX(IDC_COMBO_MODE, CBN_SELCHANGE, OnComboSelChange)
        CHAIN_MSG_MAP(CUpdateUI<CSampleProjectDialog>)
        CHAIN_MSG_MAP(CAppStdDialogImpl<CSampleProjectDialog>)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        AtlCreateEmptyMenuBar(m_hWnd);

        // コントロール設定
        m_combo_mode = GetDlgItem(IDC_COMBO_MODE);

        // ペンモードをコンボボックスアイテムとして設定
        m_combo_mode.AddString(_T("MODE_PEN"));
        m_combo_mode.SetItemData(0, MODE_PEN);
        m_combo_mode.AddString(_T("MODE_SELECT"));
        m_combo_mode.SetItemData(1, MODE_SELECT);
        m_combo_mode.AddString(_T("MODE_SPACE"));
        m_combo_mode.SetItemData(2, MODE_SPACE);
        m_combo_mode.SetCurSel(0);

        // InkXコントロールのサイズを作成
        CRect rcWindow;
        GetWindowRect(rcWindow);
        CRect rcCombo;
        m_combo_mode.GetWindowRect(rcCombo);
        CRect rcInkX;
        rcInkX.top = 10;
        rcInkX.bottom = 
            rcCombo.top - rcWindow.top - ::GetSystemMetrics(SM_CYCAPTION) - 10;
        rcInkX.left = 
            rcCombo.left - rcWindow.left - ::GetSystemMetrics(SM_CXBORDER);
        rcInkX.right = 
            rcCombo.right - rcWindow.left - ::GetSystemMetrics(SM_CXBORDER);

        // InkXコントロールを作成
        m_inkx.Create(m_hWnd, rcInkX, NULL, 
            WS_CHILD | WS_VISIBLE | WS_BORDER, 0, IDC_INKX);
        m_inkx.ShowVoiceBar(TRUE);
        m_inkx.GetRichInk().SetPenMode(MODE_PEN);
        m_inkx.GetRichInk().SetViewStyle(VT_WRITINGVIEW);

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->AddMessageFilter(this);
        pLoop->AddIdleHandler(this);

        SetMsgHandled(false);

        return TRUE;
    }

    void OnDestroy(){
        // メッセージループからメッセージフィルタとアイドルハンドラを削除
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->RemoveMessageFilter(this);
        pLoop->RemoveIdleHandler(this);
    }

    void OnComboSelChange(UINT uNotifyCode, int nID, CWindow wndCtl){
        int nIndex = m_combo_mode.GetCurSel();
        if(nIndex != CB_ERR){
            UINT mode = m_combo_mode.GetItemData(nIndex);
            m_inkx.GetRichInk().SetPenMode(mode);
        }
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resourceppc.h"
#include "SampleProjectDialog.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance,
    HINSTANCE /*hPrevInstance*/, LPTSTR lpstrCmdLine, int nCmdShow)
{
    HRESULT hRes =
        CSampleProjectDialog::ActivatePreviousInstance(hInstance, lpstrCmdLine);

    if(FAILED(hRes) || S_FALSE == hRes){
        return hRes;
    }

    InitInkX();

    hRes = ::CoInitializeEx(NULL, COINIT_MULTITHREADED);
    ATLASSERT(SUCCEEDED(hRes));

    AtlInitCommonControls(ICC_DATE_CLASSES);
    SHInitExtraControls();

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

    int nRet = CSampleProjectDialog::AppRun(lpstrCmdLine, nCmdShow);

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

    return nRet;
}
			

 まず、リソースを作成します。ダイアログにコンボボックスコントロールを配置し、 [ID]を次のように設定します。 なお、コンボボックスコントロールの[プロパティ]では[Type]を[ドロップダウン リスト]に設定します。

コントロール名 ID
コンボボックス IDC_COMBO_MODE

 CSampleProjectDialogクラスでは、InkXコントロール用にID(IDC_INKX)を定義し、 CInkXCtrlクラスのインスタンスをメンバ変数として宣言します。 また、コンボボックスコントロール用にCComboBoxクラスのインスタンスもメンバ変数として宣言します。

 次に、WM_INITDIALOGメッセージハンドラでは、 InkXコントロールの3種類のペンモードをコンボボックスコントロールのアイテムとして設定し、 InkXコントロールのサイズを計算してInkXコントロールを作成します。 InkXコントロールを作成するためにはCreate()を使用しますが、 引数の種類はCWindowImpl::Create()と同じです。 InkXコントロールを作成した後はShowVoiceBar()を呼び出して音声バーを表示し、 SetPenMode()SetViewStyle()を呼び出して初期状態のペンモードとビュースタイルを設定します。

 次に、通知コードがCBN_SELCHANGEのコンボボックスコントロール用WM_COMMANDメッセージハンドラとしてOnComboSelChange()を追加します。 このハンドラ関数ではアイテムに関連付けられたペンモード値を取得し、 SetPenMode()を呼び出してInkXコントロールにペンモードを設定します。

 最後に_tWinMain()で、InitInkX()を呼び出します。