Класс CMFCTasksPaneTask
Класс 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 | Указывает идентификатор команды, выполняемой платформой, когда пользователь щелкает задачу. Если это значение не является допустимым идентификатором команды, задача рассматривается как простая метка. |
Замечания
На следующем рисунке показана группа задач, содержащая три задачи:
Примечание.
Если у задачи нет допустимого идентификатора команды, она рассматривается как простая метка.
Иерархия наследования
Требования
Заголовок: 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.