MAPIFolder.SetCustomIcon(StdPicture) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit une icône personnalisée spécifiée par Picture pour le dossier .
public:
void SetCustomIcon(stdole::StdPicture ^ Picture);public void SetCustomIcon (stdole.StdPicture Picture);Public Sub SetCustomIcon (Picture As StdPicture)Paramètres
- Picture
- StdPicture
Spécifie l’icône personnalisée du dossier.
Remarques
La StdPicture propriété Type de l’objet spécifié par Picture doit être égale à PICTYPE_ICON ou PICTYPE_BITMAP. L’icône ou la ressource bitmap peut avoir une taille maximale de 32 x 32. Les icônes 16 x 16 ou 24 x 24 sont également prises en charge, et Microsoft Outlook peut effectuer un scale-up d’une icône 16 x 16 si Outlook s’exécute en mode points par pouce (PPP) élevé. Les icônes d’autres tailles conduisent SetCustomIcon à renvoyer une erreur.
Vous pouvez définir une icône personnalisée pour un dossier de recherche et pour tous les dossiers qui ne correspondent pas à un dossier par défaut ou à un dossier spécial. Si vous essayez de définir une icône personnalisée pour un dossier qui appartient à l’un des groupes de dossiers suivants, SetCustomIcon retourne une erreur :
Vous ne pouvez appeler GetCustomIcon qu’à partir du code qui s’exécute intra-processus comme Outlook. Un objet StdPicture ne peut pas être marshalé au-delà des limites du processus. Si vous tentez d’appeler GetCustomIcon à partir du code extra-processus, une exception est levée. Pour plus d’informations, consultez Un serveur Automation ne peut pas passer de pointeur vers l’implémentation IPictureDisp de l’objet image au-delà des limites de processus.
L’icône de dossier personnalisée que cette méthode fournit n’existe plus une fois terminée la session Outlook en cours. Par conséquent, les compléments doivent définir cette icône à chaque démarrage d’Outlook.
L’icône de dossier personnalisée n’apparaît pas dans les autres clients Exchange tels qu’Outlook Web Access, ni lorsqu’Outlook s’exécute sur un appareil Windows Mobile.