Właściwość RibbonEditBox.ImageName —
Pobiera lub ustawia nazwę, która służy do identyfikowania obrazu 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ń do identyfikowania obrazu.
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ść 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.
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..
Zobacz też
Informacje
Przestrzeń nazw Microsoft.Office.Tools.Ribbon