RibbonLoadImageEventArgs-Klasse (2007 System)
Aktualisiert: November 2007
Stellt Daten für das LoadImage-Ereignis bereit.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
Public NotInheritable Class RibbonLoadImageEventArgs _
Inherits EventArgs
Dim instance As RibbonLoadImageEventArgs
public sealed class RibbonLoadImageEventArgs : EventArgs
Hinweise
Behandeln Sie das LoadImage-Ereignis, falls Sie ein Bild laden möchten, das durch die ImageName-Eigenschaft eines Steuerelements identifiziert wird. Aus Gründen der Leistungssteigerung ruft die Microsoft Office-Anwendung dieses Bild nur einmal von der Projektmappe ab, wenn die Multifunktionsleiste angezeigt wird. Anschließend kann das Steuerelementbild nicht geändert werden.
Um ein Bild für ein Steuerelement hinzuzufügen, fügen Sie dem LoadImage-Ereignishandler Code hinzu. Entspricht die ImageName-Eigenschaft von RibbonLoadImageEventArgs der ImageName-Eigenschaft des Steuerelements, legen Sie die Image-Eigenschaft auf das zu ladende Bild fest.
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 ein Element von Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe zwei Schaltflächen hinzu.
Fügen Sie den Projektressourcen zwei Bilder hinzu. Weitere Informationen hierzu finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.
Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
ByVal 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;
}
}
Vererbungshierarchie
System.Object
System.EventArgs
Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.