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).
class CMFCTasksPane : public CDockablePane
| Name | Beschreibung |
|---|---|
| CMFCTasksPane::CMFCTasksPane | Erstellt ein CMFCTasksPane-Objekt. |
| 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. |
| Name | Beschreibung |
|---|---|
| CMFCTasksPane::OnActivateTasksPanePage | Wird vom Framework aufgerufen, wenn eine neue Aufgabenbereichsseite aktiviert wird. |
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:
Betten Sie ein
CMFCTasksPane-Objekt in die Hauptframe-Fensterklasse ein.Rufen Sie bei der Verarbeitung der WM_CREATE Nachricht die
CreateMethode auf. Sie können die regulären CControlBar-Formatvorlagen verwenden. Weitere Informationen finden Sie unterCControlBar::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 jeder Gruppe neue Elemente (Aufgaben) hinzuzufügen.
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:
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();
CObject
└ CCmdTarget
└ CWnd
└ CBasePane
└ CPane
└ CDockablePane
└ CMFCTasksPane
Header: afxTasksPane.h
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);
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.
Der nullbasierte Index der Gruppe in der internen Liste der Gruppen, die die Klasse verwaltet.
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.
Fügt der angegebenen Aufgabengruppe eine Beschriftung hinzu.
int AddLabel(
int nGroup,
LPCTSTR lpszLabelName,
int nTaskIcon = -1,
BOOL bIsBold = FALSE);
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.
Der nullbasierte Index der Gruppe, in der die Bezeichnung hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.
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.
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);
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.
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.
Fügt dem Aufgabenbereich eine Seite hinzu.
int AddPage(LPCTSTR lpszPageLabel);
lpszPageLabel
[in] Gibt die Beschriftung für die Seite an.
Der nullbasierte Index der neuen Seite.
int AddSeparator(int nGroup);
[in] nGroup
Fügt der angegebenen Aufgabengruppe eine Aufgabe hinzu.
int AddTask(
int nGroup,
LPCTSTR lpszTaskName,
int nTaskIcon = -1,
UINT uiCommandID = 0,
DWORD dwUserData = 0);
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.
Der nullbasierte Index der Gruppe, in der die Aufgabe hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.
Fügt dem Aufgabenbereich ein untergeordnetes Fenster hinzu.
int AddWindow(
int nGroup,
HWND hwndTask,
int nWndHeight,
BOOL bAutoDestroyWindow = FALSE,
DWORD dwUserData = 0);
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.
Der nullbasierte Index der Gruppe, in der das Fenster hinzugefügt wurde, oder -1, wenn die durch nGroup angegebene Gruppe nicht vorhanden ist.
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.
Erstellt ein CMFCTasksPane -Objekt.
CMFCTasksPane();
void CollapseAllGroups(BOOL bCollapse = TRUE);
void CollapseAllGroups(
int nPageIdx,
BOOL bCollapse);
[in] bCollapse
[in] nPageIdx
Reduziert oder erweitert eine Gruppe.
BOOL CollapseGroup(
CMFCTasksPaneTaskGroup* pGroup,
BOOL bCollapse = TRUE);
BOOL CollapseGroup(
int nGroup,
BOOL bCollapse = TRUE);
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.
TRUE, wenn die Gruppe erfolgreich reduziert oder erweitert wird; andernfalls FALSE.
Eine reduzierte Gruppe zeigt nur die Gruppenbeschriftung an; die Liste der Aufgaben ausgeblendet ist.
virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);
[in] rectInitial
Erstellt ein Menü, das angezeigt wird, wenn ein Benutzer auf die Menüschaltfläche "Andere Aufgabenbereiche " klickt.
HMENU CreateMenu() const;
Ein Handle zum neuen Menü.
Ü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.
Aktiviert oder deaktiviert die Animation, die auftritt, wenn eine Aufgabengruppe erweitert oder reduziert wird.
void EnableAnimation(BOOL bEnable = TRUE);
bEnable
[in] TRUE, um die Animation zu aktivieren, die auftritt, wenn eine Aufgabengruppe erweitert oder reduziert wird; andernfalls FALSE.
Standardmäßig ist die Animation, die auftritt, wenn eine Aufgabengruppe erweitert oder reduziert wird, aktiviert.
Gibt an, ob ein Benutzer Aufgabengruppen reduzieren kann.
void EnableGroupCollapse(BOOL bEnable);
bEnable
[in] TRUE, wenn Benutzer Aufgabengruppen reduzieren können; andernfalls FALSE.
Eine aufgabengruppe, die reduziert ist, zeigt nur die Gruppenbeschriftung an. die Liste der Aufgaben ausgeblendet ist.
Aktiviert Dropdownmenüs auf den Schaltflächen "Weiter " und "Vorherige Navigation".
void EnableHistoryMenuButtons(BOOL bEnable = TRUE);
bEnable
[in] TRUE, um Dropdownmenüs auf den Schaltflächen "Weiter " und "Vorherige Navigation" zu aktivieren, andernfalls FALSE.
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.
Aktiviert oder deaktiviert die Navigationssymbolleiste.
void EnableNavigationToolbar(
BOOL bEnable = TRUE,
UINT uiToolbarBmpRes = 0,
CSize sizeToolbarImage = CSize(0,
0),
CSize sizeToolbarButton = CSize(0,
0));
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.
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.
void EnableOffsetCustomControls(BOOL bEnable);
[in] bEnable
Aktiviert Bildlaufschaltflächen anstelle einer Bildlaufleiste.
void EnableScrollButtons(BOOL bEnable = TRUE);
bEnable
[in] TRUE, um Bildlaufschaltflächen im Aufgabenbereich anstelle einer Bildlaufleiste anzuzeigen; andernfalls FALSE.
Standardmäßig zeigt das Framework Bildlaufschaltflächen im Aufgabenbereich an.
Aktiviert oder deaktiviert den Textumbruch für den Text in Beschriftungen.
void EnableWrapLabels(BOOL bEnable = TRUE);
bEnable
[in] TRUE, um den Text in Beschriftungen umzuschließen, die im Aufgabenbereich angezeigt werden; andernfalls FALSE.
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.
Aktiviert oder deaktiviert den Textumbruch für den Text in Aufgaben.
void EnableWrapTasks(BOOL bEnable = TRUE);
bEnable
[in] TRUE, um Aufgaben im Aufgabenbereich zu umschließen; andernfalls FALSE.
Standardmäßig ist der Textumbruch für Aufgaben deaktiviert.
Gibt den nullbasierten Index für die aktive Seite zurück.
int GetActivePage() const;
Der nullbasierte Index der aktiven Seite.
Gibt die Höhe der Gruppenbeschriftung zurück.
int GetGroupCaptionHeight() const;
Die Höhe der Gruppenbeschriftung in Pixel.
Gibt den horizontalen Offset einer Gruppenbeschriftung zurück.
int GetGroupCaptionHorzOffset() const;
Der horizontale Offset einer Gruppenbeschriftung. Der horizontale Offset ist der Abstand in Pixel vom linken oder rechten Rand des Aufgabenbereichs.
Gibt den vertikalen Offset einer Gruppenbeschriftung zurück.
int GetGroupCaptionVertOffset() const;
Der vertikale Offset einer Gruppenbeschriftung vom oberen und unteren Rand des Aufgabenbereichs.
Der Standardwert für den vertikalen Offset beträgt 7 Pixel.
Ruft die Gesamtanzahl von Gruppen zurück.
int GetGroupCount() const;
Die Gesamtanzahl der Gruppen im Aufgabenbereich.
Gibt den internen Gruppenindex für die angegebene Gruppe zurück.
BOOL GetGroupLocation(
CMFCTasksPaneTaskGroup* pGroup,
int& nGroup) const;
pGroup
[in] Gibt die Aufgabengruppe an, deren Position abgerufen wird.
nGroup
[out] Enthält den nullbasierten Index der Aufgabengruppe.
TRUE, wenn die Aufgabengruppe gefunden wurde; andernfalls FALSE.
Gibt den vertikalen Offset einer Gruppe zurück.
int GetGroupVertOffset() const;
Der vertikale Offset einer Gruppe in Pixel.
Gibt den horizontalen Abstand zwischen einem Aufgabenbereich und dem Rand des Clientbereichs zurück.
int GetHorzMargin() const;
Der horizontale Abstand zwischen einem Aufgabenbereich und dem Rand des Clientbereichs.
Der Standardabstand zwischen einem Aufgabenbereich und dem Rand des Clientbereichs beträgt 12 Pixel.
void GetNextPages(CStringList& lstNextPages) const;
[in] lstNextPages
Ruft den Seitenindex für eine angegebene Gruppe ab.
BOOL GetPageByGroup(
int nGroup,
int& nPage) const;
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.
TRUE, wenn die Gruppe "nGroup " vorhanden ist; andernfalls FALSE.
Gibt die Anzahl der Seiten zurück.
int GetPagesCount() const;
Die Anzahl der Seiten im Aufgabenbereich.
void GetPreviousPages(CStringList& lstPrevPages) const;
[in] lstPrevPages
virtual CScrollBar* GetScrollBarCtrl(int nBar) const;
[in] nBar
Ruft eine Aufgabe ab.
CMFCTasksPaneTask* GetTask(
int nGroup,
int nTask) const;
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.
Der Vorgang am angegebenen Index.
Gibt die Anzahl der Vorgänge in einer angegebenen Gruppe zurück.
int GetTaskCount(int nGroup) const;
nGroup
[in] Gibt den Index der Aufgabengruppe an.
Die Anzahl der Vorgänge in der angegebenen Gruppe oder 0, wenn nGroup ungültig ist.
Gibt eine Aufgabengruppe für einen angegebenen Gruppenindex zurück.
CMFCTasksPaneTaskGroup* GetTaskGroup(int nGroup) const;
nGroup
[in] Gibt den nullbasierten Index der abzurufenden Gruppe an.
Die Aufgabengruppe am angegebenen Index.
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;
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.
TRUE, wenn der Vorgangsspeicherort gefunden wurde; FALSE, wenn der angegebene Vorgang nicht vorhanden ist.
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.
Gibt den horizontalen Versatz von Vorgängen zurück.
int GetTasksHorzOffset() const;
Der horizontale Offset von Vorgängen vom linken und rechten Rand ihrer übergeordneten Gruppen.
Der standardmäßige horizontale Offset von Vorgängen beträgt 12 Pixel.
int GetTasksIconHorzOffset() const;
int GetTasksIconVertOffset() const;
Gibt den vertikalen Rand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs zurück.
int GetVertMargin() const;
Der vertikale Rand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs.
Der vertikale Rand ist der Abstand zwischen einem Aufgabenbereich und den Rändern des Clientbereichs. Der Standardwert des vertikalen Rands beträgt 12 Pixel.
virtual BOOL IsAccessibilityCompatible();
Gibt an, ob die Animation aktiviert ist.
BOOL IsAnimationEnabled() const;
TRUE, wenn die Animation, die auftritt, wenn ein Benutzer eine Gruppe erweitert oder reduziert, aktiviert ist; andernfalls FALSE.
Rufen Sie CMFCTasksPane::EnableAnimation auf, um animationen zu aktivieren oder zu deaktivieren.
Gibt an, ob die Zurück-Schaltfläche aktiviert ist.
BOOL IsBackButtonEnabled() const;
TRUE, wenn die Zurück-Schaltfläche aktiviert ist; andernfalls FALSE.
Wenn ein Benutzer auf die Schaltfläche "Zurück" klickt, zeigt das Framework die vorherige Aufgabenseite an.
Gibt an, ob die Weiter-Schaltfläche aktiviert ist.
BOOL IsForwardButtonEnabled() const;
TRUE, wenn die Vorwärtsschaltfläche aktiviert ist; andernfalls FALSE.
Die Schaltfläche "Vorwärts" ermöglicht die Vorwärtsnavigation im Verlauf der Aufgabenseiten.
BOOL IsGroupCollapseEnabled() const;
Gibt an, ob die Schaltflächen "Weiter" und "Vorherige Navigation" Dropdownmenüs enthalten.
BOOL IsHistoryMenuButtonsEnabled() const;
TRUE, wenn die Schaltflächen "Weiter" und "Vorherige Navigation" Dropdownmenüs aufweisen; andernfalls FALSE.
Gibt an, ob die Navigationssymbolleiste aktiviert ist.
BOOL IsNavigationToolbarEnabled() const;
TRUE, wenn die Navigationssymbolleiste aktiviert ist; andernfalls FALSE.
virtual BOOL IsToolBox() const;
Gibt an, ob der Aufgabenbereich Wörter in Bezeichnungen umbricht.
BOOL IsWrapLabelsEnabled() const;
TRUE, wenn Wörter in Bezeichnungen umbrochen werden; andernfalls FALSE.
Gibt an, ob das Framework die Aufgabenzeichenfolge umschließt.
BOOL IsWrapTasksEnabled() const;
TRUE, wenn die Vorgangszeichenfolge umbrochen wird; andernfalls FALSE.
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
[in] lpszProfileName
[in] nIndex
[in] uiID
Wird vom Framework aufgerufen, wenn eine Aufgabenbereichsseite aktiv wird.
virtual void OnActivateTasksPanePage();
Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um die Darstellung der Aufgabenbereichseite anzupassen.
virtual void OnCancel();
Wird vom Framework aufgerufen, wenn der Benutzer auf ein Element im Aufgabenbereich klickt.
virtual void OnClickTask(
int nGroupNumber,
int nTaskNumber,
UINT uiCommandID,
DWORD dwUserData);
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.
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.
virtual void OnOK();
Wird vom Framework aufgerufen, wenn der Benutzer auf die Zurück-Schaltfläche klickt.
virtual void OnPressBackButton();
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.
Wird vom Framework aufgerufen, wenn der Benutzer auf die Navigationsschaltfläche Weiter klickt.
virtual void OnPressForwardButton();
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.
Wird vom Framework aufgerufen, wenn der Benutzer auf die Startnavigationsschaltfläche klickt.
virtual void OnPressHomeButton();
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.
virtual void OnPressOtherButton(
CMFCCaptionMenuButton* pbtn,
CWnd* pWndOwner);
[in] Pbtn
[in] pWndOwner
virtual BOOL OnSetAccData(long lVal);
[in] lVal
virtual void OnUpdateCmdUI(
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
[in] pTarget
[in] bDisableIfNoHndler
virtual BOOL PreTranslateMessage(MSG* pMsg);
[in] pMsg
void RecalcLayout(BOOL bRedraw = TRUE);
[in] bRedraw
Entfernt alle Gruppen auf der angegebenen Seite.
void RemoveAllGroups(int nPageIdx = 0);
nPageIdx
[in] Gibt den nullbasierten Index der Seite an.
Entfernt alle Gruppen auf der durch nPageIdx angegebenen Seite oder alle Gruppen, wenn nur eine Standardseite vorhanden ist.
Entfernt alle Seiten aus dem Aufgabenbereich mit Ausnahme der Standardseite (erste).
void RemoveAllPages();
Entfernt alle Vorgänge aus der angegebenen Gruppe.
void RemoveAllTasks(int nGroup);
nGroup
[in] Gibt den nullbasierten Index der Gruppe an.
Entfernt eine Gruppe.
void RemoveGroup(int nGroup);
nGroup
[in] Gibt den nullbasierten Index der zu entfernenden Gruppe an.
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.
Entfernt eine angegebene Seite aus dem Aufgabenbereich.
void RemovePage(int nPageIdx);
nPageIdx
[in] Gibt den nullbasierten Index der zu entfernenden Seite an.
Entfernt eine Aufgabe aus einer Aufgabengruppe.
BOOL RemoveTask(
int nGroup,
int nTask,
BOOL bRedraw = TRUE);
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.
TRUE, wenn die Funktion erfolgreich ist; FALSE, wenn "nGroup " oder "nTask " ungültig ist.
virtual BOOL SaveState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
[in] lpszProfileName
[in] nIndex
[in] uiID
virtual void Serialize(CArchive& ar);
[in] ar
Macht die angegebene Seite im Aufgabenbereich aktiv.
void SetActivePage(int nPageIdx);
nPageIdx
[in] Gibt den nullbasierten Index der anzuzeigenden Seite an.
Diese Methode gibt an, ob die nPageIdx ungültig ist.
Legt den Beschriftungsnamen eines Aufgabenbereichs fest.
void SetCaption(LPCTSTR lpszName);
lpszName
[in] Gibt den Beschriftungsnamen an.
Wenn ein Aufgabenbereich mehrere Seiten enthält, weist die Standardseite die Beschriftung auf, die mithilfe dieser Funktion festgelegt wurde.
Legt die Höhe einer Gruppenbeschriftung fest.
void SetGroupCaptionHeight(int n = -1);
n
[in] Gibt die Höhe der Beschriftung an.
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 beträgt 25 Pixel.
Legt den horizontalen Offset einer Gruppenbeschriftung fest.
void SetGroupCaptionHorzOffset(int n = -1);
n
[in] Gibt den horizontalen Offset der Gruppenbeschriftung an.
Legt den vertikalen Offset einer Gruppenbeschriftung fest.
void SetGroupCaptionVertOffset(int n = -1);
n
[in] Gibt den vertikalen Offset in Pixeln der Gruppenbeschriftung an.
Legt einen Gruppennamen fest.
BOOL SetGroupName(
int nGroup,
LPCTSTR lpszGroupName);
nGroup
[in] Gibt den nullbasierten Index der Gruppe an.
lpszGroupName
[in] Gibt den Namen der Gruppe an.
TRUE, wenn der Gruppenname erfolgreich festgelegt wurde; andernfalls FALSE.
Legt die Textfarbe für eine Gruppenbeschriftung fest.
BOOL SetGroupTextColor(
int nGroup,
COLORREF color,
COLORREF colorHot = (COLORREF)-1);
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.
TRUE, wenn die Gruppentextfarbe erfolgreich geändert wurde; andernfalls FALSE.
Legt den vertikalen Offset für eine Gruppe fest.
void SetGroupVertOffset(int n = -1);
n
[in] Gibt den vertikalen Offset an.
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.
Legt den horizontalen Rand fest.
void SetHorzMargin(int n = -1);
n
[in] Gibt den Rand in Pixel an.
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.
Legt die Bildliste fest.
BOOL SetIconsList(
UINT uiImageListResID,
int cx,
COLORREF clrTransparent = RGB(255, 0, 255));
void SetIconsList(HIMAGELIST hIcons);
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.
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.
Legt den Beschriftungstext für eine Aufgabenbereichsseite fest.
void SetPageCaption(
int nPageIdx,
LPCTSTR lpszName);
nPageIdx
[in] Gibt den nullbasierten Index der Seite an.
lpszName
[in] Gibt den Beschriftungstext an, der auf der Seite angezeigt werden soll.
Wenn ein Aufgabenbereich über mehrere Seiten verfügt, weist die Standardseite die Beschriftung auf, die mithilfe dieser Methode festgelegt wurde.
Legt den Namen für eine Aufgabe fest.
BOOL SetTaskName(
int nGroup,
int nTask,
LPCTSTR lpszTaskName);
nGroup
[in] Gibt den nullbasierten Index der Aufgabengruppe an.
nTask
[in] Gibt den nullbasierten Index des Vorgangs an.
lpszTaskName
[in] Gibt den Aufgabennamen an.
TRUE, wenn der Vorgangsname erfolgreich festgelegt wurde; andernfalls FALSE.
Legt den horizontalen Offset für Vorgänge fest.
void SetTasksHorzOffset(int n = -1);
n
[in] Gibt den horizontalen Offset an.
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.
void SetTasksIconHorzOffset(int n = -1);
[in] n
void SetTasksIconVertOffset(int n = -1);
[in] n
Legt die Textfarbe für eine Aufgabe fest.
BOOL SetTaskTextColor(
int nGroup,
int nTask,
COLORREF color,
COLORREF colorHot = (COLORREF)-1);
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.
TRUE, wenn die Textfarbe für den Vorgang erfolgreich festgelegt wurde; andernfalls FALSE.
Legt den vertikalen Rand fest.
void SetVertMargin(int n = -1);
n
[in] Gibt den festzulegenden vertikalen Rand an.
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.
Legt die Höhe für ein Fenstersteuerelement fest.
BOOL SetWindowHeight(
int nGroup,
HWND hwndTask,
int nWndHeight);
BOOL SetWindowHeight(
HWND hwndTask,
int nWndHeight);
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.
TRUE, wenn die Höhe des Fenstersteuerelements erfolgreich festgelegt wurde; FALSE, wenn nGroup ungültig ist oder hwndTask nicht vorhanden ist.
Rufen Sie CMFCTasksPane::AddWindow auf, um Aufgaben mit Fenstersteuerelementen hinzuzufügen.
virtual void ShowCommandMessageString(UINT uiCmdId);
[in] uiCmdId
Blendet eine Aufgabe ein oder aus.
BOOL ShowTask(
int nGroup,
int nTask,
BOOL bShow = TRUE,
BOOL bRedraw = TRUE);
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.
TRUE, wenn die Aufgabe erfolgreich angezeigt oder ausgeblendet wurde; FALSE, wenn die angegebene Gruppe oder Aufgabe nicht vorhanden ist.
Verwenden Sie CMFCTasksPane::ShowTaskByCmdId , um eine Aufgabe basierend auf ihrer Befehls-ID ein- oder auszublenden.
Blendet eine Aufgabe basierend auf der Befehls-ID ein oder aus.
BOOL ShowTaskByCmdId(
UINT uiCommandID,
BOOL bShow = TRUE,
BOOL bRedraw = TRUE);
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.
TRUE, wenn die Aufgabe erfolgreich angezeigt oder ausgeblendet wurde; FALSE, wenn eine Aufgabe mit der angegebenen Befehls-ID nicht vorhanden ist.
Verwenden Sie CMFCTasksPane::ShowTask , um eine Aufgabe basierend auf ihrer Befehls-ID ein- oder auszublenden.
Aktualisiert alle Steuerelemente in einem Aufgabenbereich.
virtual void Update();
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.
Hierarchiediagramm
Klassen
CMFCTasksPaneTaskGroup-Klasse
CMFCTasksPaneTask-Klasse
CMFCOutlookBar-Klasse
CMFCVisualManager-Klasse