Właściwość RibbonButton.ImageName —

Artykuł
05/08/2013

Pobiera lub ustawia nazwę, która służy do identyfikacji przycisku w LoadImage programu 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 program 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 Omówienie modelu obiektu wstążki.

Aby uzyskać informacje dotyczące ustawiania tej właściwości, zobacz Omówienie modelu obiektu wstążki.

ImageName Właściwość identyfikuje obraz, który jest 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ż podczas ładowany jest obraz rozpoznaje on LoadImage zdarzenia.LoadImagejest wywoływane tylko raz na nazwę obrazu, gdy Wstążka jest wyświetlana.Po tym obraz sterującego nie można zmienić za pomocą tej właściwości.

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

Ta właściwość jest ignorowana, jeśli każda Image właściwość lub OfficeImageId właściwość jest ustawiona.Obrazy, identyfikowane przez ImageName właściwości, które mogą być ładowane nieco szybciej niż obrazy, identyfikowane przez Image właściwość, ponieważ aplikacji pakietu Office pobiera obraz z swój czas rozwiązania tylko pierwszy Wstążka jest wyświetlana.

ShowImage Właściwość musi być true do celów 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 obrazy dla dwóch przycisków.

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

Dodać wstążki (Visual Designer) element, aby projekt utworzony przy użyciu narzędzia programowania pakietu Office w programie Visual Studio.
Dodaj grupę do karty niestandardowe.
Dodać dwa przyciski do grupy.
Dodać 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 Przy użyciu bibliotek z częściowo zaufanego kodu..