MAPIFolder.SetCustomIcon(StdPicture) Méthode

Définition

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.

S’applique à