CMFCTasksPaneTask 類別
類別 CMFCTasksPaneTask
是協助程序類別,代表工作窗格控件的工作( CMFCTasksPane)。 工作物件代表工作組中的專案( CMFCTasksPaneTaskGroup)。 每個工作可以有命令,當使用者按一下工作與工作名稱左邊的圖示時,Framework 就會執行這個命令。
語法
class CMFCTasksPaneTask : public CObject
成員
公用建構函式
名稱 | 描述 |
---|---|
CMFCTasksPaneTask::CMFCTasksPaneTask | 建立並初始化 CMFCTasksPaneTask 物件。 |
CMFCTasksPaneTask::~CMFCTasksPaneTask |
解構函式。 |
公用方法
名稱 | 描述 |
---|---|
CMFCTasksPaneTask::SetACCData | 決定目前工作的輔助功能數據。 |
資料成員
名稱 | 描述 |
---|---|
CMFCTasksPaneTask::m_bAutoDestroyWindow | 判斷工作視窗是否自動終結。 |
CMFCTasksPaneTask::m_bIsBold | 判斷架構是否以粗體文字繪製工作標籤。 |
CMFCTasksPaneTask::m_dwUserData | 包含架構與工作相關聯的使用者定義數據。 如果工作沒有相關聯的數據,則設定為零。 |
CMFCTasksPaneTask::m_hwndTask | 工作視窗的句柄。 |
CMFCTasksPaneTask::m_nIcon | 架構在工作旁邊顯示之影像影像清單中的索引。 |
CMFCTasksPaneTask::m_nWindowHeight | 工作視窗的高度。 如果工作沒有工作窗口,這個值會是零。 |
CMFCTasksPaneTask::m_pGroup | 此工作所屬之的 CMFCTasksPaneTaskGroup 指標。 |
CMFCTasksPaneTask::m_rect | 指定工作的周框。 |
CMFCTasksPaneTask::m_strName | 工作的名稱。 |
CMFCTasksPaneTask::m_uiCommandID | 指定當使用者按下工作時,架構執行之命令的命令標識碼。 如果此值不是有效的命令標識符,工作會被視為簡單的標籤。 |
備註
下圖顯示包含三個工作的工作群組:
注意
如果工作沒有有效的命令標識符,則會將其視為簡單標籤。
繼承階層架構
需求
標頭: afxTasksPane.h
CMFCTasksPaneTask::CMFCTasksPaneTask
建立並初始化 CMFCTasksPaneTask
物件。
CMFCTasksPaneTask(
CMFCTasksPaneTaskGroup* pGroup,
LPCTSTR lpszName,
int nIcon,
UINT uiCommandID,
DWORD dwUserData = 0,
HWND hwndTask = NULL,
BOOL bAutoDestroyWindow = FALSE,
int nWindowHeight = 0);
參數
pGroup
指定工作所屬的 CMFCTasksPaneTaskGroup 。
lpszName
指定工作的名稱。
nIcon
指定影像清單中的工作影像索引。
uiCommandID
指定按下工作時所執行的命令命令標識碼。
dwUserData
使用者定義的數據。
hwndTask
指定工作視窗的句柄。
bAutoDestroyWindow
如果為TRUE,工作視窗將會自動終結。
nWindowHeight
指定工作視窗的高度。
備註
CMFCTasksPaneTask::m_bAutoDestroyWindow
判斷工作視窗是否自動終結。
BOOL m_bAutoDestroyWindow;
備註
設定為 TRUE 以指定工作視窗 ( CMFCTasksPaneTask::m_hwndTask) 應該自動終結;否則為 FALSE。
CMFCTasksPaneTask::m_bIsBold
判斷工作標籤是否以粗體文字繪製。
BOOL m_bIsBold;
備註
將此成員設定為TRUE,以顯示工作標籤的粗體文字。
CMFCTasksPaneTask::m_dwUserData
包含與工作相關聯的使用者定義數據。 如果沒有與工作相關聯的數據,則設定為零。
DWORD m_dwUserData;
備註
CMFCTasksPaneTask::m_hwndTask
工作視窗的句柄。
HWND m_hwndTask;
備註
若要新增工作視窗,請呼叫 CMFCTasksPane::AddWindow。
CMFCTasksPaneTask::m_nIcon
影像清單中的索引位置,可識別指定工作旁邊顯示的影像。
int m_nIcon;
備註
映射清單是由 CMFCTasksPane::SetIconsList 所設定。
如果您想要顯示沒有影像的工作,請將 設定 m_nIcon
為 -1。
CMFCTasksPaneTask::m_nWindowHeight
工作視窗的高度。 如果工作沒有工作窗口,這個值會是零。
int m_nWindowHeight;
備註
CMFCTasksPaneTask::m_pGroup
此工作所屬 CMFCTasksPaneTaskGroup 的指標。
CMFCTasksPaneTaskGroup* m_pGroup;
備註
每個工作都必須有父群組。 您可以呼叫 CMFCTasksPane::AddGroup,將群組新增至工作窗格。
CMFCTasksPaneTask::m_rect
指定工作的周框。
CRect m_rect;
備註
當繪製工作時,架構會計算此值。
CMFCTasksPaneTask::m_strName
工作的名稱。
CString m_strName;
備註
CMFCTasksPaneTask::m_uiCommandID
指定使用者按下工作時所執行的命令命令標識碼。 如果此值不是有效的命令標識符,工作會被視為簡單的標籤。
UINT m_uiCommandID;
備註
CMFCTasksPaneTask::SetACCData
決定目前工作的輔助功能數據。
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
參數
pParent
[in]表示目前工作的父視窗。
data
[out]型 CAccessibilityData
別的物件,會填入目前工作的輔助功能數據。
傳回值
如果 數據 參數已成功填入目前工作的輔助功能數據,則為TRUE,否則為 FALSE。