CMFCTasksPaneTask, classe

La CMFCTasksPaneTask classe est une classe d’assistance qui représente des tâches pour le contrôle du volet Office ( CMFCTasksPane). L’objet de tâche représente un élément dans le groupe de tâches ( CMFCTasksPaneTaskGroup). Chaque tâche peut avoir une commande exécutée par l’infrastructure lorsqu’un utilisateur clique sur la tâche et une icône qui apparaît à gauche du nom de la tâche.

Syntaxe

class CMFCTasksPaneTask : public CObject

Membres

Constructeurs publics

Nom	Description
CMFCTasksPaneTask ::CMFCTasksPaneTask	Crée et initialise un CMFCTasksPaneTask objet.
CMFCTasksPaneTask::~CMFCTasksPaneTask	Destructeur.

Méthodes publiques

Nom	Description
CMFCTasksPaneTask ::SetACCData	Détermine les données d’accessibilité de la tâche actuelle.

Données membres

Nom	Description
CMFCTasksPaneTask ::m_bAutoDestroyWindow	Détermine si la fenêtre de tâche est automatiquement détruite.
CMFCTasksPaneTask ::m_bIsBold	Détermine si l’infrastructure dessine une étiquette de tâche en gras.
CMFCTasksPaneTask ::m_dwUserData	Contient des données définies par l’utilisateur que l’infrastructure associe à la tâche. Défini sur zéro si la tâche n’a pas de données associées.
CMFCTasksPaneTask ::m_hwndTask	Handle vers la fenêtre de tâche.
CMFCTasksPaneTask ::m_nIcon	Index dans la liste d’images de l’image affichée par l’infrastructure en regard de la tâche.
CMFCTasksPaneTask ::m_nWindowHeight	Hauteur de la fenêtre de tâche. Si la tâche n’a pas de fenêtre de tâche, cette valeur est égale à zéro.
CMFCTasksPaneTask ::m_pGroup	Pointeur vers le CMFCTasksPaneTaskGroup pointeur auquel cette tâche appartient.
CMFCTasksPaneTask ::m_rect	Spécifie le rectangle englobant de la tâche.
CMFCTasksPaneTask ::m_strName	Nom de la tâche.
CMFCTasksPaneTask ::m_uiCommandID	Spécifie l’ID de commande de la commande exécutée par l’infrastructure lorsque l’utilisateur clique sur la tâche. Si cette valeur n’est pas un ID de commande valide, la tâche est traitée comme une étiquette simple.

Notes

L’illustration suivante montre un groupe de tâches qui contient trois tâches :

Remarque

Si une tâche n’a pas d’ID de commande valide, elle est traitée comme une étiquette simple.

Hiérarchie d'héritage

CObject

CMFCTasksPaneTask

Spécifications

En-tête : afxTasksPane.h

CMFCTasksPaneTask ::CMFCTasksPaneTask

Crée et initialise un CMFCTasksPaneTask objet.

CMFCTasksPaneTask(
    CMFCTasksPaneTaskGroup* pGroup,
    LPCTSTR lpszName,
    int nIcon,
    UINT uiCommandID,
    DWORD dwUserData = 0,
    HWND hwndTask = NULL,
    BOOL bAutoDestroyWindow = FALSE,
    int nWindowHeight = 0);

Paramètres

pGroup
Spécifie le CMFCTasksPaneTaskGroup auquel appartient la tâche.

lpszName
Spécifie le nom de la tâche.

nIcon
Spécifie l’index de l’image de la tâche dans la liste d’images.

uiCommandID
Spécifie l’ID de commande de la commande exécutée lorsque la tâche est cliquée.

dwUserData
Données définies par l’utilisateur.

hwndTask
Spécifie le handle dans la fenêtre de tâche.

bAutoDestroyWindow
Si la valeur est TRUE, la fenêtre de tâche est détruite automatiquement.

nWindowHeight
Spécifie la hauteur de la fenêtre de tâche.

Notes

CMFCTasksPaneTask ::m_bAutoDestroyWindow

Détermine si la fenêtre de tâche est automatiquement détruite.

BOOL m_bAutoDestroyWindow;

Notes

Définissez la valeur TRUE pour spécifier que la fenêtre de tâche ( CMFCTasksPaneTask ::m_hwndTask) doit être détruite automatiquement ; sinon, FALSE.

CMFCTasksPaneTask ::m_bIsBold

Détermine si une étiquette de tâche est dessinée en gras.

BOOL m_bIsBold;

Notes

Définissez ce membre sur TRUE pour afficher du texte en gras pour l’étiquette de tâche.

CMFCTasksPaneTask ::m_dwUserData

Contient des données définies par l’utilisateur associées à la tâche. Défini sur zéro si aucune donnée n’est associée à la tâche.

DWORD m_dwUserData;

Notes

CMFCTasksPaneTask ::m_hwndTask

Handle vers la fenêtre de tâche.

HWND m_hwndTask;

Notes

Pour ajouter une fenêtre de tâche, appelez CMFCTasksPane ::AddWindow.

CMFCTasksPaneTask ::m_nIcon

Position d’index dans une liste d’images qui identifie une image affichée en regard de la tâche spécifiée.

int m_nIcon;

Notes

La liste d’images est définie par CMFCTasksPane ::SetIconsList.

Définissez la valeur m_nIcon -1 si vous souhaitez afficher la tâche sans image.

CMFCTasksPaneTask ::m_nWindowHeight

Hauteur de la fenêtre de tâche. Si la tâche n’a pas de fenêtre de tâche, cette valeur est égale à zéro.

int m_nWindowHeight;

Notes

CMFCTasksPaneTask ::m_pGroup

Pointeur vers cmFCTasksPaneTaskGroup auquel cette tâche appartient.

CMFCTasksPaneTaskGroup* m_pGroup;

Notes

Chaque tâche doit avoir un groupe parent. Vous ajoutez des groupes à un volet Office en appelant CMFCTasksPane ::AddGroup.

CMFCTasksPaneTask ::m_rect

Spécifie le rectangle englobant de la tâche.

CRect m_rect;

Notes

Cette valeur est calculée par l’infrastructure lorsque la tâche est dessinée.

CMFCTasksPaneTask ::m_strName

Nom de la tâche.

CString m_strName;

Notes

CMFCTasksPaneTask ::m_uiCommandID

Spécifie l’ID de commande de la commande exécutée lorsque l’utilisateur clique sur la tâche. Si cette valeur n’est pas un ID de commande valide, la tâche est traitée comme une étiquette simple.

UINT m_uiCommandID;

Notes

CMFCTasksPaneTask ::SetACCData

Détermine les données d’accessibilité de la tâche actuelle.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Paramètres

pParent
[in] Représente la fenêtre parente de la tâche active.

data
[out] Objet de type CAccessibilityData rempli avec les données d’accessibilité de la tâche actuelle.

Valeur de retour

TRUE si le paramètre de données a été correctement rempli avec les données d’accessibilité de la tâche actuelle ; sinon, FALSE.

Voir aussi

Graphique hiérarchique
Classes
CObject, classe