Класс CMFCTasksPane

Статья
06/10/2015

Этот раздел включен для обеспечения полноты. Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc каталога установки Visual Studio.

Класс CMFCTasksPane реализует список активную элементов (задач).

class CMFCTasksPane : public CDockablePane

Члены

Открытые конструкторы

Имя	Описание
CMFCTasksPane::CMFCTasksPane	Создает объект CMFCTasksPane.

Открытые методы

Имя	Описание
CMFCTasksPane::AddGroup	Добавляет новую группу в составе задачи в элемент управления области задач.
CMFCTasksPane::AddLabel	Добавляет новую статической метки в указанную группу целевого назначения.
CMFCTasksPane::AddMRUFilesList	Добавляет задачи, указанные последний использовавший ся списком файлов (MRU) в группу.
CMFCTasksPane::AddPage	Добавляет новую страницу в области задач.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Добавляет новую задачу к указанной группе целевого назначения.
CMFCTasksPane::AddWindow	Добавляет дочернее окно на панели задач.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Программно свернуть группы.
CMFCTasksPane::CreateDefaultMiniframe	(Переопределяет CPane::CreateDefaultMiniframe).
CMFCTasksPane::CreateMenu	Вызываемый платформой для создания меню для кнопки меню другие панели задач.
CMFCTasksPane::EnableAnimation	Включение или отключение анимации, пока свернущ или развернущ группы целевого назначения.
CMFCTasksPane::EnableGroupCollapse	Определяет, могут ли целевые группы можно свернуть.
CMFCTasksPane::EnableHistoryMenuButtons	Включение или отключение раскрывающееся меню, в Далее и кнопках навигации Назад.
CMFCTasksPane::EnableNavigationToolbar	Включение или отключение панели инструментов навигации.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Включает вместо кнопки прокрутки полосы прокрутки.
CMFCTasksPane::EnableWrapLabels	Включение или отключение слово создавая программу-оболочку для меток.
CMFCTasksPane::EnableWrapTasks	Включение или отключение слово создавая программу-оболочку для задач.
CMFCTasksPane::GetActivePage	Возвращает нулевой- основан индекс текущей страницы.
CMFCTasksPane::GetGroupCaptionHeight	Возвращает высоту заголовка группы.
CMFCTasksPane::GetGroupCaptionHorzOffset	Возвращает текущее смещение заголовка группы из слева и правого краев области задач.
CMFCTasksPane::GetGroupCaptionVertOffset	Возвращает текущее смещение заголовка группы из верхней и нижней границ области задач.
CMFCTasksPane::GetGroupCount	Возвращает общее количество групп.
CMFCTasksPane::GetGroupLocation	Возвращает внутренний индекс группы для данной группы.
CMFCTasksPane::GetGroupVertOffset	Возвращает вертикальное смещение группы.
CMFCTasksPane::GetHorzMargin	Возвращает горизонтальное интервалы между областью задач и краями клиентской области.
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	Извлекает индекс страницы для указанной группы.
CMFCTasksPane::GetPagesCount	Возвращает число страниц.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Переопределяет CWnd::GetScrollBarCtrl).
CMFCTasksPane::GetTask	Извлекает задачи.
CMFCTasksPane::GetTaskCount	Возвращает количество элементов задачи в указанной группе.
CMFCTasksPane::GetTaskGroup	Возвращает группу целевого назначения для заданного индекса группы.
CMFCTasksPane::GetTaskLocation	Возвращает группу и индекс для данной задачи.
CMFCTasksPane::GetTasksHorzOffset	Возвращает горизонтальное смещение задач из слева и правого краев родительских групп.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Возвращает вертикальное интервалы между областью задач и краями клиентской области.
CMFCTasksPane::IsAccessibilityCompatible	(Переопределяет CDockablePane::IsAccessibilityCompatible).
CMFCTasksPane::IsAnimationEnabled	Указывает, включена ли анимация.
CMFCTasksPane::IsBackButtonEnabled	Указывает, включена ли кнопка назад.
CMFCTasksPane::IsForwardButtonEnabled	Указывает, включена ли кнопка передняя.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Указывает, имеют ли кнопки перехода Далее и Назад раскрывающееся меню.
CMFCTasksPane::IsNavigationToolbarEnabled	Указывает, включена ли панель инструментов навигации.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Указывает программу-оболочку создает ли область задач слова в метках.
CMFCTasksPane::IsWrapTasksEnabled	Указывает программу-оболочку создает ли область задач слова в задачах.
CMFCTasksPane::LoadState	(Переопределяет CDockablePane::LoadState).
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Вызываемый платформой, когда пользователь щелкает элемент в области задач.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Вызываемый платформой, когда пользователь нажимает кнопку назад.
CMFCTasksPane::OnPressForwardButton	Вызываемый платформой, когда пользователь нажимает кнопку передняя навигации.
CMFCTasksPane::OnPressHomeButton	Вызываемый платформой, когда пользователь щелкает корневой кнопка навигации
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Переопределяет CBasePane::OnSetAccData).
CMFCTasksPane::OnUpdateCmdUI	(Переопределяет CDockablePane::OnUpdateCmdUI).
CMFCTasksPane::PreTranslateMessage	(Переопределяет CDockablePane::PreTranslateMessage).
CMFCTasksPane::RecalcLayout	(Переопределяет CPane::RecalcLayout).
CMFCTasksPane::RemoveAllGroups	Удаляет все группы на определенной странице.
CMFCTasksPane::RemoveAllPages	Удаляет все страницы из области задач, за исключением того, что первая страница (по умолчанию).
CMFCTasksPane::RemoveAllTasks	Удаляет все задачи из группы.
CMFCTasksPane::RemoveGroup	Удаляет группу.
CMFCTasksPane::RemovePage	Удаляет указанную страницу из области задач.
CMFCTasksPane::RemoveTask	Удаляет задачи из группы целевых назначения.
CMFCTasksPane::SaveState	(Переопределяет CDockablePane::SaveState).
CMFCTasksPane::Serialize	(Переопределяет CDockablePane::Serialize).
CMFCTasksPane::SetActivePage	Активировать указанная страница в области задач.
CMFCTasksPane::SetCaption	Задает имя заголовка области задач.
CMFCTasksPane::SetGroupCaptionHeight	Задает высоту заголовка группы.
CMFCTasksPane::SetGroupCaptionHorzOffset	Задает горизонтальное смещение заголовка группы.
CMFCTasksPane::SetGroupCaptionVertOffset	Задает вертикальное смещение заголовка группы.
CMFCTasksPane::SetGroupName	Задает имя группы.
CMFCTasksPane::SetGroupTextColor	Задает цвет текста заголовка группы.
CMFCTasksPane::SetGroupVertOffset	Задает вертикальное смещение для группы.
CMFCTasksPane::SetHorzMargin	Задает горизонтальное интервалы между областью задач и краями клиентской области.
CMFCTasksPane::SetIconsList	Задает список образа, связанный с задачами.
CMFCTasksPane::SetPageCaption	Задает текст заголовка для страницы области задач.
CMFCTasksPane::SetTaskName	Задает имя задачи.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Задает цвет текста для задачи.
CMFCTasksPane::SetTasksHorzOffset	Задает горизонтальное смещение задач из слева и правого краев родительских групп.
CMFCTasksPane::SetVertMargin	Задает вертикальный промежуток между областью задач и краями клиентской области.
CMFCTasksPane::SetWindowHeight	Задает высоту окна.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	Показать или скрывает задачи.
CMFCTasksPane::ShowTaskByCmdId	Показать или скрывает задачи, основанной на своем идентификатора команды
CMFCTasksPane::Update	Обновляет элементы графического интерфейса пользователя, которые принадлежат области задач.

