Właściwość RibbonButton.ImageName —

Artykuł
01/08/2014

Pobiera lub ustawia nazwę, która służy do identyfikacji przycisku w LoadImage program obsługi zdarzeń.

Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
Property ImageName As String

string ImageName { get; set; }

Wartość właściwości

Typ: System.String
Ciąg, który można użyć w LoadImage obsługi zdarzeń identyfikującą przycisk.

Uwagi

Tej właściwości można ustawić w czasie wykonywania tylko pod pewnymi warunkami.Aby uzyskać więcej informacji, zobacz Model obiektu Wstążka ― Omówienie.

Aby uzyskać informacje dotyczące ustawiania tej właściwości, zobacz Model obiektu Wstążka ― Omówienie.

ImageName Właściwość identyfikuje obraz wyświetlany przez formant.Aplikacja pakietu Office pobiera ten obraz z rozwiązania tylko raz, aby zwiększyć wydajność.Tej właściwości można ustawić tylko w czasie projektowania, ponieważ obraz jest identyfikowana jest ładowany podczas LoadImage zdarzenia.LoadImagejest uruchamiany tylko raz na nazwę obrazu po wyświetleniu wstążki.Po tym za pomocą tej właściwości nie można zmienić formantu obrazu.

Aby załadować obraz, Dodaj kod, aby LoadImage program obsługi zdarzeń.Sprawdź ImageName właściwość RibbonLoadImageEventArgs i ustawić Image właściwość RibbonLoadImageEventArgs obiektu do obrazu, który chcesz załadować.

Ta właściwość jest ignorowana, jeśli Image właściwość lub OfficeImageId właściwość jest ustawiona.Obrazy identyfikowane przez ImageName właściwość, które mogą być ładowane nieco szybciej niż obrazy, identyfikowane przez Image właściwość, ponieważ aplikacja pakietu Office pobiera obraz z czasu rozwiązania tylko pierwszy wstążki jest wyświetlany.

ShowImage Właściwość musi być true do kontroli w celu wyświetlania obrazu.Podczas ustawiania ImageName automatycznie ustawia właściwość w czasie projektowania programu Visual Studio ShowImage właściwość, aby true.Jeśli ustawisz ImageName właściwość w czasie wykonywania, należy ustawić ShowImage właściwość, aby true w kodzie.

Przykłady

Poniższy przykład buforuje obrazów dla dwóch przycisków.

Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodaj wstążki (wizualnego projektowania) element do projektu utworzone za pomocą narzędzi programistycznych pakietu Office w programie Visual Studio.
Dodaj grupę na karcie niestandardowe.
Do grupy, należy dodać dwa przyciski.
Dodaj dwa obrazy do zasobów projektu.Aby uzyskać więcej informacji, zobacz Jak: Dodawanie lub usuwanie zasobów.

Następnie możesz uruchomić ten kod w generowanej klasy wstążki.

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;
    }
}

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.