CMFCTasksPane-Klasse

Artikel
03/12/2013

Dieses Thema ist aus Gründen der Vollständigkeit enthalten. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Die CMFCTasksPane-Klasse implementiert eine Liste von Elementen (klickbaren Aufgaben).

class CMFCTasksPane : public CDockablePane

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCTasksPane::CMFCTasksPane	Erstellt ein CMFCTasksPane-Objekt.

Öffentliche Methoden

Name	Description
CMFCTasksPane::AddGroup	Fügt eine neue Gruppe Aufgaben dem Aufgabenbereichssteuerelement hinzu.
CMFCTasksPane::AddLabel	Fügt eine neue statische Bezeichnung in die angegebene Aufgabengruppe hinzu.
CMFCTasksPane::AddMRUFilesList	Fügt die Aufgaben hinzu, die von einer zuletzt verwendeten angegeben werden, Dateiliste (MRU) in eine Gruppe.
CMFCTasksPane::AddPage	Fügt eine neue Seite dem Aufgabenbereich hinzu.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Fügt eine neue Aufgabe der angegebenen Aufgabengruppe hinzu.
CMFCTasksPane::AddWindow	Fügt ein untergeordnetes Fenster dem Aufgabenbereich hinzu.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Bricht programmgesteuert eine Gruppe zusammengefasst.
CMFCTasksPane::CreateDefaultMiniframe	(Überschreibungen CPane::CreateDefaultMiniframe.)
CMFCTasksPane::CreateMenu	Aufgerufen vom Framework, um ein Menü für die Menüschaltfläche Andere Aufgabenbereiche zu erstellen.
CMFCTasksPane::EnableAnimation	Aktiviert oder deaktiviert Animation beim Erweitern oder Reduzieren von Aufgabengruppen.
CMFCTasksPane::EnableGroupCollapse	Gibt an, ob Arbeitsgruppen reduziert werden können.
CMFCTasksPane::EnableHistoryMenuButtons	Aktiviert oder deaktiviert Dropdownmenüs in Weiter und in Zurück Navigationsschaltflächen.
CMFCTasksPane::EnableNavigationToolbar	Aktiviert oder deaktiviert die Navigationssymbolleiste.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Aktiviert Bildlaufschaltflächen anstelle einer Bildlaufleiste.
CMFCTasksPane::EnableWrapLabels	Aktiviert oder deaktiviert Wortumbruch für Bezeichnungen.
CMFCTasksPane::EnableWrapTasks	Aktiviert oder deaktiviert Wortumbruch für Aufgaben.
CMFCTasksPane::GetActivePage	Gibt den nullbasierten Index für die aktuelle Seite zurück.
CMFCTasksPane::GetGroupCaptionHeight	Gibt die Höhe der Gruppenbeschriftungen zurück.
CMFCTasksPane::GetGroupCaptionHorzOffset	Gibt den aktuellen Offset einer Gruppenbeschriftung von der linken und rechten Rand des Aufgabenbereichs zurück.
CMFCTasksPane::GetGroupCaptionVertOffset	Gibt den aktuellen Offset einer Gruppenbeschriftung vom oberen und von den unteren Rand des Aufgabenbereichs zurück.
CMFCTasksPane::GetGroupCount	Gibt die Gesamtzahl von Gruppen zurück.
CMFCTasksPane::GetGroupLocation	Gibt den internen Gruppenindex für eine angegebene Gruppe zurück.
CMFCTasksPane::GetGroupVertOffset	Gibt den vertikalen Offset einer Gruppe zurück.
CMFCTasksPane::GetHorzMargin	Gibt die horizontale Entfernung zwischen einem Aufgabenbereich und den Rändern des Clientbereichs zurück.
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	Ruft den Seitenindex für eine angegebene Gruppe ab.
CMFCTasksPane::GetPagesCount	Gibt die Anzahl vonseiten zurück.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Überschreibungen CWnd::GetScrollBarCtrl.)
CMFCTasksPane::GetTask	Ruft eine Aufgabe ab.
CMFCTasksPane::GetTaskCount	Gibt die Anzahl von Aufgabenelementen in einer angegebenen Gruppe zurück.
CMFCTasksPane::GetTaskGroup	Gibt eine Aufgabengruppe für einen angegebenen Gruppenindex zurück.
CMFCTasksPane::GetTaskLocation	Gibt die Gruppe und den Index für eine bestimmte Aufgabe zurück.
CMFCTasksPane::GetTasksHorzOffset	Gibt den horizontalen Offset von Aufgaben von der linken und rechten Rand ihrer übergeordneten Gruppen zurück.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Gibt den vertikalen Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs zurück.
CMFCTasksPane::IsAccessibilityCompatible	(Überschreibungen CDockablePane::IsAccessibilityCompatible.)
CMFCTasksPane::IsAnimationEnabled	Gibt an, ob Animation aktiviert ist.
CMFCTasksPane::IsBackButtonEnabled	Gibt an, ob die Schaltfläche "Zurück" aktiviert ist.
CMFCTasksPane::IsForwardButtonEnabled	Gibt an, ob die Schaltfläche Weiter aktiviert ist.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Gibt an, ob die Weiter und Zurück Navigationsschaltflächen Dropdownmenüs haben.
CMFCTasksPane::IsNavigationToolbarEnabled	Gibt an, ob die Navigationssymbolleiste aktiviert ist.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Gibt an, ob der Aufgabenbereich Wörter in den Bezeichnungen umschließt.
CMFCTasksPane::IsWrapTasksEnabled	Gibt an, ob der Aufgabenbereich Wörter in Aufgaben umschließt.
CMFCTasksPane::LoadState	(Überschreibungen CDockablePane::LoadState.)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Aufgerufen vom Framework, wenn der Benutzer auf ein Element im Aufgabenbereich auf.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Aufgerufen vom Framework, wenn der Benutzer auf die Schaltfläche Zurück klickt.
CMFCTasksPane::OnPressForwardButton	Aufgerufen vom Framework, wenn der Benutzer auf die Vorwärtsnavigationsschaltfläche klickt.
CMFCTasksPane::OnPressHomeButton	Aufgerufen vom Framework, wenn der Benutzer auf die Hauptnavigationsschaltfläche klickt
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Überschreibungen CBasePane::OnSetAccData.)
CMFCTasksPane::OnUpdateCmdUI	(Überschreibungen CDockablePane::OnUpdateCmdUI.)
CMFCTasksPane::PreTranslateMessage	(Überschreibungen CDockablePane::PreTranslateMessage.)
CMFCTasksPane::RecalcLayout	(Überschreibungen Windows-Dienste.)
CMFCTasksPane::RemoveAllGroups	Entfernt alle Gruppen der angegebenen Seite.
CMFCTasksPane::RemoveAllPages	Entfernt alle Seiten aus dem Aufgabenbereich außer die erste Seite (Standard).
CMFCTasksPane::RemoveAllTasks	Entfernt alle Aufgaben von der Gruppe.
CMFCTasksPane::RemoveGroup	Entfernt eine Gruppe.
CMFCTasksPane::RemovePage	Entfernt eine angegebene Seite im Aufgabenbereich.
CMFCTasksPane::RemoveTask	Entfernt eine Aufgabe von einer Aufgabengruppe.
CMFCTasksPane::SaveState	(Überschreibungen CDockablePane::SaveState.)
CMFCTasksPane::Serialize	(Überschreibungen CDockablePane::Serialize.)
CMFCTasksPane::SetActivePage	Aktiviert eine angegebene Seite im Aufgabenbereich.
CMFCTasksPane::SetCaption	Legt den Beschriftungsnamen eines Aufgabenbereichs fest.
CMFCTasksPane::SetGroupCaptionHeight	Gibt die Höhe einer Gruppenbeschriftung fest.
CMFCTasksPane::SetGroupCaptionHorzOffset	Legt den horizontalen Offset einer Gruppenbeschriftung fest.
CMFCTasksPane::SetGroupCaptionVertOffset	Legt den vertikalen Offset einer Gruppenbeschriftung fest.
CMFCTasksPane::SetGroupName	Legt einen Gruppennamen fest.
CMFCTasksPane::SetGroupTextColor	Legt die Textfarbe für eine Gruppenbeschriftung fest.
CMFCTasksPane::SetGroupVertOffset	Legt den vertikalen Offset für eine Gruppe fest.
CMFCTasksPane::SetHorzMargin	Legt den horizontalen Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs fest.
CMFCTasksPane::SetIconsList	Legt die Bildliste fest, die mit Aufgaben zugeordnet ist.
CMFCTasksPane::SetPageCaption	Legt den Beschriftungstext für eine Aufgabenbereichsseite fest.
CMFCTasksPane::SetTaskName	Legt den Namen für eine Aufgabe.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Legt die Textfarbe für eine Aufgabe.
CMFCTasksPane::SetTasksHorzOffset	Legt den horizontalen Offset von Aufgaben von der linken und rechten Rand ihrer übergeordneten Gruppen fest.
CMFCTasksPane::SetVertMargin	Legt den vertikalen Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs fest.
CMFCTasksPane::SetWindowHeight	Gibt die Höhe für ein Fenster fest.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	In oder aus einer Aufgabe.
CMFCTasksPane::ShowTaskByCmdId	In oder aus einer Aufgabe auf Grundlage der Befehl ID
CMFCTasksPane::Update	Aktualisiert die GUI-Elemente, die einem Aufgabenbereich gehören.

