Udostępnij za pośrednictwem


Właściwość RibbonDialogLauncher.ImageName —

Pobiera lub ustawia identyfikator, który służy do przypisywania obrazu do tego RibbonDialogLauncher po dodaniu do paska narzędzi Szybki dostęp.

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
Identyfikator, który służy do przypisywania obrazu do tego RibbonDialogLauncher po dodaniu do paska narzędzi Szybki dostęp.

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.

ImageName Właściwość nie ma widocznych efektów po RibbonDialogLauncher jest wyświetlany w grupie na Wstążce.Jednakże, kiedy użytkownik dodaje RibbonDialogLauncher do paska narzędzi Szybki dostęp, ta właściwość kontroluje zachowanie obrazu, który jest wyświetlany, chyba że Image lub OfficeImageId właściwość jest również ustawiona.

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.

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

RibbonDialogLauncher Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Ribbon

Inne zasoby

Omówienie modelu obiektu wstążki