CMFCTasksPane-Klasse

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Die CMFCTasksPane-Klasse implementiert eine Liste anklickbarer Elemente (Aufgaben).

Syntax

class CMFCTasksPane : public CDockablePane

Member

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Beschreibung
CMFCTasksPane::AddGroup	Fügt dem Aufgabenbereich-Steuerelement eine neue Gruppe von Aufgaben hinzu.
CMFCTasksPane::AddLabel	Fügt der angegebenen Aufgabengruppe eine neue statische Bezeichnung hinzu.
CMFCTasksPane::AddMRUFilesList	Fügt Aufgaben anhand einer Dateiliste zuletzt verwendeter Aufgaben in einer Gruppe hinzu.
CMFCTasksPane::AddPage	Fügt dem Aufgabenbereich eine neue Seite hinzu.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Fügt der angegebenen Aufgabengruppe eine neue Aufgabe hinzu.
CMFCTasksPane::AddWindow	Fügt dem Aufgabenbereich ein untergeordnetes Fenster hinzu.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Reduziert eine Gruppe programmgesteuert.
CMFCTasksPane::CreateDefaultMiniframe	(Außerkraftsetzungen CPane::CreateDefaultMiniframe.)
CMFCTasksPane::CreateMenu	Vom Framework aufgerufen, um ein Menü für die Menüschaltfläche "Andere Aufgabenbereiche " zu erstellen.
CMFCTasksPane::EnableAnimation	Aktiviert oder deaktiviert die Animation beim Reduzieren oder Erweitern von Aufgabengruppen.
CMFCTasksPane::EnableGroupCollapse	Gibt an, ob Aufgabengruppen reduziert werden können.
CMFCTasksPane::EnableHistoryMenuButtons	Aktiviert oder deaktiviert Dropdownmenüs in den Schaltflächen "Weiter " und "Vorherige Navigation".
CMFCTasksPane::EnableNavigationToolbar	Aktiviert oder deaktiviert die Navigationssymbolleiste.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Aktiviert die Schaltflächen für Bildlauf statt der Bildlaufleiste.
CMFCTasksPane::EnableWrapLabels	Aktiviert oder deaktiviert den Wortumbruch für Bezeichnungen.
CMFCTasksPane::EnableWrapTasks	Aktiviert oder deaktiviert den Wortumbruch für Aufgaben.
CMFCTasksPane::GetActivePage	Gibt den nullbasierten Index für die aktive Seite zurück.
CMFCTasksPane::GetGroupCaptionHeight	Gibt die Höhe der Gruppenbeschriftungen zurück.
CMFCTasksPane::GetGroupCaptionHorzOffset	Gibt den aktuellen Offset einer Gruppenbeschriftung vom linken und rechten Rand des Aufgabenbereichs zurück.
CMFCTasksPane::GetGroupCaptionVertOffset	Gibt den aktuellen Offset einer Gruppenbeschriftung vom oberen und unteren Rand des Aufgabenbereichs zurück.
CMFCTasksPane::GetGroupCount	Ruft die Gesamtanzahl 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 den horizontalen Abstand 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 der Seiten zurück.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Außerkraftsetzungen 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 angegebene Aufgabe zurück.
CMFCTasksPane::GetTasksHorzOffset	Gibt den horizontale Offset von Aufgaben vom linken und rechten Rand der übergeordneten Gruppen zurück.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Gibt den horizontalen Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs zurück.
CMFCTasksPane::IsAccessibilityCompatible	(Überschreibt CDockablePane::IsAccessibilityCompatible.)
CMFCTasksPane::IsAnimationEnabled	Gibt an, ob die Animation aktiviert ist.
CMFCTasksPane::IsBackButtonEnabled	Gibt an, ob die Zurück-Schaltfläche aktiviert ist.
CMFCTasksPane::IsForwardButtonEnabled	Gibt an, ob die Weiter-Schaltfläche aktiviert ist.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Gibt an, ob die Schaltflächen "Weiter" und "Vorherige Navigation" Dropdownmenüs enthalten.
CMFCTasksPane::IsNavigationToolbarEnabled	Gibt an, ob die Navigationssymbolleiste aktiviert ist.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Gibt an, ob der Aufgabenbereich Wörter in Bezeichnungen umbricht.
CMFCTasksPane::IsWrapTasksEnabled	Gibt an, ob der Aufgabenbereich Wörter in Aufgaben umbricht.
CMFCTasksPane::LoadState	(Außerkraftsetzungen CDockablePane::LoadState.)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Wird vom Framework aufgerufen, wenn der Benutzer auf ein Element im Aufgabenbereich klickt.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Wird vom Framework aufgerufen, wenn der Benutzer auf die Zurück-Schaltfläche klickt.
CMFCTasksPane::OnPressForwardButton	Wird vom Framework aufgerufen, wenn der Benutzer auf die Navigationsschaltfläche Weiter klickt.
CMFCTasksPane::OnPressHomeButton	Wird vom Framework aufgerufen, wenn der Benutzer auf die Navigationsschaltfläche Startseite klickt.
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Außerkraftsetzungen CBasePane::OnSetAccData.)
CMFCTasksPane::OnUpdateCmdUI	(Außerkraftsetzungen CDockablePane::OnUpdateCmdUI.)
CMFCTasksPane::P reTranslateMessage	(Außerkraftsetzungen CDockablePane::P reTranslateMessage.)
CMFCTasksPane::RecalcLayout	(Außerkraftsetzungen CPane::RecalcLayout.)
CMFCTasksPane::RemoveAllGroups	Entfernt alle Gruppen auf der angegebenen Seite.
CMFCTasksPane::RemoveAllPages	Entfernt alle Seiten aus dem Aufgabenbereich mit Ausnahme der Standardseite (erste).
CMFCTasksPane::RemoveAllTasks	Entfernt alle Aufgaben aus der Gruppe.
CMFCTasksPane::RemoveGroup	Entfernt eine Gruppe.
CMFCTasksPane::RemovePage	Entfernt eine angegebene Seite aus dem Aufgabenbereich.
CMFCTasksPane::RemoveTask	Entfernt eine Aufgabe aus einer Aufgabengruppe.
CMFCTasksPane::SaveState	(Außerkraftsetzungen CDockablePane::SaveState.)
CMFCTasksPane::Serialize	(Außerkraftsetzungen CDockablePane::Serialize.)
CMFCTasksPane::SetActivePage	Aktiviert eine angegebene Seite im Aufgabenbereich.
CMFCTasksPane::SetCaption	Legt den Beschriftungsnamen eines Aufgabenbereichs fest.
CMFCTasksPane::SetGroupCaptionHeight	Legt 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 den Aufgaben zugeordnete Bilderliste fest.
CMFCTasksPane::SetPageCaption	Legt den Beschriftungstext für eine Aufgabenbereichsseite fest.
CMFCTasksPane::SetTaskName	Legt den Namen für eine Aufgabe fest.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Legt die Textfarbe für eine Aufgabe fest.
CMFCTasksPane::SetTasksHorzOffset	Legt den horizontale Offset von Aufgaben vom linken und rechten Rand der übergeordneten Gruppen fest.
CMFCTasksPane::SetVertMargin	Legt den vertikalen Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs fest.
CMFCTasksPane::SetWindowHeight	Legt die Höhe eines Fensters fest.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	Blendet eine Aufgabe ein oder aus.
CMFCTasksPane::ShowTaskByCmdId	Blendet eine Aufgabe basierend auf der Befehls-ID ein oder aus.
CMFCTasksPane::Update	Aktualisiert die GUI-Elemente, die zu einem Aufgabenbereich gehören.

