MAPIFolder.SetCustomIcon(StdPicture) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt ein benutzerdefiniertes Symbol fest, das von Picture für den Ordner angegeben wird.
public:
void SetCustomIcon(stdole::StdPicture ^ Picture);public void SetCustomIcon (stdole.StdPicture Picture);Public Sub SetCustomIcon (Picture As StdPicture)Parameter
- Picture
- StdPicture
Gibt das benutzerdefinierte Symbol für den Ordner an.
Hinweise
Das StdPicture von Picture angegebene Objekt muss über die Type-EigenschaftPICTYPE_ICON oder PICTYPE_BITMAP verfügen. Die Symbol oder Bitmap-Ressource kann eine maximale Größe von 32 x 32 haben. Symbole, die 16 x 16 oder 24 x 24 sind auch unterstützt werden, sowie Microsoft Outlook können vertikale Skalierung einer 16 x 16-Symbol, wenn Outlook im Modus für hohe Punkte pro Zoll (DPI) ausgeführt wird. Symbole aller anderen Größen verursachen SetCustomIcon einen Fehler zurückgegeben.
Sie können ein benutzerdefiniertes Symbol für ein Suchordner und für alle Ordner, die nicht standardmäßiger darstellen oder einen Ordner mit Sonderfunktion festlegen. Wenn Sie versuchen, ein benutzerdefiniertes Symbol für einen Ordner festzulegen, zu der eine der folgenden Gruppen von Ordnern gehört, gibt SetCustomIcon einen Fehler zurück:
Sie können nur GetCustomIcon aus Code aufgerufen wird, wird als Outlook prozessinternes Protokoll. Ein StdPicture -Objekt kann nicht über die Grenzen hinweg Prozess gemarshallt werden sollen. Wenn Sie versuchen, GetCustomIcon aus Out-of-Process-Code aufgerufen werden, tritt eine Ausnahme auf. Weitere Informationen finden Sie unter Ein Automatisierungsserver kann keinen Zeiger auf die IPictureDisp-Implementierung des Bildobjekts über Prozessgrenzen hinweg übergeben.
Das benutzerdefinierte Ordnersymbol, das durch diese Methode bereitgestellt wird, bleibt nicht über die aktuelle Outlook-Sitzung hinaus bestehen. Add-Ins müssen das benutzerdefinierte Ordnersymbol daher bei jedem Starten von Outlook festlegen.
Das benutzerdefinierte Ordnersymbol wird nicht in anderen Exchange-Clients, wie etwa Outlook Web Access oder bei der Ausführung von Outlook auf Windows Mobile-Geräten angezeigt.