Geschützte Methoden

Name	Description
CMFCTasksPane::OnActivateTasksPanePage	Aufgerufen vom Framework, wenn eine neue Aufgabenbereichsseite aktiviert ist.

Hinweise

Die CMFCTasksPane-Klasse implementiert die folgende Funktionalität:

Elemente können gruppiert und jedes Elementgruppieren kann eine zugeordnete Beschriftung haben.
Elementgruppierungen können reduziert werden oder erweitert werden.
Ein Symbol kann auf jedes Element im Aufgabenbereich zugewiesen werden.
Einzelne Elemente können mit einer Befehls-ID zugeordnet werden, die ausgeführt wird, wenn ein Benutzer auf das Element klickt.Wenn der Klick erfolgt, wird die WM_COMMAND Meldung an den Besitzer des Aufgabenbereichssteuerelements gesendet.

Um das CMFCTasksPane-Steuerelement in der Anwendung zu verwenden, führen Sie folgende Schritte aus:

Betten Sie ein CMFCTasksPane-Objekt in die Hauptrahmenfensterklasse ein.
Wenn Sie die WM_CREATE Meldung verarbeiten, rufen Sie die Create-Methode auf.Sie können die normalen CControlBar Formate verwenden.Weitere Informationen finden Sie unter CControlBar::Create.
Rufen Sie die CMFCTasksPane::AddGroup-Methode auf, um verschiedene Gruppen hinzuzufügen.
Rufen Sie die CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel oder CMFCTasksPane::AddMRUFilesList-Memberfunktionen auf, um neue Elemente (Aufgaben) jeder Gruppe hinzuzufügen.
Rufen Sie CMFCTasksPane::EnableGroupCollapse auf, um anzugeben, ob Elementgruppen reduzieren können.