Geschützte Methoden

Name	Beschreibung
CMFCTasksPane::OnActivateTasksPanePage	Wird vom Framework aufgerufen, wenn eine neue Aufgabenbereichsseite aktiviert wird.

Hinweise

Die CMFCTasksPane-Klasse implementiert folgende Funktionen:

• Elemente können gruppiert werden und jede Elementgruppierung kann eine zugeordnete Beschriftung besitzen.

• Elementgruppierungen können reduzierte oder erweitert werden.

• Jedem Element im Aufgabenbereich kann ein Symbol zugewiesen werden.

• Einzelnen Elementen kann eine Befehls-ID zugeordnet werden, die ausgeführt wird, wenn ein Benutzer auf das Element klickt. Wenn der Klick auftritt, wird die WM_COMMAND Nachricht an den Besitzer des Aufgabenbereich-Steuerelements gesendet.

Befolgen Sie folgende Schritte, um das CMFCTasksPane-Steuerelement in Ihrer Anwendung zu verwenden:

1. Betten Sie ein CMFCTasksPane-Objekt in die Hauptframe-Fensterklasse ein.

2. Rufen Sie bei der Verarbeitung der WM_CREATE Nachricht die Create Methode auf. Sie können die regulären CControlBar-Formatvorlagen verwenden. Weitere Informationen finden Sie unter CControlBar::Create.

3. Rufen Sie die CMFCTasksPane::AddGroup-Methode auf, um verschiedene Gruppen hinzuzufügen.

4. Rufen Sie die CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel oder CMFCTasksPane::AddMRUFilesList-Memberfunktionen auf, um jeder Gruppe neue Elemente (Aufgaben) hinzuzufügen.

5. Rufen Sie CMFCTasksPane::EnableGroupCollapse auf, um anzugeben, ob Elementgruppen reduziert werden können.

Die folgende Abbildung zeigt ein typisches Aufgabenbereich-Steuerelement. Die erste Gruppe ist eine spezielle Gruppe, und die Beschriftung ist dunkler. Die dritte Gruppe wird reduziert. Die letzte Gruppe orientiert sich am unteren Rand des Aufgabenbereichs und besitzt keine Beschriftung und die letzte Aufgabe in der Gruppe ist eine einfache Beschriftung:

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

Beispiel

Das folgende Beispiel veranschaulicht das Erstellen eines CMFCTasksPane-Objekts, und die Verwendung verschiedener Methoden in der CMFCTasksPane-Klasse. Das Beispiel zeigt, wie Sie das Reduzieren von Aufgabengruppen aktivieren, die Dropdownmenüs auf den Schaltflächen "Weiter " und "Vorherige Navigation" aktivieren, die Bildlaufschaltflächen anstelle einer Bildlaufleiste aktivieren, den Textumbruch für den Text in Beschriftungen aktivieren, den Beschriftungsnamen des Aufgabenbereichs festlegen, die Textfarbe für eine Gruppenbeschriftung festlegen, und legen Sie die horizontalen und vertikalen Seitenränder fest.

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

Vererbungshierarchie

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CDockablePane
     └ CMFCTasksPane

Anforderungen

Header: afxTasksPane.h

CMFCTasksPane::AddGroup

Fügt dem Aufgabenbereich-Steuerelement eine neue Gruppe von Aufgaben hinzu.

int AddGroup(
    int nPageIdx,
    LPCTSTR lpszGroupName,
    BOOL bBottomLocation = FALSE,
    BOOL bSpecial = FALSE,
    HICON hIcon = NULL);

int AddGroup(
    LPCTSTR lpszGroupName,
    BOOL bBottomLocation = FALSE,
    BOOL bSpecial = FALSE,
    HICON hIcon = NULL);

Parameter

nPageIdx
[in] Gibt den nullbasierten Seitenindex an.

lpszGroupName
[in] Gibt den Gruppennamen an.

bBottomLocation
[in] TRUE, um die Gruppe am unteren Rand des Aufgabenbereich-Steuerelements zu erstellen; andernfalls FALSE.

bSpecial
[in] TRUE, um diese Gruppe als spezielle Gruppe zu markieren; andernfalls FALSE. Weitere Informationen zu speziellen Gruppen finden Sie im Abschnitt "Hinweise" von CMFCTasksPane.

hIcon
[in] Gibt das Symbol an, das in der Gruppenbeschriftung angezeigt werden soll.

Rückgabewert

Der nullbasierte Index der Gruppe in der internen Liste der Gruppen, die die Klasse verwaltet.

Hinweise

Rufen Sie diese Methode auf, um eine Gruppe von Aufgaben zu erstellen und diese Gruppe dem Aufgabenbereich-Steuerelement hinzuzufügen.

Das Framework zeigt Aufgabengruppen oben im Aufgabenbereich-Steuerelement oder unten an. Das Framework kann nur eine Gruppe unten anzeigen; diese Gruppe muss zuletzt hinzugefügt werden.

CMFCTasksPane::AddLabel

Fügt der angegebenen Aufgabengruppe eine Beschriftung hinzu.

int AddLabel(
    int nGroup,
    LPCTSTR lpszLabelName,
    int nTaskIcon = -1,
    BOOL bIsBold = FALSE);

Parameter

nGroup
[in] Gibt den Index der Gruppe an, in der die Bezeichnung hinzugefügt wird.

lpszLabelName
[in] Gibt den Namen der Bezeichnung an.

nTaskIcon
[in] Gibt das Symbol an, das neben der Beschriftung angezeigt werden soll. Das Framework speichert Symbole in einer Liste von Bildern. Dieser Parameter ist ein Index in dieser Liste.

bIsBold
[in] TRUE, um die Beschriftung fett formatiert anzuzeigen; andernfalls FALSE.

