CMFCTasksPaneTask 類別

發行項
10/12/2023

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

備註

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

Task group, expanded.

注意

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

繼承階層架構

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 類別

共用方式為