RibbonToggleButton.ImageName Eigenschaft
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.
Ruft den Namen ab oder legt den Namen fest, den Sie im LoadImage-Ereignishandler zum Identifizieren eines Bilds für das Steuerelement verwenden können.
public string ImageName { get; set; }
Eigenschaftswert
Eine Zeichenfolge, die im LoadImage-Ereignishandler zum Identifizieren eines Bilds für das Steuerelement verwendet werden kann.
Beispiele
Im folgenden Beispiel werden die Bilder für zwei Schaltflächen zwischengespeichert.
Zum Ausführen dieses Code Beispiels müssen Sie zunächst die folgenden Schritte ausführen:
Fügen Sie einem Office-Projekt ein Element vom Typ Menüband (visueller Designer) hinzu.
Fügen Sie der Registerkarte Benutzer definiert eine Gruppe hinzu.
Fügen Sie der Gruppe zwei Schaltflächen hinzu.
Fügen Sie den Projektressourcen zwei Bilder hinzu.
Sie können diesen Code dann in der generierten Menü bandklasse ausführen.
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;
}
}
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
Hinweise
Die- ImageName Eigenschaft identifiziert ein Bild, das vom-Steuerelement angezeigt wird. Die Office-Anwendung ruft dieses Image nur einmal aus der Lösung ab, um die Leistung zu verbessern. Diese Eigenschaft kann nur zur Entwurfszeit festgelegt werden, da das Bild, das Sie identifiziert, während des Ereignisses geladen wird LoadImage . LoadImagewird nur einmal pro Bildname ausgelöst, wenn das Menüband angezeigt wird. Danach kann das Steuerelement Bild nicht mehr mit dieser Eigenschaft geändert werden.
Fügen Sie dem-Ereignishandler Code hinzu, um das Bild zu laden LoadImage . Überprüfen Sie die ImageName -Eigenschaft der, RibbonLoadImageEventArgs und legen Sie die- Image Eigenschaft des- RibbonLoadImageEventArgs Objekts auf das Bild fest, das Sie laden möchten.
Diese Eigenschaft wird ignoriert, wenn entweder die- Image Eigenschaft oder die- OfficeImageId Eigenschaft festgelegt ist. Bilder, die durch die- ImageName Eigenschaft identifiziert werden, können etwas schneller geladen werden als Bilder, die durch die-Eigenschaft identifiziert werden Image , da die Office-Anwendung das Bild nur bei der ersten Anzeige der Multifunktionsleiste aus der Projekt Mappe abruft.
Die- ShowImage Eigenschaft muss sein true , damit das-Steuerelement das Bild anzeigt. Wenn Sie die- ImageName Eigenschaft zur Entwurfszeit festlegen, wird die-Eigenschaft von Visual Studio automatisch auf festgelegt ShowImage true . Wenn Sie die- ImageName Eigenschaft zur Laufzeit festlegen, müssen Sie die- ShowImage Eigenschaft true im Code auf festlegen.