CMFCTasksPane, classe
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
La classe CMFCTasksPane implémente une liste d’éléments interactifs (tâches).
Syntaxe
class CMFCTasksPane : public CDockablePane
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CMFCTasksPane ::CMFCTasksPane | Construit un objet CMFCTasksPane. |
Méthodes publiques
| Nom | Description |
|---|---|
| CMFCTasksPane ::AddGroup | Ajoute un nouveau groupe de tâches au contrôle de volet des tâches. |
| CMFCTasksPane ::AddLabel | Ajoute une nouvelle étiquette statique dans le groupe de tâches spécifié. |
| CMFCTasksPane ::AddMRUFilesList | Ajoute les tâches spécifiées par une liste de fichiers utilisés récemment (MRU) dans un groupe. |
| CMFCTasksPane ::AddPage | Ajoute une nouvelle page au volet des tâches. |
| CMFCTasksPane ::AddSeparator | |
| CMFCTasksPane ::AddTask | Ajoute une nouvelle tâche au groupe de tâches spécifié. |
| CMFCTasksPane ::AddWindow | Ajoute une fenêtre enfant au volet des tâches. |
| CMFCTasksPane ::CollapseAllGroups | |
| CMFCTasksPane ::CollapseGroup | Réduit un groupe par programmation. |
| CMFCTasksPane ::CreateDefaultMiniframe | (Remplacements CPane ::CreateDefaultMiniframe.) |
| CMFCTasksPane ::CreateMenu | Appelé par l’infrastructure pour créer un menu pour le bouton du menu Autres volets tâches. |
| CMFCTasksPane ::EnableAnimation | Active ou désactive l’animation pendant la réduction ou le développement des groupes de tâches. |
| CMFCTasksPane ::EnableGroupCollapse | Spécifie si les groupes de tâches peuvent être réduits. |
| CMFCTasksPane ::EnableHistoryMenuButtons | Active ou désactive les menus déroulants dans les boutons de navigation Suivant et Précédent. |
| CMFCTasksPane ::EnableNavigationToolbar | Active ou désactive la barre d'outils de navigation. |
| CMFCTasksPane ::EnableOffsetCustomControls | |
| CMFCTasksPane ::EnableScrollButtons | Active les boutons de défilement à la place d'une barre de défilement. |
| CMFCTasksPane ::EnableWrapLabels | Active ou désactive le retour automatique à la ligne pour les étiquettes. |
| CMFCTasksPane ::EnableWrapTasks | Active ou désactive le retour automatique à la ligne pour les tâches. |
| CMFCTasksPane ::GetActivePage | Retourne l'index de base zéro pour la page active. |
| CMFCTasksPane ::GetGroupCaptionHeight | Retourne la hauteur des légendes de groupe. |
| CMFCTasksPane ::GetGroupCaptionHorzOffset | Retourne le décalage actuel d’une légende de groupe par rapport aux bords gauche et droit du volet des tâches. |
| CMFCTasksPane ::GetGroupCaptionVertOffset | Retourne le décalage actuel d'une légende de groupe par rapport aux bords supérieur et inférieur du volet des tâches. |
| CMFCTasksPane ::GetGroupCount | Retourne le nombre total de groupes. |
| CMFCTasksPane ::GetGroupLocation | Retourne l'index de groupe interne pour un groupe donné. |
| CMFCTasksPane ::GetGroupVertOffset | Retourne le décalage vertical d'un groupe. |
| CMFCTasksPane ::GetHorzMargin | Retourne l’espacement horizontal entre un volet de tâches et les bords de la zone cliente. |
| CMFCTasksPane ::GetNextPages | |
| CMFCTasksPane ::GetPageByGroup | Récupère l'index de page pour un groupe spécifié. |
| CMFCTasksPane ::GetPagesCount | Retourne le nombre de pages. |
| CMFCTasksPane ::GetPreviousPages | |
| CMFCTasksPane ::GetScrollBarCtrl | (Remplacements CWnd ::GetScrollBarCtrl.) |
| CMFCTasksPane ::GetTask | Récupère une tâche. |
| CMFCTasksPane ::GetTaskCount | Retourne le nombre d'éléments de tâche d'un groupe spécifié. |
| CMFCTasksPane ::GetTaskGroup | Retourne un groupe de tâches pour un index de groupe donné. |
| CMFCTasksPane ::GetTaskLocation | Retourne le groupe et l'index pour une tâche donnée. |
| CMFCTasksPane ::GetTasksHorzOffset | Retourne le décalage horizontal des tâches entre les bords gauche et droit de leurs groupes parents. |
| CMFCTasksPane ::GetTasksIconHorzOffset | |
| CMFCTasksPane ::GetTasksIconVertOffset | |
| CMFCTasksPane ::GetVertMargin | Retourne l'espacement vertical entre un volet de tâches et les bords de la zone cliente. |
| CMFCTasksPane ::IsAccessibilityCompatible | (Substitue CDockablePane::IsAccessibilityCompatible.) |
| CMFCTasksPane ::IsAnimationEnabled | Indique si l'animation est activée. |
| CMFCTasksPane ::IsBackButtonEnabled | Indique si le bouton Précédent est activé. |
| CMFCTasksPane ::IsForwardButtonEnabled | Indique si le bouton Suivant est activé. |
| CMFCTasksPane ::IsGroupCollapseEnabled | |
| CMFCTasksPane ::IsHistoryMenuButtonsEnabled | Indique si les boutons de navigation Suivant et Précédent ont des menus déroulants. |
| CMFCTasksPane ::IsNavigationToolbarEnabled | Indique si la barre d'outils de navigation est activée. |
| CMFCTasksPane ::IsToolBox | |
| CMFCTasksPane ::IsWrapLabelsEnabled | Indique si le volet des tâches effectue un retour automatique à la ligne dans les étiquettes. |
| CMFCTasksPane ::IsWrapTasksEnabled | Indique si le volet des tâches effectue un retour automatique à la ligne dans les tâches. |
| CMFCTasksPane ::LoadState | (Remplacements CDockablePane ::LoadState.) |
| CMFCTasksPane ::OnCancel | |
| CMFCTasksPane ::OnClickTask | Appelé par l’infrastructure quand l’utilisateur clique sur un élément dans le volet des tâches. |
| CMFCTasksPane ::OnOK | |
| CMFCTasksPane ::OnPressBackButton | Appelé par l'infrastructure quand l'utilisateur clique sur le bouton Précédent. |
| CMFCTasksPane ::OnPressForwardButton | Appelé par l'infrastructure quand l'utilisateur clique sur le bouton de navigation Suivant. |
| CMFCTasksPane ::OnPressHomeButton | Appelé par l'infrastructure quand l'utilisateur clique sur le bouton de navigation Accueil. |
| CMFCTasksPane ::OnPressOtherButton | |
| CMFCTasksPane ::OnSetAccData | (Remplacements CBasePane ::OnSetAccData.) |
| CMFCTasksPane ::OnUpdateCmdUI | (Remplacements CDockablePane ::OnUpdateCmdUI.) |
| CMFCTasksPane ::P reTranslateMessage | (Remplacements CDockablePane ::P reTranslateMessage.) |
| CMFCTasksPane ::RecalcLayout | (Remplacements CPane ::RecalcLayout.) |
| CMFCTasksPane ::RemoveAllGroups | Supprime tous les groupes sur la page spécifiée. |
| CMFCTasksPane ::RemoveAllPages | Supprime toutes les pages du volet des tâches à l'exception de la (première) page par défaut. |
| CMFCTasksPane ::RemoveAllTasks | Supprime toutes les tâches du groupe. |
| CMFCTasksPane ::RemoveGroup | Supprime un groupe. |
| CMFCTasksPane ::RemovePage | Supprime une page spécifiée du volet des tâches. |
| CMFCTasksPane ::RemoveTask | Supprime une tâche d’un groupe de tâches. |
| CMFCTasksPane ::SaveState | (Remplacements CDockablePane ::SaveState.) |
| CMFCTasksPane ::Serialize | (Remplacements CDockablePane ::Serialize.) |
| CMFCTasksPane ::SetActivePage | Active une page spécifiée dans le volet des tâches. |
| CMFCTasksPane ::SetCaption | Définit le nom de légende d'un volet de tâches. |
| CMFCTasksPane ::SetGroupCaptionHeight | Définit la hauteur d'une légende de groupe. |
| CMFCTasksPane ::SetGroupCaptionHorzOffset | Définit le décalage horizontal d'une légende de groupe. |
| CMFCTasksPane ::SetGroupCaptionVertOffset | Définit le décalage vertical d'une légende de groupe. |
| CMFCTasksPane ::SetGroupName | Définit un nom de groupe. |
| CMFCTasksPane ::SetGroupTextColor | Définit la couleur du texte d'une légende de groupe. |
| CMFCTasksPane ::SetGroupVertOffset | Définit le décalage vertical pour un groupe. |
| CMFCTasksPane ::SetHorzMargin | Définit l’espacement horizontal entre un volet de tâches et les bords de la zone cliente. |
| CMFCTasksPane ::SetIconsList | Définit la liste d’images associée aux tâches. |
| CMFCTasksPane ::SetPageCaption | Définit le texte de légende d’une page de volet de tâches. |
| CMFCTasksPane ::SetTaskName | Définit le nom d'une tâche. |
| CMFCTasksPane ::SetTasksIconHorzOffset | |
| CMFCTasksPane ::SetTasksIconVertOffset | |
| CMFCTasksPane ::SetTaskTextColor | Définit la couleur du texte d'une tâche. |
| CMFCTasksPane ::SetTasksHorzOffset | Définit le décalage horizontal des tâches entre les bords gauche et droit de leurs groupes parents. |
| CMFCTasksPane ::SetVertMargin | Définit l’espacement vertical entre un volet de tâches et les bords de la zone cliente. |
| CMFCTasksPane ::SetWindowHeight | Définit la hauteur d'une fenêtre. |
| CMFCTasksPane ::ShowCommandMessageString | |
| CMFCTasksPane ::ShowTask | Affiche ou masque une tâche. |
| CMFCTasksPane ::ShowTaskByCmdId | Affiche ou masque une tâche en fonction de son ID de commande. |
| CMFCTasksPane ::Update | Met à jour les éléments d'interface utilisateur graphique qui appartiennent à un volet de tâches. |
Méthodes protégées
| Nom | Description |
|---|---|
| CMFCTasksPane ::OnActivateTasksPanePage | Appelé par l’infrastructure quand une nouvelle page de volet de tâches est activée. |
Notes
La classe CMFCTasksPane implémente les fonctionnalités suivantes :
Les éléments peuvent être regroupés et chaque regroupement d'éléments peut être associé à une légende.
Les regroupements d'éléments peuvent être réduits ou développés.
Une icône peut être affectée à chaque élément du volet des tâches.
Un élément individuel peut être associé à un ID de commande qui s'exécute quand un utilisateur clique sur l'élément. Lorsque le clic se produit, le message WM_COMMAND est envoyé au propriétaire du contrôle du volet Office.
Pour utiliser le contrôle CMFCTasksPane dans votre application, procédez comme suit :
Incorporez un objet
CMFCTasksPanedans la classe de fenêtre frame principale.Lors du traitement du message WM_CREATE, appelez la
Createméthode. Vous pouvez utiliser les styles CControlBar standard. Pour plus d’informations, consultezCControlBar::Create.Appelez la méthode CMFCTasksPane ::AddGroup pour ajouter différents groupes.
Appelez les fonctions membres CMFCTasksPane ::AddTasksPane, CMFCTasksPane ::AddLabel ou CMFCTasksPane ::AddMRUFilesList pour ajouter de nouveaux éléments (tâches) à chaque groupe.
Appelez CMFCTasksPane ::EnableGroupCollapse pour spécifier si les groupes d’éléments peuvent être réduits.
L’illustration suivante représente un contrôle de volet de tâches standard. Le premier groupe est un groupe spécial et son légende est une couleur plus foncée. Le troisième groupe est réduit. Le dernier groupe est aligné au bas du volet des tâches et n’a pas de légende ; la dernière tâche du groupe est une simple étiquette :
Vous pouvez personnaliser l’apparence du volet des tâches en ajustant les marges et les décalages. L'illustration suivante permet de mieux comprendre la fonction de ces variables :
Exemple
L'exemple suivant montre comment construire un objet CMFCTasksPane et utiliser différentes méthodes de la classe CMFCTasksPane. L’exemple montre comment activer la réduction des groupes de tâches, activer les menus déroulants sur les boutons de navigation Suivant et Précédent, activer les boutons de défilement au lieu d’une barre de défilement, activer l’habillage de mots pour le texte dans les étiquettes, définir le nom légende du volet Office, définir la couleur de texte d’un groupe légende et définir les marges horizontales et verticales.
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();
Hiérarchie d'héritage
CObject
└ CCmdTarget
└ CWnd
└ CBasePane
└ CPane
└ CDockablePane
└ CMFCTasksPane
Spécifications
En-tête : afxTasksPane.h
CMFCTasksPane ::AddGroup
Ajoute un nouveau groupe de tâches au contrôle de volet des tâches.
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);
Paramètres
nPageIdx
[in] Spécifie l’index de page de base zéro.
lpszGroupName
[in] Spécifie le nom du groupe.
bBottomLocation
[in] TRUE pour créer le groupe en bas du contrôle du volet Office ; sinon, FALSE.
bSpecial
[in] TRUE pour marquer ce groupe en tant que groupe spécial ; sinon, FALSE. Pour plus d’informations sur les groupes spéciaux, consultez la section Remarques de CMFCTasksPane.
hIcon
[in] Spécifie l’icône à afficher dans le groupe légende.
Valeur de retour
Index de base zéro du groupe dans la liste interne des groupes que la classe gère.
Notes
Appelez cette méthode pour créer un groupe de tâches et ajouter ce groupe au contrôle du volet Office.
L’infrastructure affiche les groupes de tâches en haut du contrôle du volet Office ou en bas. L’infrastructure ne peut afficher qu’un seul groupe en bas ; ce groupe doit être ajouté en dernier.
CMFCTasksPane ::AddLabel
Ajoute une étiquette au groupe de tâches spécifié.
int AddLabel(
int nGroup,
LPCTSTR lpszLabelName,
int nTaskIcon = -1,
BOOL bIsBold = FALSE);
Paramètres
nGroup
[in] Spécifie l’index du groupe dans lequel l’étiquette est ajoutée.
lpszLabelName
[in] Spécifie le nom de l’étiquette.
nTaskIcon
[in] Spécifie l’icône à afficher en regard de l’étiquette. Le framework stocke les icônes dans une liste d’images. Ce paramètre est un index dans cette liste.
bIsBold
[in] TRUE pour afficher l’étiquette en gras ; sinon, FALSE.
Valeur de retour
Index de base zéro du groupe où l’étiquette a été ajoutée, ou -1 si le groupe spécifié par nGroup n’existe pas.
Notes
L’infrastructure gère les tâches et les étiquettes différemment. Lorsqu’un utilisateur clique sur une tâche, l’infrastructure exécute une commande. Lorsqu’un utilisateur clique sur une étiquette, aucune commande n’est exécutée. Pour plus d’informations, consultez CMFCTasksPane ::AddTask.
CMFCTasksPane ::AddMRUFilesList
Ajoute une tâche pour chaque fichier stocké dans une liste de fichiers les plus récemment utilisés (MRU) dans un groupe.
int AddMRUFilesList(
int nGroup,
int nMaxFiles = 4);
Paramètres
nGroup
[in] Spécifie l’index d’un groupe. Cette méthode ajoute la liste des fichiers MRU au groupe spécifié par ce paramètre.
nMaxFiles
[in] Spécifie le nombre de fichiers à afficher dans la liste des fichiers MRU.
Valeur de retour
Index de base zéro du groupe dans lequel la liste des fichiers MRU a été ajoutée, ou -1 si le groupe spécifié par nGroup n’existe pas.
CMFCTasksPane ::AddPage
Ajoute une page au volet Office.
int AddPage(LPCTSTR lpszPageLabel);
Paramètres
lpszPageLabel
[in] Spécifie l’étiquette de la page.
Valeur de retour
Index de base zéro de la nouvelle page.
CMFCTasksPane ::AddSeparator
int AddSeparator(int nGroup);
Paramètres
[in] nGroup
Valeur de retour
Notes
CMFCTasksPane ::AddTask
Ajoute une tâche au groupe de tâches spécifié.
int AddTask(
int nGroup,
LPCTSTR lpszTaskName,
int nTaskIcon = -1,
UINT uiCommandID = 0,
DWORD dwUserData = 0);
Paramètres
nGroup
[in] Spécifie l’index de groupe dans lequel la tâche est ajoutée.
lpszTaskName
[in] Spécifie le nom de la tâche.
nTaskIcon
[in] Spécifie l’icône à afficher en regard de la tâche. Le framework stocke les icônes dans une liste d’images. Ce paramètre est un index dans cette liste.
uiCommandID
[in] Spécifie l’ID de commande de la commande à exécuter lorsque l’utilisateur clique sur la tâche. La tâche est traitée comme une étiquette si uiCommandID est 0.
dwUserData
[in] Spécifie les données définies par l’utilisateur à associer à la tâche.
Valeur de retour
Index de base zéro du groupe où la tâche a été ajoutée, ou -1 si le groupe spécifié par nGroup n’existe pas.
CMFCTasksPane ::AddWindow
Ajoute une fenêtre enfant au volet des tâches.
int AddWindow(
int nGroup,
HWND hwndTask,
int nWndHeight,
BOOL bAutoDestroyWindow = FALSE,
DWORD dwUserData = 0);
Paramètres
nGroup
[in] Spécifie l’index de groupe dans lequel la fenêtre est ajoutée.
hwndTask
[in] Spécifie le handle de la fenêtre à ajouter.
nWndHeight
[in] Spécifie la hauteur de la fenêtre.
bAutoDestroyWindow
[in] TRUE pour détruire la fenêtre lorsque la tâche est supprimée ; sinon, FALSE.
dwUserData
[in] Spécifie les données définies par l’utilisateur associées à la tâche.
Valeur de retour
Index de base zéro du groupe où la fenêtre a été ajoutée, ou -1 si le groupe spécifié par nGroup n’existe pas.
Notes
Appelez cette méthode pour ajouter un contrôle à un volet Office. Par exemple, vous pouvez ajouter un contrôle d’édition qui fonctionne comme une barre de recherche.
CMFCTasksPane ::CMFCTasksPane
Construit un objet CMFCTasksPane .
CMFCTasksPane();
CMFCTasksPane ::CollapseAllGroups
void CollapseAllGroups(BOOL bCollapse = TRUE);
void CollapseAllGroups(
int nPageIdx,
BOOL bCollapse);
Paramètres
[in] bCollapse
[in] nPageIdx
Notes
CMFCTasksPane ::CollapseGroup
Réduit ou développe un groupe.
BOOL CollapseGroup(
CMFCTasksPaneTaskGroup* pGroup,
BOOL bCollapse = TRUE);
BOOL CollapseGroup(
int nGroup,
BOOL bCollapse = TRUE);
Paramètres
pGroup
[in] Spécifie le groupe à réduire.
bCollapse
[in] TRUE pour réduire le groupe ; FALSE pour développer le groupe.
nGroup
[in] Spécifie l’index de base zéro du groupe à réduire dans la liste interne des groupes.
Valeur de retour
TRUE si le groupe se réduit ou se développe correctement ; sinon, FALSE.
Notes
Un groupe réduit affiche uniquement le groupe légende ; la liste des tâches est masquée.
CMFCTasksPane ::CreateDefaultMiniframe
virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);
Paramètres
[in] rectInitial
Valeur de retour
Notes
CMFCTasksPane ::CreateMenu
Crée un menu qui s’affiche lorsqu’un utilisateur clique sur le bouton du menu Autres volets tâches.
HMENU CreateMenu() const;
Valeur de retour
Handle du nouveau menu.
Notes
Remplacez cette méthode dans une classe dérivée pour personnaliser le menu d’un volet Office.
Le menu contextuel créé par cette méthode contient la liste des pages dans le volet Office. Le menu affiche une marque case activée en regard de la page active.
CMFCTasksPane ::EnableAnimation
Active ou désactive l’animation qui se produit lorsqu’un groupe de tâches se développe ou se réduit.
void EnableAnimation(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] TRUE pour activer l’animation qui se produit lorsqu’un groupe de tâches se développe ou se réduit ; sinon, FALSE.
Notes
Par défaut, l’animation qui se produit lorsqu’un groupe de tâches développe ou réduit est activée.
CMFCTasksPane ::EnableGroupCollapse
Spécifie si un utilisateur peut réduire les groupes de tâches.
void EnableGroupCollapse(BOOL bEnable);
Paramètres
bEnable
[in] TRUE si les utilisateurs peuvent réduire les groupes de tâches ; sinon, FALSE.
Notes
Un groupe de tâches réduit affiche uniquement le groupe légende ; la liste des tâches est masquée.
CMFCTasksPane ::EnableHistoryMenuButtons
Active les menus déroulants sur les boutons de navigation Suivant et Précédent.
void EnableHistoryMenuButtons(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] TRUE pour activer les menus déroulants sur les boutons de navigation Suivant et Précédent ; sinon, FALSE.
Notes
Par défaut, les menus déroulants des boutons Suivant et Précédent sont désactivés.
Les menus contiennent l’historique des pages de tâches utilisées par l’utilisateur.
CMFCTasksPane ::EnableNavigationToolbar
Active ou désactive la barre d'outils de navigation.
void EnableNavigationToolbar(
BOOL bEnable = TRUE,
UINT uiToolbarBmpRes = 0,
CSize sizeToolbarImage = CSize(0,
0),
CSize sizeToolbarButton = CSize(0,
0));
Paramètres
bEnable
[in] TRUE pour activer la barre d’outils de navigation ; sinon, FALSE.
uiToolbarBmpRes
[in] Spécifie l’ID de ressource de la bitmap qui contient les images à afficher dans la barre d’outils.
sizeToolbarImage
[in] Spécifie la taille d’une image de barre d’outils.
sizeToolbarButton
[in] Spécifie la taille d’un bouton de barre d’outils.
Notes
La barre d’outils de navigation est une barre d’outils que l’infrastructure affiche en haut du volet Office. La barre d’outils de navigation contient les boutons de navigation Précédent, Avant et Accueil et un bouton de menu qui contient la liste des pages disponibles.
Par défaut, l’infrastructure n’affiche pas la barre d’outils de navigation. Si la barre d’outils de navigation n’est pas affichée, les boutons de navigation se trouvent sur la légende de la barre d’ancrage.
CMFCTasksPane ::EnableOffsetCustomControls
void EnableOffsetCustomControls(BOOL bEnable);
Paramètres
[in] bEnable
Notes
CMFCTasksPane ::EnableScrollButtons
Active les boutons de défilement au lieu d’une barre de défilement.
void EnableScrollButtons(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] TRUE pour afficher les boutons de défilement dans le volet Office au lieu d’une barre de défilement ; sinon, FALSE.
Notes
Par défaut, l’infrastructure affiche les boutons de défilement dans le volet Office.
CMFCTasksPane ::EnableWrapLabels
Active ou désactive l’habillage de mots pour le texte dans les étiquettes.
void EnableWrapLabels(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] TRUE pour encapsuler le texte dans les étiquettes qui s’affichent dans le volet Office ; sinon, FALSE.
Notes
Par défaut, l’infrastructure n’encapsule pas le texte dans les étiquettes. Lorsque l’habillage de mots est activé, le texte dans les étiquettes peut apparaître dans plusieurs lignes. L’étiquette peut inclure des marqueurs de rupture de trait tels que \n et le marqueur &de soulignement.
CMFCTasksPane ::EnableWrapTasks
Active ou désactive l’habillage de mots pour le texte dans les tâches.
void EnableWrapTasks(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] TRUE pour encapsuler les tâches dans le volet Office ; sinon, FALSE.
Notes
Par défaut, l’habillage de mots pour les tâches est désactivé.
CMFCTasksPane ::GetActivePage
Retourne l'index de base zéro pour la page active.
int GetActivePage() const;
Valeur de retour
Index de base zéro de la page active.
CMFCTasksPane ::GetGroupCaptionHeight
Retourne la hauteur du groupe légende.
int GetGroupCaptionHeight() const;
Valeur de retour
Hauteur du groupe légende, en pixels.
CMFCTasksPane ::GetGroupCaptionHorzOffset
Retourne le décalage horizontal d’un groupe légende.
int GetGroupCaptionHorzOffset() const;
Valeur de retour
Décalage horizontal d’un groupe légende. Le décalage horizontal est la distance en pixels du bord gauche ou droit du volet Office.
CMFCTasksPane ::GetGroupCaptionVertOffset
Retourne le décalage vertical d’un groupe légende.
int GetGroupCaptionVertOffset() const;
Valeur de retour
Décalage vertical d’un groupe légende à partir des bords supérieur et inférieur du volet Office.
Notes
La valeur par défaut du décalage vertical est de 7 pixels.
CMFCTasksPane ::GetGroupCount
Retourne le nombre total de groupes.
int GetGroupCount() const;
Valeur de retour
Nombre total de groupes dans le volet Office.
CMFCTasksPane ::GetGroupLocation
Retourne l’index de groupe interne du groupe spécifié.
BOOL GetGroupLocation(
CMFCTasksPaneTaskGroup* pGroup,
int& nGroup) const;
Paramètres
pGroup
[in] Spécifie le groupe de tâches dont l’emplacement est récupéré.
nGroup
[out] Contient l’index de base zéro du groupe de tâches.
Valeur de retour
TRUE si le groupe de tâches a été trouvé ; sinon, FALSE.
CMFCTasksPane ::GetGroupVertOffset
Retourne le décalage vertical d'un groupe.
int GetGroupVertOffset() const;
Valeur de retour
Décalage vertical d’un groupe, en pixels.
CMFCTasksPane ::GetHorzMargin
Retourne l’espacement horizontal entre un volet Office et le bord de la zone cliente.
int GetHorzMargin() const;
Valeur de retour
Espacement horizontal entre un volet Office et le bord de la zone cliente.
Notes
L’espacement par défaut entre un volet Office et le bord de la zone cliente est de 12 pixels.
CMFCTasksPane ::GetNextPages
void GetNextPages(CStringList& lstNextPages) const;
Paramètres
[in] lstNextPages
Notes
CMFCTasksPane ::GetPageByGroup
Récupère l'index de page pour un groupe spécifié.
BOOL GetPageByGroup(
int nGroup,
int& nPage) const;
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe de tâches.
nPage
[out] Contient l’index de page du groupe spécifié. Si le groupe de tâches contient uniquement une page par défaut, la valeur retournée est 0.
Valeur de retour
TRUE si le groupe nGroup existe ; sinon, FALSE.
CMFCTasksPane ::GetPagesCount
Retourne le nombre de pages.
int GetPagesCount() const;
Valeur de retour
Nombre de pages dans le volet Office.
CMFCTasksPane ::GetPreviousPages
void GetPreviousPages(CStringList& lstPrevPages) const;
Paramètres
[in] lstPrevPages
Notes
CMFCTasksPane ::GetScrollBarCtrl
virtual CScrollBar* GetScrollBarCtrl(int nBar) const;
Paramètres
[in] nBar
Valeur de retour
Notes
CMFCTasksPane ::GetTask
Récupère une tâche.
CMFCTasksPaneTask* GetTask(
int nGroup,
int nTask) const;
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe qui contient la tâche.
nTask
[in] Spécifie l’index de base zéro de la tâche dans la liste spécifiée par nGroup.
Valeur de retour
Tâche à l’index spécifié.
CMFCTasksPane ::GetTaskCount
Retourne le nombre de tâches dans un groupe spécifié.
int GetTaskCount(int nGroup) const;
Paramètres
nGroup
[in] Spécifie l’index du groupe de tâches.
Valeur de retour
Nombre de tâches dans le groupe spécifié ou 0 si nGroup n’est pas valide.
CMFCTasksPane ::GetTaskGroup
Retourne un groupe de tâches pour un index de groupe spécifié.
CMFCTasksPaneTaskGroup* GetTaskGroup(int nGroup) const;
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe à récupérer.
Valeur de retour
Groupe de tâches à l’index spécifié.
CMFCTasksPane ::GetTaskLocation
Retourne le groupe et l’index d’une tâche spécifiée.
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;
Paramètres
uiCommandID
[in] Spécifie l’ID de commande de la tâche à rechercher.
nGroup
[out] Contient l’index de groupe de la tâche.
nTask
[out] Contient l’index de la tâche dans le groupe de tâches.
hwndTask
[in] Spécifie la fenêtre associée à la tâche.
pTask
[in] Spécifie la tâche à rechercher.
Valeur de retour
TRUE si l’emplacement de la tâche a été trouvé ; FALSE si la tâche spécifiée n’existe pas.
Notes
Cette méthode récupère l’index de groupe et l’index de tâche pour la tâche spécifiée. Si la méthode retourne FALSE, nGroup et nTask sont définis sur -1.
CMFCTasksPane ::GetTasksHorzOffset
Retourne le décalage horizontal des tâches.
int GetTasksHorzOffset() const;
Valeur de retour
Décalage horizontal des tâches des bords gauche et droit de leurs groupes parents.
Notes
Le décalage horizontal par défaut des tâches est de 12 pixels.
CMFCTasksPane ::GetTasksIconHorzOffset
int GetTasksIconHorzOffset() const;
Valeur de retour
Notes
CMFCTasksPane ::GetTasksIconVertOffset
int GetTasksIconVertOffset() const;
Valeur de retour
Notes
CMFCTasksPane ::GetVertMargin
Retourne la marge verticale entre un volet Office et les bords de la zone cliente.
int GetVertMargin() const;
Valeur de retour
Marge verticale entre un volet Office et les bords de la zone cliente.
Notes
La marge verticale est l’espace entre un volet Office et les bords de la zone cliente. La valeur par défaut de la marge verticale est de 12 pixels.
CMFCTasksPane ::IsAccessibilityCompatible
virtual BOOL IsAccessibilityCompatible();
Valeur de retour
Notes
CMFCTasksPane ::IsAnimationEnabled
Indique si l'animation est activée.
BOOL IsAnimationEnabled() const;
Valeur de retour
TRUE si l’animation qui se produit lorsqu’un utilisateur développe ou réduit un groupe est activée ; sinon, FALSE.
Notes
Appelez CMFCTasksPane ::EnableAnimation pour activer ou désactiver l’animation.
CMFCTasksPane ::IsBackButtonEnabled
Indique si le bouton Précédent est activé.
BOOL IsBackButtonEnabled() const;
Valeur de retour
TRUE si le bouton Précédent est activé ; sinon, FALSE.
Notes
Lorsqu’un utilisateur clique sur le bouton Précédent, l’infrastructure affiche la page de tâches précédente.
CMFCTasksPane ::IsForwardButtonEnabled
Indique si le bouton Suivant est activé.
BOOL IsForwardButtonEnabled() const;
Valeur de retour
TRUE si le bouton transférer est activé ; sinon, FALSE.
Notes
Le bouton Transférer active la navigation vers l’avant dans l’historique des pages de tâches.
CMFCTasksPane ::IsGroupCollapseEnabled
BOOL IsGroupCollapseEnabled() const;
Valeur de retour
Notes
CMFCTasksPane ::IsHistoryMenuButtonsEnabled
Indique si les boutons de navigation Suivant et Précédent ont des menus déroulants.
BOOL IsHistoryMenuButtonsEnabled() const;
Valeur de retour
TRUE si les boutons de navigation Suivant et Précédent ont des menus déroulants ; sinon, FALSE.
CMFCTasksPane ::IsNavigationToolbarEnabled
Indique si la barre d'outils de navigation est activée.
BOOL IsNavigationToolbarEnabled() const;
Valeur de retour
TRUE si la barre d’outils de navigation est activée ; sinon, FALSE.
CMFCTasksPane ::IsToolBox
virtual BOOL IsToolBox() const;
Valeur de retour
Notes
CMFCTasksPane ::IsWrapLabelsEnabled
Indique si le volet des tâches effectue un retour automatique à la ligne dans les étiquettes.
BOOL IsWrapLabelsEnabled() const;
Valeur de retour
TRUE si les mots dans les étiquettes sont encapsulés ; sinon, FALSE.
CMFCTasksPane ::IsWrapTasksEnabled
Spécifie si l’infrastructure encapsule la chaîne de tâche.
BOOL IsWrapTasksEnabled() const;
Valeur de retour
TRUE si la chaîne de tâche est encapsulée ; sinon, FALSE.
CMFCTasksPane ::LoadState
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
Paramètres
[in] lpszProfileName
[in] nIndex
[in] uiID
Valeur de retour
Notes
CMFCTasksPane ::OnActivateTasksPanePage
Appelé par l’infrastructure lorsqu’il active une page du volet Office.
virtual void OnActivateTasksPanePage();
Notes
Remplacez cette méthode dans une classe dérivée pour personnaliser l’apparence de la page du volet Office.
CMFCTasksPane ::OnCancel
virtual void OnCancel();
Notes
CMFCTasksPane ::OnClickTask
Appelé par l’infrastructure quand l’utilisateur clique sur un élément dans le volet des tâches.
virtual void OnClickTask(
int nGroupNumber,
int nTaskNumber,
UINT uiCommandID,
DWORD dwUserData);
Paramètres
nGroupNumber
[in] Spécifie l’index de base zéro du groupe qui contient la tâche en cliquant.
nTaskNumber
[in] Spécifie l’index de base zéro de la tâche cliquée.
uiCommandID
[in] Spécifie l’ID de commande associé à la tâche.
dwUserData
[in] Contient des données définies par l’utilisateur associées à la tâche en cliquant.
Notes
L’infrastructure appelle cette méthode lorsqu’un utilisateur clique sur une tâche. Par défaut, l’infrastructure case activée l’ID de commande associé à la tâche en cliquant et, s’il n’est pas égal à zéro, envoie le message WM_COMMAND au propriétaire du contrôle du volet Office.
Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsqu’une tâche est cliquée.
CMFCTasksPane ::OnOK
virtual void OnOK();
Notes
CMFCTasksPane ::OnPressBackButton
Appelé par l'infrastructure quand l'utilisateur clique sur le bouton Précédent.
virtual void OnPressBackButton();
Notes
Par défaut, l’infrastructure affiche la page précédemment affichée.
Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’utilisateur clique sur le bouton Précédent.
CMFCTasksPane ::OnPressForwardButton
Appelé par l'infrastructure quand l'utilisateur clique sur le bouton de navigation Suivant.
virtual void OnPressForwardButton();
Notes
Par défaut, l’infrastructure affiche la page affichée par l’utilisateur avant de cliquer sur le bouton Précédent .
Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’utilisateur clique sur le bouton Transférer.
CMFCTasksPane ::OnPressHomeButton
Appelé par l’infrastructure lorsque l’utilisateur clique sur le bouton de navigation d’accueil.
virtual void OnPressHomeButton();
Notes
Par défaut, l’infrastructure affiche la page par défaut du groupe de tâches.
Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’utilisateur clique sur le bouton de navigation d’accueil.
CMFCTasksPane ::OnPressOtherButton
virtual void OnPressOtherButton(
CMFCCaptionMenuButton* pbtn,
CWnd* pWndOwner);
Paramètres
[in] pbtn
[in] pWndOwner
Notes
CMFCTasksPane ::OnSetAccData
virtual BOOL OnSetAccData(long lVal);
Paramètres
[in] lVal
Valeur de retour
Notes
CMFCTasksPane ::OnUpdateCmdUI
virtual void OnUpdateCmdUI(
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
Paramètres
[in] pTarget
[in] bDisableIfNoHndler
Notes
CMFCTasksPane ::P reTranslateMessage
virtual BOOL PreTranslateMessage(MSG* pMsg);
Paramètres
[in] pMsg
Valeur de retour
Notes
CMFCTasksPane ::RecalcLayout
void RecalcLayout(BOOL bRedraw = TRUE);
Paramètres
[in] bRedraw
Notes
CMFCTasksPane ::RemoveAllGroups
Supprime tous les groupes sur la page spécifiée.
void RemoveAllGroups(int nPageIdx = 0);
Paramètres
nPageIdx
[in] Spécifie l’index de base zéro de la page.
Notes
Supprime tous les groupes de la page spécifiée par nPageIdx ou tous les groupes s’il n’existe qu’une page par défaut.
CMFCTasksPane ::RemoveAllPages
Supprime toutes les pages du volet des tâches à l'exception de la (première) page par défaut.
void RemoveAllPages();
CMFCTasksPane ::RemoveAllTasks
Supprime toutes les tâches du groupe spécifié.
void RemoveAllTasks(int nGroup);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe.
CMFCTasksPane ::RemoveGroup
Supprime un groupe.
void RemoveGroup(int nGroup);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe à supprimer.
Notes
Cette méthode supprime un seul groupe. Pour supprimer tous les groupes, appelez CMFCTasksPane ::RemoveAllGroups à la place.
Lorsque l’infrastructure supprime un groupe, toutes les tâches et fenêtres utilisateur associées sont détruites.
CMFCTasksPane ::RemovePage
Supprime une page spécifiée du volet des tâches.
void RemovePage(int nPageIdx);
Paramètres
nPageIdx
[in] Spécifie l’index de base zéro de la page à supprimer.
CMFCTasksPane ::RemoveTask
Supprime une tâche d’un groupe de tâches.
BOOL RemoveTask(
int nGroup,
int nTask,
BOOL bRedraw = TRUE);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe de tâches qui contient la tâche à supprimer.
nTask
[in] Spécifie l’index de base zéro de la tâche à supprimer.
bRedraw
[in] TRUE pour redessiner le volet Office ; sinon, FALSE.
Valeur de retour
TRUE si la fonction réussit ; FALSE si nGroup ou nTask n’est pas valide.
CMFCTasksPane ::SaveState
virtual BOOL SaveState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
Paramètres
[in] lpszProfileName
[in] nIndex
[in] uiID
Valeur de retour
Notes
CMFCTasksPane ::Serialize
virtual void Serialize(CArchive& ar);
Paramètres
[in] Ar
Notes
CMFCTasksPane ::SetActivePage
Rend la page spécifiée dans le volet Office active.
void SetActivePage(int nPageIdx);
Paramètres
nPageIdx
[in] Spécifie l’index de base zéro de la page à afficher.
Notes
Cette méthode affirme si nPageIdx n’est pas valide.
CMFCTasksPane ::SetCaption
Définit le nom de légende d'un volet de tâches.
void SetCaption(LPCTSTR lpszName);
Paramètres
lpszName
[in] Spécifie le nom légende.
Notes
Si un volet Office comporte plusieurs pages, la page par défaut a la légende définie à l’aide de cette fonction.
CMFCTasksPane ::SetGroupCaptionHeight
Définit la hauteur d'une légende de groupe.
void SetGroupCaptionHeight(int n = -1);
Paramètres
n
[in] Spécifie la hauteur légende.
Notes
Appelez cette méthode pour personnaliser les marges des éléments du volet Office.
Si n est -1, l’infrastructure détermine la valeur de marge à l’aide du gestionnaire visuel ( CMFCVisualManager::GetTasksPaneGroupCaptionHeight). La hauteur de légende par défaut est de 25 pixels.
CMFCTasksPane ::SetGroupCaptionHorzOffset
Définit le décalage horizontal d'une légende de groupe.
void SetGroupCaptionHorzOffset(int n = -1);
Paramètres
n
[in] Spécifie le décalage horizontal du groupe légende.
CMFCTasksPane ::SetGroupCaptionVertOffset
Définit le décalage vertical d'une légende de groupe.
void SetGroupCaptionVertOffset(int n = -1);
Paramètres
n
[in] Spécifie le décalage vertical, en pixels, du groupe légende.
CMFCTasksPane ::SetGroupName
Définit un nom de groupe.
BOOL SetGroupName(
int nGroup,
LPCTSTR lpszGroupName);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe.
lpszGroupName
[in] Spécifie le nom du groupe.
Valeur de retour
TRUE si le nom du groupe a été correctement défini ; sinon, FALSE.
CMFCTasksPane ::SetGroupTextColor
Définit la couleur du texte d'une légende de groupe.
BOOL SetGroupTextColor(
int nGroup,
COLORREF color,
COLORREF colorHot = (COLORREF)-1);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe.
color
[in] Spécifie la couleur du texte.
colorHot
[in] Spécifie la couleur de texte du groupe en surbrillance. Si -1, la couleur de surbrillance par défaut est utilisée.
Valeur de retour
TRUE si la couleur du texte du groupe a été modifiée avec succès ; sinon, FALSE.
CMFCTasksPane ::SetGroupVertOffset
Définit le décalage vertical pour un groupe.
void SetGroupVertOffset(int n = -1);
Paramètres
n
[in] Spécifie le décalage vertical.
Notes
Le décalage vertical est la distance entre un groupe de tâches et la bordure du volet Office.
Appelez cette méthode pour personnaliser les marges des éléments du volet Office. Si n est -1, l’infrastructure détermine la valeur de marge à l’aide du gestionnaire visuel (CMFCVisualManager::GetTasksPaneGroupVertOffset). Le décalage par défaut est de 15 pixels.
CMFCTasksPane ::SetHorzMargin
Définit la marge horizontale.
void SetHorzMargin(int n = -1);
Paramètres
n
[in] Spécifie la marge, en pixels.
Notes
La marge horizontale est la distance entre un volet Office et le bord supérieur ou inférieur de la zone cliente.
Si n est -1 et que l’infrastructure détermine la valeur de marge à l’aide du gestionnaire visuel (CMFCVisualManager::GetTasksPaneHorzMargin). La marge horizontale par défaut est de 12 pixels.
CMFCTasksPane ::SetIconsList
Définit la liste d’images.
BOOL SetIconsList(
UINT uiImageListResID,
int cx,
COLORREF clrTransparent = RGB(255, 0, 255));
void SetIconsList(HIMAGELIST hIcons);
Paramètres
uiImageListResID
[in] Spécifie l’ID de ressource de la liste d’images.
Cx
[in] Spécifie la taille des icônes dans la liste d’images.
clrTransparent
[in] Spécifie la couleur transparente.
hIcons
[in] Spécifie la liste d’images qui contient les icônes du volet Office.
Notes
L’infrastructure stocke les icônes dans une liste d’images. Les tâches sont associées à des icônes stockées dans cette liste.
Cette méthode associe une liste d’images au contrôle du volet Office. Pour définir l’icône d’une tâche lorsque vous appelez CMFCTasksPane ::AddTask, définissez nTaskIcon l’index de base zéro approprié dans cette liste d’images.
CMFCTasksPane ::SetPageCaption
Définit le texte de légende d’une page de volet de tâches.
void SetPageCaption(
int nPageIdx,
LPCTSTR lpszName);
Paramètres
nPageIdx
[in] Spécifie l’index de base zéro de la page.
lpszName
[in] Spécifie le texte légende à afficher sur la page.
Notes
Si un volet Office comporte plusieurs pages, la page par défaut a la légende définie à l’aide de cette méthode.
CMFCTasksPane ::SetTaskName
Définit le nom d'une tâche.
BOOL SetTaskName(
int nGroup,
int nTask,
LPCTSTR lpszTaskName);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe de tâches.
nTask
[in] Spécifie l’index de base zéro de la tâche.
lpszTaskName
[in] Spécifie le nom de la tâche.
Valeur de retour
TRUE si le nom de la tâche a été correctement défini ; sinon, FALSE.
CMFCTasksPane ::SetTasksHorzOffset
Définit le décalage horizontal pour les tâches.
void SetTasksHorzOffset(int n = -1);
Paramètres
n
[in] Spécifie le décalage horizontal.
Notes
Le décalage horizontal est la distance en pixels des bords gauche et droit d’un groupe.
Si n est -1, cette méthode définit le décalage horizontal sur la valeur retournée par la CMFCVisualManager::GetTasksPaneTaskHorzOffset méthode.
Le décalage horizontal par défaut est de 12 pixels.
CMFCTasksPane ::SetTasksIconHorzOffset
void SetTasksIconHorzOffset(int n = -1);
Paramètres
[in] ¡n
Notes
CMFCTasksPane ::SetTasksIconVertOffset
void SetTasksIconVertOffset(int n = -1);
Paramètres
[in] ¡n
Notes
CMFCTasksPane ::SetTaskTextColor
Définit la couleur du texte d'une tâche.
BOOL SetTaskTextColor(
int nGroup,
int nTask,
COLORREF color,
COLORREF colorHot = (COLORREF)-1);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe de tâches qui contient la tâche.
nTask
[in] Spécifie l’index de base zéro de la tâche.
color
[in] Spécifie la couleur de texte de la tâche.
colorHot
[in] Spécifie la couleur de texte du groupe en surbrillance. Si -1, cette méthode utilise la couleur de surbrillance par défaut.
Valeur de retour
TRUE si la couleur de texte de la tâche a été correctement définie ; sinon, FALSE.
CMFCTasksPane ::SetVertMargin
Définit la marge verticale.
void SetVertMargin(int n = -1);
Paramètres
n
[in] Spécifie la marge verticale à définir.
Notes
La marge verticale est la distance entre un volet Office et les bords verticaux de la zone cliente.
Si n est -1, l’infrastructure détermine la valeur de marge à l’aide du gestionnaire visuel (CMFCVisualManager::GetTasksPaneVertMargin). La marge par défaut est de 12 pixels.
CMFCTasksPane ::SetWindowHeight
Définit la hauteur d’un contrôle de fenêtre.
BOOL SetWindowHeight(
int nGroup,
HWND hwndTask,
int nWndHeight);
BOOL SetWindowHeight(
HWND hwndTask,
int nWndHeight);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe qui contient le contrôle de fenêtre.
hwndTask
[in] Spécifie le handle du contrôle de fenêtre.
nWndHeight
[in] Spécifie la hauteur à définir.
Valeur de retour
TRUE si la hauteur du contrôle de fenêtre a été correctement définie ; FALSE si nGroup n’est pas valide ou si hwndTask n’existe pas.
Notes
Appelez CMFCTasksPane ::AddWindow pour ajouter des tâches avec des contrôles de fenêtre.
CMFCTasksPane ::ShowCommandMessageString
virtual void ShowCommandMessageString(UINT uiCmdId);
Paramètres
[in] uiCmdId
Notes
CMFCTasksPane ::ShowTask
Affiche ou masque une tâche.
BOOL ShowTask(
int nGroup,
int nTask,
BOOL bShow = TRUE,
BOOL bRedraw = TRUE);
Paramètres
nGroup
[in] Spécifie l’index de base zéro du groupe.
nTask
[in] Spécifie l’index de base zéro de la tâche à afficher ou masquer.
bShow
[in] TRUE pour afficher la tâche ; FALSE pour masquer la tâche.
bRedraw
[in] TRUE pour redessiner le volet Office ; sinon, FALSE.
Valeur de retour
TRUE si la tâche a été correctement affichée ou masquée ; FALSE si le groupe ou la tâche spécifié n’existe pas.
Notes
Utilisez CMFCTasksPane ::ShowTaskByCmdId pour afficher ou masquer une tâche en fonction de son ID de commande.
CMFCTasksPane ::ShowTaskByCmdId
Affiche ou masque une tâche en fonction de son ID de commande.
BOOL ShowTaskByCmdId(
UINT uiCommandID,
BOOL bShow = TRUE,
BOOL bRedraw = TRUE);
Paramètres
uiCommandID
[in] Spécifie l’ID de commande de la tâche à afficher ou masquer.
bShow
[in] TRUE pour afficher la tâche ; FALSE pour masquer la tâche.
bRedraw
[in] TRUE pour redessiner le volet Office ; sinon, FALSE.
Valeur de retour
TRUE si la tâche a été correctement affichée ou masquée ; FALSE si une tâche avec l’ID de commande spécifié n’existe pas.
Notes
Utilisez CMFCTasksPane ::ShowTask pour afficher ou masquer une tâche en fonction de son ID de commande.
CMFCTasksPane ::Update
Actualise tous les contrôles dans un volet Office.
virtual void Update();
Notes
Cette méthode met à jour le volet Office légende, ajuste la barre de défilement, repositionne toutes les tâches et redessine tous les contrôles du volet Office.
Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’infrastructure actualise le volet Office.
Voir aussi
Graphique hiérarchique
Classes
CMFCTasksPaneTaskGroup, classe
CMFCTasksPaneTask, classe
CMFCOutlookBar, classe
CMFCVisualManager, classe
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour