窗格容器
WTL还有一个被称为窗格容器的构件,它就像Explorer中左边的窗格那样,顶部有一个可以显示文字的区域,还有一个可选择是否显示的Close按钮:
就像分隔窗口管理两个窗格窗口一样,这个窗格容器也管理一个子窗口,当容器窗口的大小改变时,子窗口也相应的改变大小以便能够填充容器窗口的内部空间。
相关的类
这个窗格容器的实现需要两个类:CPaneContainerImpl和CPaneContainer,它们都在atlctrlx.h中声明。CPaneContainerImpl是一个CWindowImpl派生类,它含有窗格容器的完整实现,CPaneContainer只是提供了一个类名,除非重载CPaneContainerImpl的方法或改变容器的外观,一般使用CPaneContainer就够了。
基本方法
HWND Create( HWND hWndParent, LPCTSTR lpstrTitle = NULL, DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN, DWORD dwExStyle = 0, UINT nID = 0, LPVOID lpCreateParam = NULL) HWND Create( HWND hWndParent, UINT uTitleID, DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN, DWORD dwExStyle = 0, UINT nID = 0, LPVOID lpCreateParam = NULL) |
创建一个CPaneContainer窗口和创建其它子窗口一样。有两个Create()函数,它们的区别仅仅是第二个参数不同。第一个函数需要传递一个字符串作为容器顶部区域显示的文字,第二个参数需要需要传一个字符串的资源ID,其他参数只要使用默认值就行了。
DWORD SetPaneContainerExtendedStyle(DWORD dwExtendedStyle, DWORD dwMask = 0) DWORD GetPaneContainerExtendedStyle() |
CPaneContainer还有一些扩展样式用来控制容器窗口上Close按钮的布局方式:
·PANECNT_NOCLOSEBUTTON:使用样式去掉顶部的Close按钮。
·PANECNT_VERTICAL:设置这个样式后,顶部的文字区域将沿着容器窗口的左边界垂直放置。
扩展样式的默认值是0,表示容器窗口是水平放置的,还有一个Close按钮。
HWND SetClient(HWND hWndClient) HWND GetClient() |
调用SetClient()可以将一个子窗口指派给窗格容器,这和调用CSplitterWindow类的SetSplitterPane()方法作用类似。SetClient()同时返回原来的客户区窗口句柄而调用GetClient()则可以得到当前的客户区窗口句柄。
BOOL SetTitle(LPCTSTR lpstrTitle) BOOL GetTitle(LPTSTR lpstrTitle, int cchLength) int GetTitleLength() |
调用SetTitle()可以改变容器窗口顶部显示的文字,调用GetTitle()可以得到当前窗口顶部区域显示的文字,调用GetTitleLength()可以得到当前显示的文字的字符个数(不包括结尾的空字符)。
| BOOL EnableCloseButton(BOOL bEnable) |
如果窗格容器使用的Close按钮,你可以调用EnableCloseButton()来控制这个按钮的状态。
在分隔窗口中使用窗格容器
为了说明窗格容器的使用方法,我们将向ClipSpy的分隔窗口的左窗格添加一个窗格容器,我们将一个窗格容器指派给左窗格取代原来使用的list控件,而将list控件指派给窗格容器。下面是在CMainFrame::OnCreate()中为支持窗格容器而添加的代码。
LRESULT CMainFrame::OnCreate ( LPCREATESTRUCT lpcs ) { //... m_wndVertSplit.Create ( *this, rcDefault, NULL, dwSplitStyle, dwSplitExStyle );
// Create the pane container. m_wndPaneContainer.Create ( m_wndVertSplit, IDS_LIST_HEADER );
// Create the left pane (list of clip formats) m_wndFormatList.Create ( m_wndPaneContainer, rcDefault ); //... // Set up the splitter panes m_wndPaneContainer.SetClient ( m_wndFormatList ); m_wndVertSplit.SetSplitterPanes ( m_wndPaneContainer, m_wndDataViewer ); |
注意,现在list控件的父窗口是m_wndPaneContainer,同时m_wndPaneContainer被设定成分隔窗口的左窗格。
下面是修改后的左窗格的外观,由于窗格容器在顶部的文本区域自己画了一个三维边框,所以我还要稍微修改一下边框的样式。这样看起来不是很好看,你可以自己调整样式知道你满意为止。(当然,你需要在Windows XP 上测试一下哪个界面主题可以使得分隔窗口看起来“更有意思”。)
|