Outlook式样界面菜单和页面控制

Outlook式样界面菜单和页面控制


编译/

本文将介绍两个可复用的C++类：CXTOutlookBar 和 CXTPagerCtrl，用它们可以实现Outlook风格的用户界面，这两个类出自Codejock软件公司，是其产品Xtreme Toolkit的一部分。根据该公司的许可条款，任何人都可以不受限制地免费使用这两个类的源代码。

介绍

CXTOutlookBar类派生于ListBox，主要实现 Outlook 界面式样控制。CXTPagerCtrl类用于容纳和滚动CXTOutlookBar窗口，这个类包装了与Windows窗口管理有关的（CWnd）API。两个类的使用都很简单，用法与标准的MFC类库一样，没有什么特别要求。

实现

本文附带的例子程序是一个标准的MFC SDI应用程序（如图一所示），


图一 例子程序运行画面

这个程序的主框架是两个切分的视图：左边的视图为 COutbarView，它派生于CView，包含Outlook式样控制机制和窗口管理；右边的视图为应用程序向导生成的视类，你在应用程序向导中可以自己规定这个类从哪个基类派生，例子程序是从CListView派生的。如果想在自己的程序中使用Outlook式样的控制，只要在包含Outlook式样的视类（如本文例子程序的COutbarView）中声明实例即可，例如：

    // 属性
    protected:
    CXTOutlookBar   m_wndOutlookBar;
    CXTPagerCtrl    m_wndPager;      

然后在视类的WM_CREATE/OnCreate消息处理例程中创建窗口控制和Outlook菜单。此时还要添加Outlook菜单项并对它们进行初始化，并设置好按钮的尺寸，创建子窗口：

int COutbarView::OnCreate(LPCREATESTRUCT lpCreateStruct) 
{
    if (CView::OnCreate(lpCreateStruct) == -1)
        return -1;
    
    // 创建页窗口
    if (!m_wndPager.Create(WS_CHILD|WS_VISIBLE|PGS_VERT,
        CRect(0,0,0,0), this, IDC_PAGER_CTRL ))
    {
        TRACE0("Failed to create CPagerCtrl...\n");
        return -1;
    }

    // 以m_wndPager作为父窗口创建 Outlook 式样控制
    if (!m_wndOutlookBar.Create( WS_CHILD | WS_VISIBLE | WS_TABSTOP,
        CRect(0,0,0,0), &m_wndPager, IDC_OUTBAR ))
    {
        TRACE0("Failed to create COutlookBar...\n");
        return -1;
    }

    // 设置接受消息的 CWnd 对象
    m_wndOutlookBar.SetOwner(this);
    m_wndOutlookBar.SetColors(RGB(0xff,0xff,0xff), RGB(0x3a,0x6e,0xa5));

    // 添加 Outlook 控制菜单项
    m_wndOutlookBar.AddMenuItem(IDI_ICON_LOGO,     _T("我的VC知识库") ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_NOTES,    _T("技术论坛")     ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_JOURNAL,  _T("在线杂志")     ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_HLIGHT,   _T("精华区")       ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_SOURCE,   _T("源代码")       ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_COOLLIB,  _T("酷库")         ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_VCKBASE,  _T("VCKBASE Today")),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_PUBLIC,   _T("开发联盟")     ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_CONTACTS, _T("VC知识库")     ),
    m_wndOutlookBar.AddMenuItem(IDI_ICON_DELETED,  _T("垃圾箱")),

    // 在指定的索引处插入菜单项
    m_wndOutlookBar.InsertMenuItem(0, IDI_ICON_INBOX,    _T("收件箱") ),
    m_wndOutlookBar.InsertMenuItem(1, IDI_ICON_OUTBOX,   _T("发件箱") ),
    m_wndOutlookBar.InsertMenuItem(2, IDI_ICON_CALENDAR, _T("日历") ),

    // 设置 COutlookBar 所管理的子窗口以及按钮的尺寸（=15）
    m_wndPager.SetChild(m_wndOutlookBar.GetSafeHwnd());
    m_wndPager.SetButtonSize(15);

    return 0;
}      

接下来我们对窗口的大小进行管理，因此要编写WM_SIZE/OnSize代码，这样将保证视图大小改变后页控制会作相应的位置调整，这一步你可以用类向导来做。

void COutbarView::OnSize(UINT nType, int cx, int cy) 
{
    CView::OnSize(nType, cx, cy);
    
    if(m_wndPager.GetSafeHwnd()) {
        m_wndPager.MoveWindow(0,0,cx,cy);
    }
}      

最后，我们的任务是添加针对页控制的PGN_SCROLL和PGN_CALCSIZE消息处理代码。它告诉我们何时有页滚动并允许设置Outlook菜单窗口的可滚动尺寸。除了PGN_消息处理之外，我们还需要添加XTWM_OUTBAR_NOTIFY消息处理。它将通知我们何时用户点击了Outlook菜单项。为此在COutbarView类的实现文件中（.cpp）添加下面的消息映射：

