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

必要条件

ヘッダー: 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 に設定します。それ以外の場合は FAL Standard Edition。

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 によって 設定されます。

画像なしでタスクを表示する場合は、-1 に設定 m_nIcon します。

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 のオブジェクト。

戻り値

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

関連項目

階層図
クラス
CObject クラス