RibbonSplitButton.ImageName Vlastnost

Definice

Obor názvů:

Microsoft.Office.Tools.Ribbon

Sestavení:

Microsoft.Office.Tools.Common.dll

Získá nebo nastaví název, který můžete použít v obslužné rutině události E:Microsoft.Office.Tools.Ribbon.LoadImage k identifikaci image ovládacího prvku.

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

Hodnota vlastnosti

String

Řetězec, který můžete použít v obslužné rutině události E:Microsoft.Office.Office.Tools.Ribbon.OfficeRibbon.LoadImage k identifikaci obrázku ovládacího prvku.

Poznámky

Vlastnost ImageName identifikuje obrázek, který je zobrazen ovládacím prvku. Za účelem zlepšení výkonu aplikace sady Office načte tento obrázek z vašeho řešení pouze jednou. Tuto vlastnost lze nastavit pouze v době návrhu, protože obrázek, který identifikuje, je načten během LoadImage události. LoadImage Při zobrazení pásu karet se na každý název obrázku vyvolá jenom jednou. Poté nebude možné obrázek ovládacího prvku pomocí této vlastnosti změnit.

Pokud chcete načíst obrázek, přidejte kód do obslužné rutiny LoadImage události. ImageName Zkontrolujte vlastnost objektu RibbonLoadImageEventArgs a nastavte Image vlastnost objektu RibbonLoadImageEventArgs na obrázek, který chcete načíst.

Tato vlastnost je ignorována, pokud je nastavena ImageOfficeImageId vlastnost nebo vlastnost. Obrázky identifikované ImageName vlastností je možné načíst o něco rychleji než obrázky identifikované Image vlastností, protože aplikace Office načte obrázek z vašeho řešení pouze při prvním zobrazení pásu karet.