RibbonSplitButton.ImageName Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia nazwę, której można użyć w programie obsługi zdarzeń E:Microsoft.Office.Tools.Ribbon.LoadImage, aby zidentyfikować obraz kontrolki.
public:
property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };public string ImageName { get; set; }member this.ImageName : string with get, setPublic Property ImageName As StringWartość właściwości
Ciąg, którego można użyć w procedurze obsługi zdarzeń E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage, aby zidentyfikować obraz kontrolki.
Uwagi
Właściwość ImageName identyfikuje obraz wyświetlany przez kontrolkę. Aplikacja pakietu Office pobiera ten obraz z rozwiązania tylko raz, aby zwiększyć wydajność. Tę właściwość można ustawić tylko w czasie projektowania, ponieważ obraz, który identyfikuje, jest ładowany podczas LoadImage zdarzenia. LoadImage jest wywoływany tylko raz na nazwę obrazu, gdy zostanie wyświetlona wstążka. Później obrazu formantu nie będzie można zmienić przy użyciu tej właściwości.
Aby załadować obraz, dodaj kod do procedury obsługi zdarzeń LoadImage . ImageName Sprawdź właściwość RibbonLoadImageEventArgs i ustaw Image właściwość RibbonLoadImageEventArgs obiektu na obraz, który chcesz załadować.
Ta właściwość jest ignorowana, jeśli Image właściwość lub właściwość jest ustawiona OfficeImageId . Obrazy identyfikowane przez ImageName właściwość mogą być ładowane nieco szybciej niż obrazy zidentyfikowane przez Image właściwość, ponieważ aplikacja pakietu Office pobiera obraz z rozwiązania tylko przy pierwszym wyświetleniu wstążki.