Защищенные методы

Имя	Описание
CMFCTasksPane::OnActivateTasksPanePage	Вызываемый платформой, когда новая страница будет активируется области задач.

Заметки

Класс CMFCTasksPane реализует следующую функциональность.

Элементы можно группировать и каждое группирование элементов может иметь соответствующий заголовок.
Группирования элемента может быть свернут или развернут.
Значок может быть присвоено каждому элементу в области задач.
Отдельные элементы можно связать с идентификатором команды, которое выполняется, когда пользователь щелкает элемент. При возникновении сообщение отправлено нажмите кнопку WM_COMMAND владелец управления области задач.

Для использования элемента управления CMFCTasksPane в приложении, выполните следующие действия:

Внедрение объект CMFCTasksPane в главный класс фреймового окна.
При обработке сообщения WM_CREATE, вызовите метод Create. Можно использовать обычные стили CControlBar. Дополнительные сведения см. в разделе CControlBar::Create.
Вызовите метод CMFCTasksPane::AddGroup чтобы добавить различные группы.
Вызвать функции-члены CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel или CMFCTasksPane::AddMRUFilesList для добавления новых элементов (задач) к каждой группе.
Вызовите CMFCTasksPane::EnableGroupCollapse, чтобы определить, является ли номенклатурные может свернуть группы.

На следующем рисунке показано типичное элемент управления области задач. Первая группа - это особая группа и заголовок более темный цвет. Третья группа свернута. Последняя группа выравнена к нижнему краю области задач и не имеет заголовка и последняя задача в группе простая метка.

Пример панели задач

Можно настраивать внешний вид области задач при обработке различные поля и смещения. На следующем рисунке завершает значение этих переменных:

Пользовательская группа задач

Пример

В следующем примере показано, как создать объект CMFCTasksPane и использовать различные методы в CMFCTasksPane классифицируйте. Примере показано, как включить свернуть группы целевого назначения содержит раскрывающееся меню переходов на кнопках Далее и Назад включает кнопки прокрутки полосы прокрутки, а не включает слово создавая программу-оболочку для текста в метках присвойте имя заголовка области задач, установите цвет текста для заголовка группы и присвойте горизонтальные и вертикальные поля.

  CMFCTasksPane* tPane = new CMFCTasksPane();
    tPane->EnableGroupCollapse(true);
    tPane->EnableHistoryMenuButtons(true);
    tPane->EnableScrollButtons(true);
    tPane->EnableWrapLabels(true);
    tPane->SetCaption(_T("Task Pane"));
    tPane->SetGroupTextColor(0,RGB(0,0,128));
    tPane->SetHorzMargin(15);
    tPane->SetVertMargin(15);
    tPane->Update();