Udostępnij za pośrednictwem


RibbonSplitButton.ImageName Właściwość

Definicja

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, set
Public Property ImageName As String

Wartość 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.

Dotyczy