BEGIN_MESSAGE_MAP(COutbarView, CView)
    //{{AFX_MSG_MAP(COutbarView)
    ...
    //}}AFX_MSG_MAP
    ON_MESSAGE(XTWM_OUTBAR_NOTIFY,  OnOutbarNotify)
    ON_NOTIFY(PGN_SCROLL, IDC_PAGER_CTRL, OnPagerScroll)
    ON_NOTIFY(PGN_CALCSIZE, IDC_PAGER_CTRL, OnPagerCalcSize)
END_MESSAGE_MAP()      

同时在实现文件中添加下面的成员函数：

BOOL COutbarView::OnPagerCalcSize(NMPGCALCSIZE* pNMPGCalcSize, LRESULT* pResult)
{
    switch(pNMPGCalcSize->dwFlag)
    {
    case PGF_CALCWIDTH:
        break;
        
    case PGF_CALCHEIGHT:
        pNMPGCalcSize->iHeight = m_wndOutlookBar.GetCount()
            *(::GetSystemMetrics(SM_CYICON)*2);
        break;
    }
    
    *pResult = 0;
    return TRUE;
}

BOOL COutbarView::OnPagerScroll(NMPGSCROLL* /*pNMPGScroll*/, LRESULT* pResult)
{
    *pResult = 0;
    return TRUE;
}

void COutbarView::OnOutbarNotify(UINT lParam, LONG wParam)
{
    switch( wParam ) // 控制 id.
    {
    case IDC_OUTBAR:
        {
            // 获得菜单项
            XT_CONTENT_ITEM* pContentItems =
                m_wndOutlookBar.GetMenuItem((int)lParam);
            ASSERT(pContentItems);

            AfxMessageBox(pContentItems->m_strText);
        }
        break;
    }
}

在头文件中添加

// 产生消息映射函数
protected:
    //{{AFX_MSG(COutbarView)
    ...
    //}}AFX_MSG
    afx_msg BOOL OnPagerScroll(NMPGSCROLL* pNMPGScroll, LRESULT * pResult);
    afx_msg BOOL OnPagerCalcSize(NMPGCALCSIZE * pNMPGCalcSize, LRESULT* pResult);
    DECLARE_MESSAGE_MAP()      

大功告成，编译运行程序吧......

虽然这个例子只是一个Demo，但你如果有兴趣，可以很容易扩充它的功能，使它更实用一些。
--------------------next---------------------

---------------------
myzhz:IDC_PAGER_CTRL和IDC_OUTBAR是什么，该如何设置
(发表于2004-7-16 11:09:00)

---------------------
nID

The ID of the child window.
转载
"CWnd::Create中的nID是什么?
　


CWnd::Create中的nID是什么?


问:我想通过调用pWnd->Create(NULL, NULL, (WS_CHILD | WS_VISIBLE), >Crect(0,0,0,0), this, nID, pContext)); 
来建立一个窗口,在这个调用中 我所用的nID参数是用来干什么的?文档说是:
子窗口的ID.

答:1)如果你的窗口是一个控件(子窗口),系统将会用这个ID发送给它的父窗口.
2)每个窗口能有许多的子窗口,典型的例子是对话框,里面每个控件都不同的
ID与其它的控 件相互区分开,如果你想加入一个子窗口,你几乎可以使用大部分
的ID,注意工具条,状态条 等也都是子窗口.我通常为每个子视建立一个
IDR_whatever,加在IDR_MAINFRAME后面. 我的建立代码是这样的:

if (mLinesetView == NULL) {
CCreateContext context;
context.m_pNewViewClass = RUNTIME_CLASS (CLinesetView);
context.m_pCurrentDoc = mActiveView->GetDocument ();
context.m_pCurrentFrame = this;
mLinesetView = STATIC_DOWNCAST (CLinesetView, CreateView (&context,
IDR_LINESET_VIEW));
// etc



"
( rabbit_zj 发表于 2005-11-8 15:11:00)
 
IDC_PAGER_CTRL和IDC_OUTBAR是什么，该如何设置 ( myzhz 发表于 2004-7-16 11:09:00)
 

这个下了，感觉却实比上面的好，虽发现有什么bug? ( winloop 发表于 2004-4-16 16:10:00)
 
最好是基于一个窗口的对话框的。谢谢。 ( m6000 发表于 2003-11-4 16:28:00)
 
我也想要个基于对话框的？？ ( m6000 发表于 2003-11-4 15:09:00)
 
很好的文章，正是我想要得，谢谢！ ( hanjiang 发表于 2003-4-8 10:44:00)
 
能用于基于对话框的程序,我想要个能基于对话框的程序，大家告诉我啊 ( huanghaochen 发表于 2003-2-12 14:39:00)
 
请问这个类能用于基于对话框的程序吗？怎样实现？谢谢
( topzhai 发表于 2003-1-22 17:28:00)
 
对了，谁能提供程序选定某个Item，以及显示那个Item被选定的代码，谢谢谢谢！ ( VC70新手 发表于 2003-1-16 3:56:00)
 

这个当然好，不过各有各用。而且里面的bug太多，改得我好痛苦
( VC70新手 发表于 2003-1-16 3:51:00)
 
.......................................................

--------------------next---------------------