OfficeRibbon.LoadImage-Ereignis (2007 System)
Aktualisiert: November 2007
Tritt auf, wenn OfficeRibbon geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)
AddHandler instance.LoadImage, handler
[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> LoadImage
Hinweise
Das LoadImage-Ereignis ermöglicht das Zwischenspeichern von Bildern in der Multifunktionsleistenanpassung und dadurch eine verbesserte Leistung.
Standardmäßig wird ein Bild immer dann in die Multifunktionsleiste geladen, wenn der Benutzer eine Registerkarte mit dem Bild anzeigt. Ein Bild wird immer neu geladen, wenn die Eigenschaften eines Steuerelements, auf dem das Bild angezeigt wird, programmgesteuert geändert werden.
Weisen Sie einem Steuerelement mithilfe des LoadImage-Ereignisses ein Bild zu. Wählt der Benutzer auf der Multifunktionsleiste eine Registerkarte aus, wird von der Microsoft Office-Anwendung das zwischengespeicherte Bild verwendet. Wird eine Steuerelementeigenschaft während der Laufzeit geändert, wird das Bild auf dem Steuerelement von der Microsoft Office-Anwendung nicht neu geladen. Dadurch wird unter Umständen eine leichte Leistungssteigerung erzielt.
Soll das Bild eines Steuerelements zwischengespeichert werden, legen Sie die ImageName-Eigenschaft des Steuerelements fest. Das LoadImage-Ereignis wird nicht ausgelöst, sofern nicht die ImageName-Eigenschaft von mindestens einem Steuerelement festgelegt wird.
Beispiele
Im folgenden Beispiel werden die Bilder für zwei RibbonButton-Steuerelemente zwischengespeichert.
Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:
Fügen Sie einem Visual Studio Tools for Office-Projekt eine Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie bei Verwendung eines Visual Basic-Projekts am Anfang der Multifunktionsleisten-Codedatei die folgende Anweisung hinzu: Imports Microsoft.Office.Tools.Ribbon
Anschließend kann dieser Code in der generierten Multifunktionsleistenklasse ausgeführt werden.
Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)
Select Case e.ImageName
Case "Button1Image"
e.Image = My.Resources.Image1
Case "Button2Image"
e.Image = My.Resources.Image2
End Select
End Sub
private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
switch (e.ImageName)
{
case "Button1Image":
e.Image = Properties.Resources.Image1;
break;
case "Button2Image":
e.Image = Properties.Resources.Image2;
break;
}
}
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.