Zdarzenie RibbonBase.LoadImage
Występuje, gdy RibbonBase ładuje, jeśli Nazwa_obrazu właściwość jest ustawiona na jeden lub więcej formantów.
Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common.v4.0.Utilities (w Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Składnia
'Deklaracja
Public Event LoadImage As RibbonLoadImageEventHandler
public event RibbonLoadImageEventHandler LoadImage
Uwagi
LoadImage Zdarzenie pozwala na obrazy pamięci podręcznej w dostosowania wstążki, które mogą poprawić wydajność.
Domyślnie obraz jest ładowany do wstążki, za każdym razem użytkownik wyświetla kartę, która zawiera obraz.Obraz zostanie ponownie załadowana ilekroć programowo zmienić właściwości formantu, w którym jest wyświetlany obraz.
Użycie LoadImage zdarzenie, aby przypisać do formantu obrazu.Po wybraniu karty na Wstążce aplikacji Microsoft Office używa buforowanych obrazu.Zmodyfikowanie właściwości formantu w czasie wykonywania aplikacji pakietu Microsoft Office nie załaduje obrazu na formancie.To może dać zysk małej wydajności.
Jeśli chcesz buforować formantu obrazu, ustaw Nazwa_obrazu właściwości formantu.LoadImage Zdarzenie nie jest wywoływane, chyba że ustawisz Nazwa_obrazu właściwość co najmniej jeden formant.
Przykłady
Poniższy przykład buforuje obrazy dla dwóch RibbonButton kontroli.
Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:
Dodaj wstążki (wizualnego projektowania) do projektu programu pakietu Office.
Jeśli używasz programu Visual Basic project na początku pliku kodu wstążki należy dodać następującą instrukcję:Imports Microsoft.Office.Tools.Ribbon
Następnie możesz uruchomić ten kod w generowanej klasy wstążki.
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;
}
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.