Rückgabewert

Der nullbasierte Index der Gruppe, in der die Bezeichnung hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.

Hinweise

Das Framework behandelt Aufgaben und Bezeichnungen unterschiedlich. Wenn ein Benutzer auf eine Aufgabe klickt, führt das Framework einen Befehl aus. Wenn ein Benutzer auf eine Bezeichnung klickt, wird kein Befehl ausgeführt. Weitere Informationen finden Sie unter CMFCTasksPane::AddTask.

CMFCTasksPane::AddMRUFilesList

Fügt einer Gruppe eine Aufgabe für jede Datei hinzu, die in einer Liste der zuletzt verwendeten Dateien (Most Recently Used, MRU) gespeichert ist.

int AddMRUFilesList(
    int nGroup,
    int nMaxFiles = 4);

Parameter

nGroup
[in] Gibt den Index einer Gruppe an. Mit dieser Methode wird die LISTE der MRU-Dateien der gruppe hinzugefügt, die durch diesen Parameter angegeben wird.

nMaxFiles
[in] Gibt die Anzahl der Dateien an, die in der Liste der MRU-Dateien angezeigt werden sollen.

Rückgabewert

Der nullbasierte Index der Gruppe, in der die LISTE der MRU-Dateien hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.

CMFCTasksPane::AddPage

Fügt dem Aufgabenbereich eine Seite hinzu.

int AddPage(LPCTSTR lpszPageLabel);

Parameter

lpszPageLabel
[in] Gibt die Beschriftung für die Seite an.

Rückgabewert

Der nullbasierte Index der neuen Seite.

CMFCTasksPane::AddSeparator

int AddSeparator(int nGroup);

Parameter

[in] nGroup

Rückgabewert

Bemerkungen

CMFCTasksPane::AddTask

Fügt der angegebenen Aufgabengruppe eine Aufgabe hinzu.

int AddTask(
    int nGroup,
    LPCTSTR lpszTaskName,
    int nTaskIcon = -1,
    UINT uiCommandID = 0,
    DWORD dwUserData = 0);

Parameter

nGroup
[in] Gibt den Gruppenindex an, in dem die Aufgabe hinzugefügt wird.

lpszTaskName
[in] Gibt den Namen des Vorgangs an.

nTaskIcon
[in] Gibt das Symbol an, das neben der Aufgabe angezeigt werden soll. Das Framework speichert Symbole in einer Liste von Bildern. Dieser Parameter ist ein Index in dieser Liste.

uiCommandID
[in] Gibt die Befehls-ID des auszuführenden Befehls an, wenn der Benutzer auf die Aufgabe klickt. Die Aufgabe wird als Bezeichnung behandelt, wenn uiCommandID 0 ist.

dwUserData
[in] Gibt die benutzerdefinierten Daten an, die der Aufgabe zugeordnet werden sollen.

Rückgabewert

Der nullbasierte Index der Gruppe, in der die Aufgabe hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.

CMFCTasksPane::AddWindow

Fügt dem Aufgabenbereich ein untergeordnetes Fenster hinzu.

int AddWindow(
    int nGroup,
    HWND hwndTask,
    int nWndHeight,
    BOOL bAutoDestroyWindow = FALSE,
    DWORD dwUserData = 0);

Parameter

nGroup
[in] Gibt den Gruppenindex an, in dem das Fenster hinzugefügt wird.

hwndTask
[in] Gibt das Handle des hinzuzufügenden Fensters an.

nWndHeight
[in] Gibt die Höhe des Fensters an.

bAutoDestroyWindow
[in] TRUE, um das Fenster zu zerstören, wenn der Vorgang entfernt wird; andernfalls FALSE.

dwUserData
[in] Gibt die benutzerdefinierten Daten an, die der Aufgabe zugeordnet sind.

Rückgabewert

Der nullbasierte Index der Gruppe, in der das Fenster hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.

Hinweise

Rufen Sie diese Methode auf, um einem Aufgabenbereich ein Steuerelement hinzuzufügen. Sie können beispielsweise ein Bearbeitungssteuerelement hinzufügen, das wie eine Suchleiste funktioniert.

CMFCTasksPane::CMFCTasksPane

Erstellt ein CMFCTasksPane -Objekt.

CMFCTasksPane();

CMFCTasksPane::CollapseAllGroups

void CollapseAllGroups(BOOL bCollapse = TRUE);

void CollapseAllGroups(
    int nPageIdx,
    BOOL bCollapse);

Parameter

[in] bCollapse
[in] nPageIdx

Hinweise

CMFCTasksPane::CollapseGroup

Reduziert oder erweitert eine Gruppe.

BOOL CollapseGroup(
    CMFCTasksPaneTaskGroup* pGroup,
    BOOL bCollapse = TRUE);

BOOL CollapseGroup(
    int nGroup,
    BOOL bCollapse = TRUE);

Parameter

pGroup
[in] Gibt die gruppe an, die reduziert werden soll.

bCollapse
[in] TRUE, um die Gruppe zu reduzieren; FALSE, um die Gruppe zu erweitern.

nGroup
[in] Gibt den nullbasierten Index der Gruppe an, die in der internen Liste der Gruppen reduziert werden soll.

Rückgabewert

TRUE, wenn die Gruppe erfolgreich reduziert oder erweitert wird; andernfalls FALSE.

Hinweise

Eine reduzierte Gruppe zeigt nur die Gruppenbeschriftung an; die Liste der Aufgaben ausgeblendet ist.

CMFCTasksPane::CreateDefaultMiniframe

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parameter

[in] rectInitial

Rückgabewert

Bemerkungen

CMFCTasksPane::CreateMenu

Erstellt ein Menü, das angezeigt wird, wenn ein Benutzer auf die Menüschaltfläche "Andere Aufgabenbereiche " klickt.

HMENU CreateMenu() const;

Rückgabewert

Ein Handle zum neuen Menü.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um das Menü für einen Aufgabenbereich anzupassen.

Das popupmenü, das diese Methode erstellt, enthält die Liste der Seiten im Aufgabenbereich. Das Menü zeigt ein Häkchen neben der aktiven Seite an.

CMFCTasksPane::EnableAnimation

Aktiviert oder deaktiviert die Animation, die auftritt, wenn eine Aufgabengruppe erweitert oder reduziert wird.

