RibbonGallery.ImageName – vlastnost
Získá nebo nastaví název používaný k identifikaci RibbonGallery v LoadImage obslužnou rutinu události.
Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)
Syntaxe
'Deklarace
Property ImageName As String
string ImageName { get; set; }
Hodnota vlastnosti
Typ: System.String
Řetězec, který lze použít v LoadImage obslužnou rutinu události pro identifikaci RibbonGallery.
Poznámky
Tuto vlastnost lze nastavit v době běhu, pouze za určitých podmínek.Další informace naleznete v tématu Přehled modelu objektu pásu karet.
ImageName Vlastnost určuje obrázek, který se zobrazí v ovládacím prvku.Office aplikace načte tento obrázek z vašeho řešení pouze jednou ke zlepšení výkonu.Tuto vlastnost lze nastavit pouze v době návrhu, protože obraz identifikuje je načítán během LoadImage události.LoadImageje vyvolána pouze jednou na název obrázku, když se zobrazí na pásu karet.Po tomto nelze změnit ovládací prvek obrázek pomocí této vlastnosti.
K načtení obrázku, přidejte kód, který LoadImage obslužnou rutinu události.Kontrola ImageName vlastnost RibbonLoadImageEventArgs a Image vlastnost RibbonLoadImageEventArgs objekt k obrázku, který chcete načíst.
Tato vlastnost je ignorována, pokud buď Image vlastnost nebo OfficeImageId vlastnost.Obrázky, které jsou označeny ImageName vlastností, které mohou být načteny mírně vyšší výkon než obrazy, které jsou označeny Image vlastnost, protože aplikace Office načte obraz z vašeho řešení pouze první čas na pásu karet se zobrazí.
ShowImage , Musí být vlastnost true pro ovládací prvek pro zobrazení obrazu.Při nastavení ImageName vlastnost v době návrhu aplikace Visual Studio automaticky nastaví ShowImage vlastnost true.Nastavíte-li ImageName vlastnost v době běhu, je nutné nastavit ShowImage vlastnost true ve vašem kódu.
Zabezpečení rozhraní .NET Framework
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.
Viz také
Referenční dokumentace
Microsoft.Office.Tools.Ribbon – obor názvů