Die folgende Abbildung zeigt ein typisches Aufgabenbereichssteuerelement an.Die erste Gruppe ist eine besondere Gruppe und ihre Beschriftung ist eine dunklere Farbe.Die dritte Gruppe wird reduziert.Die letzte Gruppe ist am unteren Rand des Aufgabenbereichs ausgerichtet und keine Beschriftung verfügt, und die letzte Aufgabe in der Gruppe ist eine einfache Bezeichnung:

Beispiel für den Aufgabenbereich

Sie können die Darstellung des Aufgabenbereichs anpassen, indem Sie verschiedene Ränder und Offsets anpassen.Die folgende Abbildung stellt die Bedeutung dieser Variablen:

Benutzerdefinierte Aufgabengruppe

Beispiel

Das folgende Beispiel zeigt, wie ein CMFCTasksPane-Objekt erstellt und verschiedene Methoden in CMFCTasksPane zu verwenden Sie.Im Beispiel wird gezeigt, wie das Reduzieren von Aufgabengruppen, aktivieren die Dropdownmenüs auf den Weiter und Zurück Navigationsschaltflächen, aktivieren die Bildlaufschaltflächen anstelle einer Bildlaufleiste, ermöglichen die Wortumbruch für den Text der Bezeichnungen festlegen, den Beschriftungsnamen des Aufgabenbereichs, legen die Textfarbe für eine Gruppenbeschriftung und legen die horizontalen und vertikalen Ränder aktiviert.

    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();