Partager via


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 :

  1. Incorporez un objet CMFCTasksPane dans la classe de fenêtre frame principale.

  2. Lors du traitement du message WM_CREATE, appelez la Create méthode. Vous pouvez utiliser les styles CControlBar standard. Pour plus d’informations, consultez CControlBar::Create.

  3. Appelez la méthode CMFCTasksPane ::AddGroup pour ajouter différents groupes.

  4. Appelez les fonctions membres CMFCTasksPane ::AddTasksPane, CMFCTasksPane ::AddLabel ou CMFCTasksPane ::AddMRUFilesList pour ajouter de nouveaux éléments (tâches) à chaque groupe.

  5. 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 sa 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 :

Exemple de volet Office.

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 :

Groupe de tâches personnalisé.

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 du mot pour le texte dans les étiquettes, définir le nom de légende du volet Office, définir la couleur de texte d’une légende de groupe, 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 la légende du groupe.

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 la légende du groupe ; 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 coche 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 la légende du groupe ; 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 de la légende du groupe.

int GetGroupCaptionHeight() const;

Valeur de retour

Hauteur de la légende du groupe, en pixels.

CMFCTasksPane ::GetGroupCaptionHorzOffset

Retourne le décalage horizontal d’une légende de groupe.

int GetGroupCaptionHorzOffset() const;

Valeur de retour

Décalage horizontal d’une légende de groupe. 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’une légende de groupe.

int GetGroupCaptionVertOffset() const;

Valeur de retour

Décalage vertical d’une légende de groupe à 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 vérifie l’ID de commande associé à la tâche cliquée 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 de la 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 de 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 de la légende du groupe.

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, de la légende du groupe.

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 de 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 la légende du volet Office, 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