RibbonEditBox.ImageName – vlastnost
Získá nebo nastaví název používaný k identifikaci obrazu 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 obrázku.
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 objektů pásu karet.
ImageName Vlastnost určuje obrázek, který se zobrazí v ovládacím prvku.Office aplikace načte 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 při načtení obrazu identifikuje LoadImage události.LoadImageje vyvolána pouze jednou na název obrázku, když je zobrazena na pásu karet.Poté ovládací prvek obrázek nelze změnit 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 objektu k obrázku, který chcete načíst.
Tato vlastnost je ignorována, pokud Image vlastnost nebo OfficeImageId je vlastnost nastavena.Obrázky, které jsou označeny ImageName vlastnosti lze načíst mírně vyšší výkon než obrazy, které jsou označeny Image vlastnost, protože aplikace Office načte obrázek z vašeho řešení pouze první čas 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 za 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ů