MMC_TASK_DISPLAY_BITMAP structure (mmc.h)
La structure MMC_TASK_DISPLAY_BITMAP est introduite dans MMC 1.1.
La structure MMC_TASK_DISPLAY_BITMAP est utilisée pour le membre uBitmap de la structure MMC_TASK_DISPLAY_OBJECT afin de spécifier toutes les données requises pour afficher une image GIF ou bitmap pour une tâche ou un arrière-plan sur un bloc-tâches.
Syntaxe
typedef struct _MMC_TASK_DISPLAY_BITMAP {
LPOLESTR szMouseOverBitmap;
LPOLESTR szMouseOffBitmap;
} MMC_TASK_DISPLAY_BITMAP;
Membres
szMouseOverBitmap
Pointeur vers une chaîne terminée par un caractère Null qui contient le chemin d’accès de la ressource au fichier image de l’image affichée pour la tâche lorsque l’utilisateur déplace la souris sur l’image ou la zone de texte de la tâche.
La chaîne doit avoir la forme suivante :
« res:// filepath/imgpath »
où filepath est le chemin d’accès complet à la DLL du composant logiciel enfichable qui stocke le fichier image en tant que ressource, et imgpath est le chemin d’accès aux ressources du fichier image avec la DLL de composant logiciel enfichable.
Par exemple, la chaîne suivante spécifie que la DLL de composant logiciel enfichable (snapin.dll) a un chemin d’accès « c:\windows\system32\snapin.dll » et que le chemin de la ressource est img/mon.gif : « res://c:\windows\system32\snapin.dll/img/mon.bmp ».
Si szMouseOverBitmap pointe vers une chaîne NULL , szMouseOffBitmap doit être une chaîne valide qui contient l’emplacement d’une image valide. Si l’une de ces chaînes a la valeur NULL, l’autre chaîne est utilisée pour les deux. Si les deux emplacements de l’image de souris ont la valeur NULL, la tâche n’est pas affichée.
szMouseOffBitmap
Pointeur vers une chaîne terminée par un caractère Null qui contient le chemin d’accès de la ressource au fichier image de l’image affichée pour la tâche lorsque la souris ne se trouve pas dans l’image ou la zone de texte de la tâche.
Consultez szMouseOverBitmap pour connaître le format de la chaîne.
Si szMouseOffBitmap pointe vers une chaîne NULL , szMouseOverBitmap doit être une chaîne valide qui contient l’emplacement d’une image valide. Si l’une de ces chaînes a la valeur NULL, l’autre chaîne est utilisée pour les deux. Si les deux emplacements de l’image de souris ont la valeur NULL, la tâche n’est pas affichée.
Notes
Allouez les chaînes szMouseOverBitmap et szMouseOffBitmap utilisées dans la structure avec la fonction d’API COM CoTaskMemAlloc (ou l’équivalent) et MMC les libère.
Si szMouseOverBitmap et szMouseOffBitmap pointent vers une chaîne NULL , la tâche n’apparaît pas dans le bloc-tâches. Si l’une de ces chaînes a la valeur NULL, l’autre chaîne est utilisée pour les deux.
Spécifications
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | mmc.h |