Ablauf im Überblick:
- Button ermitteln / erzeugen
- Icon und Maske laden und konvertieren
Durchführung:
1. Button ermitteln / erzeugen
Im ersten Schritt wird überprüft, ob der Button bereits im Outlook vorhanden ist. Ist dies der Fall, wird er übernommen. Ansonsten wird er neu erzeugt. Daraufhin wird er entsprechend konfiguriert. Dabei wird sein Style auf msoButtonIcon gesetzt.
CommandBarButton button;
try
{
button =
(CommandBarButton)commandBars["Standard"].Controls[buttonCaption];
}
catch (System.Exception ex)
{
button =
(CommandBarButton)commandBars["Standard"].Controls.Add(
1,
System.Reflection.Missing.Value,
System.Reflection.Missing.Value,
System.Reflection.Missing.Value,
System.Reflection.Missing.Value);
button.Caption = buttonCaption;
}
button.DescriptionText = "Description";
button.Style = MsoButtonStyle.msoButtonIcon;
button.Picture = getIcon();
button.Mask = getMask();
button.Click += new _CommandBarButtonEvents_ClickEventHandler(click);
2. Icon und Maske laden und konvertieren
Nun muss ein Icon erstellt werden. Zusätzlich muss eine schwarz-weiße Maske erstellt werden, welche die Transparenz des Icons beschreibt. Schwarz steht dabei für sichtbar, während weiß durchlässige Bereiche repräsentiert. Sowohl Icon, als auch Maske müssen 16x16 Pixel groß sein und können als BMP erstellt werden. Sie können dem Projekt als Ressource hinzugefügt werden und sind dann einfach wie im folgenden gezeigt erreichbar.
private static IPictureDisp getMask()
{
return AxHostConverter.ToPictureDisp(Properties.Resources.Icon);
}
private static IPictureDisp getIcon()
{
return AxHostConverter.ToPictureDisp(Properties.Resources.Mask);
}
Die CommandBarButtons eines Outlook-Add-Ins erwartet für die Eigentschaften Picture und Mask eine Instanz, die IPictureDisp implementiert. Da dies für Image und Bitmap nicht zutrifft, müssen die aus den Ressourcen geladenen Bilder zunächst konvertiert werden. Der einfachste Weg nach IPictureDisp zu konvertieren, ist die Erzeugung einer Unterklasse von AxHost.
internal class AxHostConverter : AxHost
{
private AxHostConverter() : base("") { }
static public stdole.IPictureDisp ToPictureDisp(Image image)
{
return (stdole.IPictureDisp)GetIPictureFromPicture(image);
}
}
Weitere Informationen:
Keine Kommentare:
Kommentar veröffentlichen