Класс CMFCTasksPaneTask

Примечание.

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Класс CMFCTasksPaneTask является вспомогательным классом, который представляет задачи для элемента управления областью задач ( CMFCTasksPane). Объект задачи представляет элемент в группе задач ( CMFCTasksPaneTaskGroup). Каждая задача может иметь команду, которую платформа выполняет, когда пользователь щелкает задачу, и значок, который присутствует слева от имени задачи.

Синтаксис

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
Задает дескриптор в окне задачи.

bAutoDeskWindow
Если значение 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