void EnableAnimation(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um die Animation zu aktivieren, die auftritt, wenn eine Aufgabengruppe erweitert oder reduziert wird; andernfalls FALSE.

Hinweise

Standardmäßig ist die Animation, die auftritt, wenn eine Aufgabengruppe erweitert oder reduziert wird, aktiviert.

CMFCTasksPane::EnableGroupCollapse

Gibt an, ob ein Benutzer Aufgabengruppen reduzieren kann.

void EnableGroupCollapse(BOOL bEnable);

Parameter

bEnable
[in] TRUE, wenn Benutzer Aufgabengruppen reduzieren können; andernfalls FALSE.

Hinweise

Eine aufgabengruppe, die reduziert ist, zeigt nur die Gruppenbeschriftung an. die Liste der Aufgaben ausgeblendet ist.

CMFCTasksPane::EnableHistoryMenuButtons

Aktiviert Dropdownmenüs auf den Schaltflächen "Weiter " und "Vorherige Navigation".

void EnableHistoryMenuButtons(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um Dropdownmenüs auf den Schaltflächen "Weiter " und "Vorherige Navigation" zu aktivieren, andernfalls FALSE.

Hinweise

Standardmäßig sind die Dropdownmenüs auf den Schaltflächen "Weiter " und "Vorherige " deaktiviert.

Die Menüs enthalten den Verlauf von Aufgabenseiten, die der Benutzer verwendet hat.

CMFCTasksPane::EnableNavigationToolbar

Aktiviert oder deaktiviert die Navigationssymbolleiste.

void EnableNavigationToolbar(
    BOOL bEnable = TRUE,
    UINT uiToolbarBmpRes = 0,
    CSize sizeToolbarImage = CSize(0,
    0),
    CSize sizeToolbarButton = CSize(0,
    0));

Parameter

bEnable
[in] TRUE, um die Navigationssymbolleiste zu aktivieren; andernfalls FALSE.

uiToolbarBmpRes
[in] Gibt die Ressourcen-ID der Bitmap an, die die Bilder enthält, die auf der Symbolleiste angezeigt werden sollen.

sizeToolbarImage
[in] Gibt die Größe eines Symbolleistenbilds an.

sizeToolbarButton
[in] Gibt die Größe einer Symbolleistenschaltfläche an.

Hinweise

Die Navigationssymbolleiste ist eine Symbolleiste, die das Framework oben im Aufgabenbereich anzeigt. Die Navigationssymbolleiste enthält die Navigationsschaltflächen "Zurück", "Vorwärts" und "Start" und eine Menüschaltfläche, die die Liste der verfügbaren Seiten enthält.

Standardmäßig zeigt das Framework nicht die Navigationssymbolleiste an. Wenn die Navigationssymbolleiste nicht angezeigt wird, befinden sich die Navigationsschaltflächen auf der Beschriftung der Docking-Leiste.

CMFCTasksPane::EnableOffsetCustomControls

void EnableOffsetCustomControls(BOOL bEnable);

Parameter

[in] bEnable

Hinweise

CMFCTasksPane::EnableScrollButtons

Aktiviert Bildlaufschaltflächen anstelle einer Bildlaufleiste.

void EnableScrollButtons(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um Bildlaufschaltflächen im Aufgabenbereich anstelle einer Bildlaufleiste anzuzeigen; andernfalls FALSE.

Hinweise

Standardmäßig zeigt das Framework Bildlaufschaltflächen im Aufgabenbereich an.

CMFCTasksPane::EnableWrapLabels

Aktiviert oder deaktiviert den Textumbruch für den Text in Beschriftungen.

void EnableWrapLabels(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um den Text in Beschriftungen umzuschließen, die im Aufgabenbereich angezeigt werden; andernfalls FALSE.

Hinweise

Standardmäßig umschließt das Framework den Text nicht in Beschriftungen. Wenn der Textumbruch aktiviert ist, kann der Text in Beschriftungen in mehreren Zeilen angezeigt werden. Die Beschriftung kann Zeilenumbruchmarkierungen wie \n z. B. die Unterstreichungsmarkierung &enthalten.

CMFCTasksPane::EnableWrapTasks

Aktiviert oder deaktiviert den Textumbruch für den Text in Aufgaben.

void EnableWrapTasks(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um Aufgaben im Aufgabenbereich zu umschließen; andernfalls FALSE.

Hinweise

Standardmäßig ist der Textumbruch für Aufgaben deaktiviert.

CMFCTasksPane::GetActivePage

Gibt den nullbasierten Index für die aktive Seite zurück.

int GetActivePage() const;

Rückgabewert

Der nullbasierte Index der aktiven Seite.

CMFCTasksPane::GetGroupCaptionHeight

Gibt die Höhe der Gruppenbeschriftung zurück.

int GetGroupCaptionHeight() const;

Rückgabewert

Die Höhe der Gruppenbeschriftung in Pixel.

CMFCTasksPane::GetGroupCaptionHorzOffset

Gibt den horizontalen Offset einer Gruppenbeschriftung zurück.

int GetGroupCaptionHorzOffset() const;

Rückgabewert

Der horizontale Offset einer Gruppenbeschriftung. Der horizontale Offset ist der Abstand in Pixel vom linken oder rechten Rand des Aufgabenbereichs.

CMFCTasksPane::GetGroupCaptionVertOffset

Gibt den vertikalen Offset einer Gruppenbeschriftung zurück.

int GetGroupCaptionVertOffset() const;

Rückgabewert

Der vertikale Offset einer Gruppenbeschriftung vom oberen und unteren Rand des Aufgabenbereichs.

Hinweise

Der Standardwert für den vertikalen Offset beträgt 7 Pixel.

CMFCTasksPane::GetGroupCount

Ruft die Gesamtanzahl von Gruppen zurück.

int GetGroupCount() const;

Rückgabewert

Die Gesamtanzahl der Gruppen im Aufgabenbereich.

CMFCTasksPane::GetGroupLocation

Gibt den internen Gruppenindex für die angegebene Gruppe zurück.

BOOL GetGroupLocation(
    CMFCTasksPaneTaskGroup* pGroup,
    int& nGroup) const;

Parameter

pGroup
[in] Gibt die Aufgabengruppe an, deren Position abgerufen wird.

nGroup
[out] Enthält den nullbasierten Index der Aufgabengruppe.

Rückgabewert

TRUE, wenn die Aufgabengruppe gefunden wurde; andernfalls FALSE.

CMFCTasksPane::GetGroupVertOffset

Gibt den vertikalen Offset einer Gruppe zurück.

int GetGroupVertOffset() const;

Rückgabewert

Der vertikale Offset einer Gruppe in Pixel.

CMFCTasksPane::GetHorzMargin

Gibt den horizontalen Abstand zwischen einem Aufgabenbereich und dem Rand des Clientbereichs zurück.

int GetHorzMargin() const;

Rückgabewert

Der horizontale Abstand zwischen einem Aufgabenbereich und dem Rand des Clientbereichs.

Hinweise

Der Standardabstand zwischen einem Aufgabenbereich und dem Rand des Clientbereichs beträgt 12 Pixel.

CMFCTasksPane::GetNextPages

void GetNextPages(CStringList& lstNextPages) const;

Parameter

[in] lstNextPages

Hinweise

CMFCTasksPane::GetPageByGroup

Ruft den Seitenindex für eine angegebene Gruppe ab.

BOOL GetPageByGroup(
    int nGroup,
    int& nPage) const;

Parameter

nGroup
[in] Gibt den nullbasierten Index der Aufgabengruppe an.

nPage
[out] Enthält den Seitenindex für die angegebene Gruppe. Wenn die Aufgabengruppe nur eine Standardseite enthält, ist der zurückgegebene Wert 0.

Rückgabewert

TRUE, wenn die Gruppe "nGroup " vorhanden ist; andernfalls FALSE.

CMFCTasksPane::GetPagesCount

Gibt die Anzahl der Seiten zurück.

int GetPagesCount() const;

Rückgabewert

Die Anzahl der Seiten im Aufgabenbereich.

CMFCTasksPane::GetPreviousPages

void GetPreviousPages(CStringList& lstPrevPages) const;

Parameter

[in] lstPrevPages

Hinweise

CMFCTasksPane::GetScrollBarCtrl

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parameter

[in] nBar

Rückgabewert

Bemerkungen

CMFCTasksPane::GetTask

Ruft eine Aufgabe ab.

CMFCTasksPaneTask* GetTask(
    int nGroup,
    int nTask) const;

Parameter

nGroup
[in] Gibt den nullbasierten Index der Gruppe an, die die Aufgabe enthält.

nTask
[in] Gibt den nullbasierten Index der Aufgabe in der durch nGroup angegebenen Liste an.

Rückgabewert

Der Vorgang am angegebenen Index.

CMFCTasksPane::GetTaskCount

Gibt die Anzahl der Vorgänge in einer angegebenen Gruppe zurück.

int GetTaskCount(int nGroup) const;

Parameter

nGroup
[in] Gibt den Index der Aufgabengruppe an.

Rückgabewert

Die Anzahl der Vorgänge in der angegebenen Gruppe oder 0, wenn nGroup ungültig ist.

CMFCTasksPane::GetTaskGroup

Gibt eine Aufgabengruppe für einen angegebenen Gruppenindex zurück.

CMFCTasksPaneTaskGroup* GetTaskGroup(int nGroup) const;

Parameter

nGroup
[in] Gibt den nullbasierten Index der abzurufenden Gruppe an.

Rückgabewert

Die Aufgabengruppe am angegebenen Index.

CMFCTasksPane::GetTaskLocation

Gibt die Gruppe und den Index für einen angegebenen Vorgang zurück.

BOOL GetTaskLocation(
    UINT uiCommandID,
    int& nGroup,
    int& nTask) const;

BOOL GetTaskLocation(
    HWND hwndTask,
    int& nGroup,
    int& nTask) const;

BOOL GetTaskLocation(
    CMFCTasksPaneTask* pTask,
    int& nGroup,
    int& nTask) const;

Parameter

uiCommandID
[in] Gibt die Befehls-ID der zu suchenden Aufgabe an.

nGroup
[out] Enthält den Gruppenindex der Aufgabe.

nTask
[out] Enthält den Index der Aufgabe in der Aufgabengruppe.

hwndTask
[in] Gibt das Fenster an, das der Aufgabe zugeordnet ist.

pTask
[in] Gibt die zu suchende Aufgabe an.

Rückgabewert

TRUE, wenn der Vorgangsspeicherort gefunden wurde; FALSE, wenn der angegebene Vorgang nicht vorhanden ist.

Hinweise

Diese Methode ruft den Gruppenindex und den Aufgabenindex für den angegebenen Vorgang ab. Wenn die Methode FALSE zurückgibt, werden nGroup und nTask auf -1 festgelegt.

CMFCTasksPane::GetTasksHorzOffset

Gibt den horizontalen Versatz von Vorgängen zurück.

int GetTasksHorzOffset() const;

Rückgabewert

Der horizontale Offset von Vorgängen vom linken und rechten Rand ihrer übergeordneten Gruppen.

Hinweise

Der standardmäßige horizontale Offset von Vorgängen beträgt 12 Pixel.

CMFCTasksPane::GetTasksIconHorzOffset

int GetTasksIconHorzOffset() const;

Rückgabewert

Bemerkungen

CMFCTasksPane::GetTasksIconVertOffset

int GetTasksIconVertOffset() const;

Rückgabewert

Bemerkungen

CMFCTasksPane::GetVertMargin

Gibt den vertikalen Rand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs zurück.

int GetVertMargin() const;

Rückgabewert

Der vertikale Rand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs.

Hinweise

Der vertikale Rand ist der Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs. Der Standardwert des vertikalen Rands beträgt 12 Pixel.

CMFCTasksPane::IsAccessibilityCompatible

virtual BOOL IsAccessibilityCompatible();

Rückgabewert

Bemerkungen

CMFCTasksPane::IsAnimationEnabled

Gibt an, ob die Animation aktiviert ist.

BOOL IsAnimationEnabled() const;

Rückgabewert

TRUE, wenn die Animation, die auftritt, wenn ein Benutzer eine Gruppe erweitert oder reduziert, aktiviert ist; andernfalls FALSE.

Hinweise

Rufen Sie CMFCTasksPane::EnableAnimation auf, um animationen zu aktivieren oder zu deaktivieren.

CMFCTasksPane::IsBackButtonEnabled

Gibt an, ob die Zurück-Schaltfläche aktiviert ist.

BOOL IsBackButtonEnabled() const;

Rückgabewert

TRUE, wenn die Zurück-Schaltfläche aktiviert ist; andernfalls FALSE.

Hinweise

Wenn ein Benutzer auf die Schaltfläche "Zurück" klickt, zeigt das Framework die vorherige Aufgabenseite an.

CMFCTasksPane::IsForwardButtonEnabled

Gibt an, ob die Weiter-Schaltfläche aktiviert ist.

BOOL IsForwardButtonEnabled() const;

Rückgabewert

TRUE, wenn die Vorwärtsschaltfläche aktiviert ist; andernfalls FALSE.

Hinweise

Die Schaltfläche "Vorwärts" ermöglicht die Vorwärtsnavigation im Verlauf der Aufgabenseiten.

CMFCTasksPane::IsGroupCollapseEnabled

BOOL IsGroupCollapseEnabled() const;

Rückgabewert

Bemerkungen

CMFCTasksPane::IsHistoryMenuButtonsEnabled

Gibt an, ob die Schaltflächen "Weiter" und "Vorherige Navigation" Dropdownmenüs enthalten.

BOOL IsHistoryMenuButtonsEnabled() const;

Rückgabewert

TRUE, wenn die Schaltflächen "Weiter" und "Vorherige Navigation" Dropdownmenüs aufweisen; andernfalls FALSE.

CMFCTasksPane::IsNavigationToolbarEnabled

Gibt an, ob die Navigationssymbolleiste aktiviert ist.

BOOL IsNavigationToolbarEnabled() const;

Rückgabewert

TRUE, wenn die Navigationssymbolleiste aktiviert ist; andernfalls FALSE.

CMFCTasksPane::IsToolBox

virtual BOOL IsToolBox() const;

Rückgabewert

Bemerkungen

CMFCTasksPane::IsWrapLabelsEnabled

Gibt an, ob der Aufgabenbereich Wörter in Bezeichnungen umbricht.

BOOL IsWrapLabelsEnabled() const;

Rückgabewert

TRUE, wenn Wörter in Bezeichnungen umbrochen werden; andernfalls FALSE.

CMFCTasksPane::IsWrapTasksEnabled

Gibt an, ob das Framework die Aufgabenzeichenfolge umschließt.

BOOL IsWrapTasksEnabled() const;

Rückgabewert

TRUE, wenn die Vorgangszeichenfolge umbrochen wird; andernfalls FALSE.

CMFCTasksPane::LoadState

virtual BOOL LoadState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT) -1);

Parameter

[in] lpszProfileName
[in] nIndex
[in] uiID

Rückgabewert

Bemerkungen

CMFCTasksPane::OnActivateTasksPanePage

Wird vom Framework aufgerufen, wenn eine Aufgabenbereichsseite aktiv wird.

virtual void OnActivateTasksPanePage();

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um die Darstellung der Aufgabenbereichseite anzupassen.

CMFCTasksPane::OnCancel

virtual void OnCancel();

Hinweise

CMFCTasksPane::OnClickTask

Wird vom Framework aufgerufen, wenn der Benutzer auf ein Element im Aufgabenbereich klickt.

virtual void OnClickTask(
    int nGroupNumber,
    int nTaskNumber,
    UINT uiCommandID,
    DWORD dwUserData);

Parameter

nGroupNumber
[in] Gibt den nullbasierten Index der Gruppe an, die den geklickten Vorgang enthält.

nTaskNumber
[in] Gibt den nullbasierten Index des geklickten Vorgangs an.

uiCommandID
[in] Gibt die Befehls-ID an, die der Aufgabe zugeordnet ist.

dwUserData
[in] Enthält benutzerdefinierte Daten, die der geklickten Aufgabe zugeordnet sind.

Hinweise

Das Framework ruft diese Methode auf, wenn ein Benutzer auf eine Aufgabe klickt. Standardmäßig überprüft das Framework die Befehls-ID, die mit der geklickten Aufgabe verknüpft ist, und sendet, wenn es nicht null ist, die WM_COMMAND Nachricht an den Besitzer des Aufgabenbereich-Steuerelements.

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn auf eine Aufgabe geklickt wird.

CMFCTasksPane::OnOK

virtual void OnOK();

Hinweise

CMFCTasksPane::OnPressBackButton

Wird vom Framework aufgerufen, wenn der Benutzer auf die Zurück-Schaltfläche klickt.

virtual void OnPressBackButton();

Hinweise

Standardmäßig zeigt das Framework die zuvor angezeigte Seite an.

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn der Benutzer auf die Schaltfläche "Zurück" klickt.

CMFCTasksPane::OnPressForwardButton

Wird vom Framework aufgerufen, wenn der Benutzer auf die Navigationsschaltfläche Weiter klickt.

virtual void OnPressForwardButton();

Hinweise

Standardmäßig zeigt das Framework die Seite an, die der Benutzer vor dem Klicken auf die Schaltfläche "Zurück " angezeigt hat.

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn der Benutzer auf die Vorwärtsschaltfläche klickt.

CMFCTasksPane::OnPressHomeButton

Wird vom Framework aufgerufen, wenn der Benutzer auf die Startnavigationsschaltfläche klickt.

virtual void OnPressHomeButton();

Hinweise

Standardmäßig zeigt das Framework die Standardseite für die Aufgabengruppe an.

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn der Benutzer auf die Startnavigationsschaltfläche klickt.

CMFCTasksPane::OnPressOtherButton

virtual void OnPressOtherButton(
    CMFCCaptionMenuButton* pbtn,
    CWnd* pWndOwner);

Parameter

[in] Pbtn
[in] pWndOwner

Hinweise

CMFCTasksPane::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

Parameter

[in] lVal

Rückgabewert

Bemerkungen

CMFCTasksPane::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parameter

[in] pTarget
[in] bDisableIfNoHndler

Hinweise

CMFCTasksPane::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

[in] pMsg

Rückgabewert

Bemerkungen

CMFCTasksPane::RecalcLayout

void RecalcLayout(BOOL bRedraw = TRUE);

Parameter

[in] bRedraw

Hinweise

CMFCTasksPane::RemoveAllGroups

Entfernt alle Gruppen auf der angegebenen Seite.

void RemoveAllGroups(int nPageIdx = 0);

Parameter

nPageIdx
[in] Gibt den nullbasierten Index der Seite an.

Hinweise

Entfernt alle Gruppen auf der durch nPageIdx angegebenen Seite oder alle Gruppen, wenn nur eine Standardseite vorhanden ist.

CMFCTasksPane::RemoveAllPages

Entfernt alle Seiten aus dem Aufgabenbereich mit Ausnahme der Standardseite (erste).

void RemoveAllPages();

CMFCTasksPane::RemoveAllTasks

Entfernt alle Vorgänge aus der angegebenen Gruppe.

void RemoveAllTasks(int nGroup);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Gruppe an.

CMFCTasksPane::RemoveGroup

Entfernt eine Gruppe.

void RemoveGroup(int nGroup);

Parameter

nGroup
[in] Gibt den nullbasierten Index der zu entfernenden Gruppe an.

Hinweise

Diese Methode entfernt eine einzelne Gruppe. Rufen Sie zum Entfernen aller Gruppen stattdessen CMFCTasksPane::RemoveAllGroups auf.

Wenn das Framework eine Gruppe entfernt, werden alle damit verbundenen Aufgaben und Benutzerfenster zerstört.

CMFCTasksPane::RemovePage

Entfernt eine angegebene Seite aus dem Aufgabenbereich.

void RemovePage(int nPageIdx);

Parameter

nPageIdx
[in] Gibt den nullbasierten Index der zu entfernenden Seite an.

CMFCTasksPane::RemoveTask

Entfernt eine Aufgabe aus einer Aufgabengruppe.

BOOL RemoveTask(
    int nGroup,
    int nTask,
    BOOL bRedraw = TRUE);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Aufgabengruppe an, die die zu entfernende Aufgabe enthält.

nTask
[in] Gibt den nullbasierten Index der zu entfernenden Aufgabe an.

bRedraw
[in] TRUE, um den Aufgabenbereich neu zu zeichnen; andernfalls FALSE.

Rückgabewert

TRUE, wenn die Funktion erfolgreich ist; FALSE, wenn "nGroup " oder "nTask " ungültig ist.

CMFCTasksPane::SaveState

virtual BOOL SaveState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT) -1);

Parameter

[in] lpszProfileName
[in] nIndex
[in] uiID

Rückgabewert

Bemerkungen

CMFCTasksPane::Serialize

virtual void Serialize(CArchive& ar);

Parameter

[in] ar

Hinweise

CMFCTasksPane::SetActivePage

Macht die angegebene Seite im Aufgabenbereich aktiv.

void SetActivePage(int nPageIdx);

Parameter

nPageIdx
[in] Gibt den nullbasierten Index der anzuzeigenden Seite an.

Hinweise

Diese Methode gibt an, ob die nPageIdx ungültig ist.

CMFCTasksPane::SetCaption

Legt den Beschriftungsnamen eines Aufgabenbereichs fest.

void SetCaption(LPCTSTR lpszName);

Parameter

lpszName
[in] Gibt den Beschriftungsnamen an.

Hinweise

Wenn ein Aufgabenbereich mehrere Seiten enthält, weist die Standardseite die Beschriftung auf, die mithilfe dieser Funktion festgelegt wurde.

CMFCTasksPane::SetGroupCaptionHeight

Legt die Höhe einer Gruppenbeschriftung fest.

void SetGroupCaptionHeight(int n = -1);

Parameter

n
[in] Gibt die Höhe der Beschriftung an.

Hinweise

Rufen Sie diese Methode auf, um die Ränder der Aufgabenbereichselemente anzupassen.

Wenn n -1 ist, bestimmt das Framework den Randwert mithilfe des visuellen Managers ( CMFCVisualManager::GetTasksPaneGroupCaptionHeight). Die Standardbeschriftungshöhe ist 25 Pixel.

CMFCTasksPane::SetGroupCaptionHorzOffset

Legt den horizontalen Offset einer Gruppenbeschriftung fest.

void SetGroupCaptionHorzOffset(int n = -1);

Parameter

n
[in] Gibt den horizontalen Offset der Gruppenbeschriftung an.

CMFCTasksPane::SetGroupCaptionVertOffset

Legt den vertikalen Offset einer Gruppenbeschriftung fest.

void SetGroupCaptionVertOffset(int n = -1);

Parameter

n
[in] Gibt den vertikalen Offset in Pixeln der Gruppenbeschriftung an.

CMFCTasksPane::SetGroupName

Legt einen Gruppennamen fest.

BOOL SetGroupName(
    int nGroup,
    LPCTSTR lpszGroupName);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Gruppe an.

lpszGroupName
[in] Gibt den Namen der Gruppe an.

Rückgabewert

TRUE, wenn der Gruppenname erfolgreich festgelegt wurde; andernfalls FALSE.

CMFCTasksPane::SetGroupTextColor

Legt die Textfarbe für eine Gruppenbeschriftung fest.

BOOL SetGroupTextColor(
    int nGroup,
    COLORREF color,
    COLORREF colorHot = (COLORREF)-1);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Gruppe an.

color
[in] Gibt die Textfarbe an.

colorHot
[in] Gibt die Textfarbe für die hervorgehobene Gruppe an. Wenn -1, wird die Standardmarkierfarbe verwendet.

Rückgabewert

TRUE, wenn die Gruppentextfarbe erfolgreich geändert wurde; andernfalls FALSE.

CMFCTasksPane::SetGroupVertOffset

Legt den vertikalen Offset für eine Gruppe fest.

void SetGroupVertOffset(int n = -1);

Parameter

n
[in] Gibt den vertikalen Offset an.

Hinweise

Der vertikale Offset ist der Abstand zwischen einer Aufgabengruppe und dem Rahmen des Aufgabenbereichs.

Rufen Sie diese Methode auf, um die Ränder von Aufgabenbereichselementen anzupassen. Wenn n -1 ist, bestimmt das Framework den Randwert mithilfe des visuellen Managers (CMFCVisualManager::GetTasksPaneGroupVertOffset). Der Standardoffset beträgt 15 Pixel.

CMFCTasksPane::SetHorzMargin

Legt den horizontalen Rand fest.

void SetHorzMargin(int n = -1);

Parameter

n
[in] Gibt den Rand in Pixel an.

Hinweise

Der horizontale Rand ist der Abstand zwischen einem Aufgabenbereich und dem oberen oder unteren Rand des Clientbereichs.

Wenn n -1 ist und das Framework den Randwert mithilfe des visuellen Managers (CMFCVisualManager::GetTasksPaneHorzMargin) bestimmt. Der horizontale Standardrand beträgt 12 Pixel.

CMFCTasksPane::SetIconsList

Legt die Bildliste fest.

BOOL SetIconsList(
    UINT uiImageListResID,
    int cx,
    COLORREF clrTransparent = RGB(255, 0, 255));

void SetIconsList(HIMAGELIST hIcons);

Parameter

uiImageListResID
[in] Gibt die Ressourcen-ID der Bildliste an.

cx
[in] Gibt die Größe von Symbolen in der Bildliste an.

clrTransparent
[in] Gibt die transparente Farbe an.

hIcons
[in] Gibt die Bildliste an, die die Symbole für den Aufgabenbereich enthält.

Hinweise

Das Framework speichert Symbole in einer Bildliste. Aufgaben sind Symbolen zugeordnet, die in dieser Liste gespeichert sind.

Diese Methode ordnet eine Bildliste dem Aufgabenbereich-Steuerelement zu. Um das Symbol für eine Aufgabe festzulegen, wenn Sie CMFCTasksPane::AddTask aufrufen, legen nTaskIcon Sie diesen auf den entsprechenden nullbasierten Index in dieser Bildliste fest.

CMFCTasksPane::SetPageCaption

Legt den Beschriftungstext für eine Aufgabenbereichsseite fest.

void SetPageCaption(
    int nPageIdx,
    LPCTSTR lpszName);

Parameter

nPageIdx
[in] Gibt den nullbasierten Index der Seite an.

lpszName
[in] Gibt den Beschriftungstext an, der auf der Seite angezeigt werden soll.

Hinweise

Wenn ein Aufgabenbereich über mehrere Seiten verfügt, weist die Standardseite die Beschriftung auf, die mithilfe dieser Methode festgelegt wurde.

CMFCTasksPane::SetTaskName

Legt den Namen für eine Aufgabe fest.

BOOL SetTaskName(
    int nGroup,
    int nTask,
    LPCTSTR lpszTaskName);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Aufgabengruppe an.

nTask
[in] Gibt den nullbasierten Index des Vorgangs an.

lpszTaskName
[in] Gibt den Aufgabennamen an.

Rückgabewert

TRUE, wenn der Vorgangsname erfolgreich festgelegt wurde; andernfalls FALSE.

CMFCTasksPane::SetTasksHorzOffset

Legt den horizontalen Offset für Vorgänge fest.

void SetTasksHorzOffset(int n = -1);

Parameter

n
[in] Gibt den horizontalen Offset an.

Hinweise

Der horizontale Offset ist der Abstand in Pixeln vom linken und rechten Rand einer Gruppe.

Wenn n -1 ist, legt diese Methode den horizontalen Offset auf den von der CMFCVisualManager::GetTasksPaneTaskHorzOffset Methode zurückgegebenen Wert fest.

Der horizontale Standardoffset beträgt 12 Pixel.

CMFCTasksPane::SetTasksIconHorzOffset

void SetTasksIconHorzOffset(int n = -1);

Parameter

[in] n

Hinweise

CMFCTasksPane::SetTasksIconVertOffset

void SetTasksIconVertOffset(int n = -1);

Parameter

[in] n

Hinweise

CMFCTasksPane::SetTaskTextColor

Legt die Textfarbe für eine Aufgabe fest.

BOOL SetTaskTextColor(
    int nGroup,
    int nTask,
    COLORREF color,
    COLORREF colorHot = (COLORREF)-1);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Aufgabengruppe an, die die Aufgabe enthält.

nTask
[in] Gibt den nullbasierten Index des Vorgangs an.

color
[in] Gibt die Textfarbe für den Vorgang an.

colorHot
[in] Gibt die Textfarbe für die hervorgehobene Gruppe an. Bei -1 verwendet diese Methode die Standardmarkierfarbe.

Rückgabewert

TRUE, wenn die Textfarbe für den Vorgang erfolgreich festgelegt wurde; andernfalls FALSE.

CMFCTasksPane::SetVertMargin

Legt den vertikalen Rand fest.

void SetVertMargin(int n = -1);

Parameter

n
[in] Gibt den festzulegenden vertikalen Rand an.

Hinweise

Der vertikale Rand ist der Abstand zwischen einem Aufgabenbereich und den vertikalen Rändern des Clientbereichs.

Wenn n -1 ist, bestimmt das Framework den Randwert mithilfe des visuellen Managers (CMFCVisualManager::GetTasksPaneVertMargin). Der Standardrand beträgt 12 Pixel.

CMFCTasksPane::SetWindowHeight

Legt die Höhe für ein Fenstersteuerelement fest.

BOOL SetWindowHeight(
    int nGroup,
    HWND hwndTask,
    int nWndHeight);

BOOL SetWindowHeight(
    HWND hwndTask,
    int nWndHeight);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Gruppe an, die das Fenstersteuerelement enthält.

hwndTask
[in] Gibt das Handle für das Fenstersteuerelement an.

nWndHeight
[in] Gibt die festzulegende Höhe an.

Rückgabewert

TRUE, wenn die Höhe des Fenstersteuerelements erfolgreich festgelegt wurde; FALSE, wenn nGroup ungültig ist oder hwndTask nicht vorhanden ist.

Hinweise

Rufen Sie CMFCTasksPane::AddWindow auf, um Aufgaben mit Fenstersteuerelementen hinzuzufügen.

CMFCTasksPane::ShowCommandMessageString

virtual void ShowCommandMessageString(UINT uiCmdId);

Parameter

[in] uiCmdId

Hinweise

CMFCTasksPane::ShowTask

Blendet eine Aufgabe ein oder aus.

BOOL ShowTask(
    int nGroup,
    int nTask,
    BOOL bShow = TRUE,
    BOOL bRedraw = TRUE);

Parameter

nGroup
[in] Gibt den nullbasierten Index der Gruppe an.

nTask
[in] Gibt den nullbasierten Index der Aufgabe an, die ein- oder ausgeblendet werden soll.

bShow
[in] TRUE, um den Vorgang anzuzeigen; FALSE, um die Aufgabe auszublenden.

bRedraw
[in] TRUE, um den Aufgabenbereich neu zu zeichnen; andernfalls FALSE.

Rückgabewert

TRUE, wenn die Aufgabe erfolgreich angezeigt oder ausgeblendet wurde; FALSE, wenn die angegebene Gruppe oder Aufgabe nicht vorhanden ist.

Hinweise

Verwenden Sie CMFCTasksPane::ShowTaskByCmdId , um eine Aufgabe basierend auf ihrer Befehls-ID ein- oder auszublenden.

CMFCTasksPane::ShowTaskByCmdId

Blendet eine Aufgabe basierend auf der Befehls-ID ein oder aus.

BOOL ShowTaskByCmdId(
    UINT uiCommandID,
    BOOL bShow = TRUE,
    BOOL bRedraw = TRUE);

Parameter

uiCommandID
[in] Gibt die Befehls-ID der Aufgabe an, die ein- oder ausgeblendet werden soll.

bShow
[in] TRUE, um den Vorgang anzuzeigen; FALSE, um die Aufgabe auszublenden.

bRedraw
[in] TRUE, um den Aufgabenbereich neu zu zeichnen; andernfalls FALSE.

Rückgabewert

TRUE, wenn die Aufgabe erfolgreich angezeigt oder ausgeblendet wurde; FALSE, wenn eine Aufgabe mit der angegebenen Befehls-ID nicht vorhanden ist.

Hinweise

Verwenden Sie CMFCTasksPane::ShowTask , um eine Aufgabe basierend auf ihrer Befehls-ID ein- oder auszublenden.

CMFCTasksPane::Update

Aktualisiert alle Steuerelemente in einem Aufgabenbereich.

virtual void Update();

Hinweise

Mit dieser Methode wird die Beschriftung des Aufgabenbereichs aktualisiert, die Bildlaufleiste angepasst, alle Aufgaben neu positioniert und alle Aufgabenbereichssteuerelemente neu gezeichnet.

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn das Framework den Aufgabenbereich aktualisiert.

Siehe auch

Hierarchiediagramm
Klassen
CMFCTasksPaneTaskGroup-Klasse
CMFCTasksPaneTask-Klasse
CMFCOutlookBar-Klasse
CMFCVisualManager-Klasse