CMFCTasksPane, classe

Article
06/10/2015

Cette rubrique est incluse par souci d'exhaustivité. Pour plus d'informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation Visual Studio.

La classe d' CMFCTasksPane implémente une liste d'éléments interactifs (tâches).

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 de tâches.
CMFCTasksPane::AddLabel	Ajoute une nouvelle étiquette statique dans le groupe de tâches spécifié.
CMFCTasksPane::AddMRUFilesList	Ajoute des tâches spécifiées par une liste des derniers fichiers utilisés de (MRU) dans un groupe.
CMFCTasksPane::AddPage	Ajoute une nouvelle page au volet de tâches.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Ajoute une nouvelle tâche dans le groupe de tâches spécifié.
CMFCTasksPane::AddWindow	Ajoute une fenêtre enfant au volet de tâches.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Réduit par programme un groupe.
CMFCTasksPane::CreateDefaultMiniframe	(Substitutions CPane::CreateDefaultMiniframe.)
CMFCTasksPane::CreateMenu	Appelé par l'infrastructure pour créer un menu pour le bouton de menu autre charge des volets .
CMFCTasksPane::EnableAnimation	Active ou désactive l'animation en réduisant ou développant 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 Suivant et des boutons de navigation Précédent .
CMFCTasksPane::EnableNavigationToolbar	Active ou désactive la barre d'outils de navigation.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Active des boutons de défilement au lieu d'une barre de défilement.
CMFCTasksPane::EnableWrapLabels	Active ou désactive le retour automatique à la ligne des é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 de la page active.
CMFCTasksPane::GetGroupCaptionHeight	Retourne la hauteur des légendes de groupe.
CMFCTasksPane::GetGroupCaptionHorzOffset	Retourne l'offset actuel d'une légende du groupe de les bords gauche et droit du volet de tâches.
CMFCTasksPane::GetGroupCaptionVertOffset	Retourne l'offset actuel d'une légende du groupe des bords supérieur et inférieur du volet de tâches.
CMFCTasksPane::GetGroupCount	Retourne le nombre total de groupes.
CMFCTasksPane::GetGroupLocation	Retourne l'index du 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	Extrait l'index de page pour un groupe spécifié.
CMFCTasksPane::GetPagesCount	Retourne le nombre de pages.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Substitutions CWnd::GetScrollBarCtrl.)
CMFCTasksPane::GetTask	Extrait une tâche.
CMFCTasksPane::GetTaskCount	Retourne le nombre de tâches à un groupe spécifié.
CMFCTasksPane::GetTaskGroup	Retourne un groupe de tâches à un index de groupe donné.
CMFCTasksPane::GetTaskLocation	Retourne le groupe et l'index d'une tâche donnée.
CMFCTasksPane::GetTasksHorzOffset	Retourne l'offset horizontal des tâches de 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	(Substitutions CDockablePane::IsAccessibilityCompatible.)
CMFCTasksPane::IsAnimationEnabled	Indique si l'animation est activée.
CMFCTasksPane::IsBackButtonEnabled	Indique si le bouton précédent est activée.
CMFCTasksPane::IsForwardButtonEnabled	Indique si le bouton en avant 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 de tâches encapsule des mots dans les étiquettes.
CMFCTasksPane::IsWrapTasksEnabled	Indique si le volet de tâches encapsule des mots dans les tâches.
CMFCTasksPane::LoadState	(Substitutions CDockablePane::LoadState.)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Appelé par l'infrastructure lorsque l'utilisateur clique sur un élément dans le volet de tâches.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton précédent.
CMFCTasksPane::OnPressForwardButton	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton de navigation avant.
CMFCTasksPane::OnPressHomeButton	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton de navigation d'accueil
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Substitutions CBasePane::OnSetAccData.)
CMFCTasksPane::OnUpdateCmdUI	(Substitutions CDockablePane::OnUpdateCmdUI.)
CMFCTasksPane::PreTranslateMessage	(Substitutions CDockablePane::PreTranslateMessage.)
CMFCTasksPane::RecalcLayout	(Substitutions CPane::RecalcLayout.)
CMFCTasksPane::RemoveAllGroups	Supprime tous les groupes sur la page spécifiée.
CMFCTasksPane::RemoveAllPages	Supprime toutes les pages du volet de tâches à moins que 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 de tâches.
CMFCTasksPane::RemoveTask	Supprime une tâche à un groupe de tâches.
CMFCTasksPane::SaveState	(Substitutions CDockablePane::SaveState.)
CMFCTasksPane::Serialize	(Substitutions CDockablePane::Serialize.)
CMFCTasksPane::SetActivePage	Lance une page spécifiée dans le volet de tâches.
CMFCTasksPane::SetCaption	Définit le nom de la légende d'un volet de tâches.
CMFCTasksPane::SetGroupCaptionHeight	Définit la hauteur d'une légende du groupe.
CMFCTasksPane::SetGroupCaptionHorzOffset	Définit l'offset horizontal d'une légende du groupe.
CMFCTasksPane::SetGroupCaptionVertOffset	Définit le décalage vertical d'une légende du groupe.
CMFCTasksPane::SetGroupName	Définit un nom de groupe.
CMFCTasksPane::SetGroupTextColor	Définit la couleur du texte de 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 pour 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 l'offset horizontal des tâches de 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 GUI qui appartiennent à un volet de tâches.

