牵着老婆满街逛

严以律己,宽以待人. 三思而后行.
GMail/GTalk: yanglinbo#google.com;
MSN/Email: tx7do#yahoo.com.cn;
QQ: 3 0 3 3 9 6 9 2 0 .

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,但你如果有兴趣,可以很容易扩充它的功能,使它更实用一些。

posted on 2006-06-22 20:09 杨粼波 阅读(433) 评论(0)  编辑 收藏 引用 所属分类: 文章收藏


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理