在 MFC(Microsoft Foundation Classes)中,CMFCTasksPane::AddWindow 是一个公共方法,用于向任务窗格中添加一个窗口任务项。

方法的原型如下:
CMFCTasksPaneTask* CMFCTasksPane::AddWindow(CWnd* pWnd, LPCTSTR lpszTaskName, int nCommandID = 0, DWORD_PTR dwUserData = 0, HICON hIcon = NULL, BOOL bAutoDestroyIcon = FALSE);

该方法接受多个参数:

  •  pWnd:一个指向窗口的指针,表示要关联的窗口。

  •  lpszTaskName:一个字符串参数,表示任务项的文本。

  •  nCommandID:一个整数参数,表示与任务项关联的命令 ID。

  •  dwUserData:一个 DWORD_PTR 参数,表示用户自定义数据。

  •  hIcon:一个 HICON 参数,表示与任务项关联的图标。

  •  bAutoDestroyIcon:一个布尔值,表示是否自动销毁关联的图标。


该方法会创建一个窗口任务项并将其添加到任务窗格中。返回值是一个指向新创建的 CMFCTasksPaneTask 对象的指针。

示例用法:
CMFCTasksPane tasksPane;

// 添加一个窗口任务项到任务窗格
CMFCTasksPaneTask* pWindowTask = tasksPane.AddWindow(pMyWnd, _T("My Window"), ID_MY_WINDOW, 5678, AfxGetApp()->LoadIcon(IDI_MY_WINDOW));

这样就在任务窗格中添加了一个名为 "My Window" 的窗口任务项,关联的命令 ID 是 ID_MY_WINDOW,用户自定义数据是 5678,并且使用了一个加载自资源的图标。


转载请注明出处:http://www.pingtaimeng.com/article/detail/20171/MFC/CMFCTasksPane