Méthodes protégées

Nom	Description
CMFCTasksPane::OnActivateTasksPanePage	Appelé par l'infrastructure lorsqu'une page de volet de tâches est activée.

Notes

La classe d' CMFCTasksPane implémente les fonctionnalités suivantes :

Les éléments peuvent être regroupés et chaque regroupement d'élément peut avoir une légende associé.
Des regroupements d'élément peuvent être développés ou réduits.
Une icône peut être assignée à chaque élément du volet de tâches.
Les éléments peuvent être associés à un ID de commande qui s'exécute lorsque l'utilisateur clique sur l'élément. Lorsque le clic se produit, le message d' WM_COMMAND est envoyé au propriétaire du contrôle de volet de tâches.

Pour utiliser le contrôle d' CMFCTasksPane dans votre application, suivez ces étapes :

Incluez un objet d' CMFCTasksPane dans la classe de fenêtre frame principale.
Lors de le traitement du message d' WM_CREATE , appelez la méthode d' Create . Vous pouvez utiliser les styles normaux de CControlBar . Pour plus d'informations, consultez CControlBar::Create.
Appelez la méthode de CMFCTasksPane::AddGroup pour ajouter différents groupes.
Appelez les fonctions membres de CMFCTasksPane::AddTask, de CMFCTasksPane::AddLabel ou de CMFCTasksPane::AddMRUFilesList pour ajouter de nouveaux éléments (tâches) à chaque groupe.
Appelez CMFCTasksPane::EnableGroupCollapse pour spécifier si des groupes d'éléments peuvent réduire.

L'illustration suivante montre un contrôle classique du volet de tâches. Le premier groupe est un groupe particulier et sa légende est une couleur plus sombre. Le troisième groupe est réduit. Le dernier groupe est aligné en bas du volet de tâches et n'a pas de légende, et la dernière tâche au groupe est une étiquette simple :

Exemple du volet de tâches

Vous pouvez personnaliser l'apparence du volet de tâches en ajustant des marges et offsets. l'illustration suivante clarifie la signification de ces variables :

Groupe de tâches personnalisées

Exemple

L'exemple suivant montre comment construire un objet d' CMFCTasksPane et utiliser différentes méthodes dans CMFCTasksPane classe. L'exemple montre comment activer réduire les 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 le retour automatique à la ligne du texte dans les étiquettes, définir le nom de la légende du volet de tâches, définir la couleur de texte de légende de groupe, puis 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();