次の方法で共有

CMFCTasksPaneTask クラス

  • [アーティクル]

CMFCTasksPaneTask クラスは、作業ウィンドウ コントロール (CMFCTasksPane) のタスクを表すヘルパー クラスです。 タスク オブジェクトは、タスク グループ ( CMFCTasksPaneTaskGroup) 内の項目を表します。 各タスクには、ユーザーがタスク名の左側に表示されるタスクやアイコンをクリックしたときにフレームワークが実行するコマンドを設定できます。

構文

class CMFCTasksPaneTask : public CObject

メンバー

パブリック コンストラクター

名前 説明
CMFCTasksPaneTask::CMFCTasksPaneTask CMFCTasksPaneTask オブジェクトを作成して初期化します。
CMFCTasksPaneTask::~CMFCTasksPaneTask デストラクターです。

パブリック メソッド

名前 説明
CMFCTasksPaneTask::SetACCData 現在のタスクのアクセシビリティ データを決定します。

データ メンバー

名前 説明
CMFCTasksPaneTask::m_bAutoDestroyWindow タスク ウィンドウが自動的に破棄されるかどうかを判断します。
CMFCTasksPaneTask::m_bIsBold フレームワークがタスク ラベルを太字のテキストで描画するかどうかを決定します。
CMFCTasksPaneTask::m_dwUserData フレームワークがタスクに関連付けるユーザー定義データが含まれます。 タスクにデータが関連付けられていない場合は、0 に設定します。
CMFCTasksPaneTask::m_hwndTask タスク ウィンドウへのハンドル。
CMFCTasksPaneTask::m_nIcon フレームワークがタスクの横に表示するイメージのイメージ リスト内のインデックス。
CMFCTasksPaneTask::m_nWindowHeight タスク ウィンドウの高さ。 タスクにタスク ウィンドウがない場合、この値は 0 です。
CMFCTasksPaneTask::m_pGroup このタスクが属する CMFCTasksPaneTaskGroup へのポインター。
CMFCTasksPaneTask::m_rect タスクの外接する四角形を指定します。
CMFCTasksPaneTask::m_strName タスクの名前。
CMFCTasksPaneTask::m_uiCommandID ユーザーがタスクをクリックしたときにフレームワークが実行するコマンドのコマンド ID を指定します。 この値が有効なコマンド ID でない場合、タスクは単純なラベルとして扱われます。

解説

次の図は、3 つのタスクを含むタスク グループを示しています。

展開されたタスク グループ。

Note

タスクに有効なコマンド ID がない場合は、単純なラベルとして扱われます。

継承階層

CObject

CMFCTasksPaneTask

要件

Header: 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
タスクがクリックされたときに実行されるコマンドのコマンド ID を指定します。

dwUserData
ユーザー定義データ。

hwndTask
タスク ウィンドウへのハンドルを指定します。

bAutoDestroyWindow
TRUE の場合、タスク ウィンドウは自動的に破棄されます。

nWindowHeight
タスク ウィンドウの高さを指定します。

解説

CMFCTasksPaneTask::m_bAutoDestroyWindow

タスク ウィンドウが自動的に破棄されるかどうかを判断します。

BOOL m_bAutoDestroyWindow;

解説

タスク ウィンドウ ( CMFCTasksPaneTask::m_hwndTask) を自動的に破棄するように指定するには TRUE に設定します。それ以外の場合は FALSE。

CMFCTasksPaneTask::m_bIsBold

タスク ラベルを太字のテキストで描画するかどうかを指定します。

BOOL m_bIsBold;

解説

タスク ラベルの太字のテキストを表示するには、このメンバーを TRUE に設定します。

CMFCTasksPaneTask::m_dwUserData

タスクに関連付けられているユーザー定義データが含まれています。 タスクに関連付けられているデータがない場合は、0 に設定します。

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

タスク ウィンドウの高さ。 タスクにタスク ウィンドウがない場合、この値は 0 です。

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

ユーザーがタスクをクリックしたときに実行されるコマンドのコマンド ID を指定します。 この値が有効なコマンド ID でない場合、タスクは単純なラベルとして扱われます。

UINT m_uiCommandID;

解説

CMFCTasksPaneTask::SetACCData

現在のタスクのアクセシビリティ データを決定します。

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

パラメーター

pParent
[in]現在のタスクの親ウィンドウを表します。

data
[out]現在のタスクのアクセシビリティ データが設定 CAccessibilityData 型のオブジェクト。

戻り値

data パラメーターに現在のタスクのアクセシビリティ データが正常に設定された場合は TRUE。それ以外の場合は FALSE。

関連項目

階層図
クラス
CObject クラス