分享方式:


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 指定當使用者按下工作時,架構執行之命令的命令標識碼。 如果此值不是有效的命令標識符,工作會被視為簡單的標籤。

備註

下圖顯示包含三個工作的工作群組:

工作組,展開。

注意

如果工作沒有有效的命令標識符,則會將其視為簡單標籤。

繼承階層架構

CObject

CMFCTasksPaneTask

需求

標頭: 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。

另請參閱

階層架構圖表
類別
CObject 類別