RibbonDialogLauncher.ImageName – vlastnost
Získá nebo nastaví identifikátor, který se používá k přiřazení obrázku k tomuto RibbonDialogLauncher kdy je přidán na panel nástrojů Rychlý přístup.
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
Identifikátor, který se používá k přiřazení obrázku k tomuto RibbonDialogLauncher kdy je přidán na panel nástrojů Rychlý přístup.
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 nemá žádný viditelný efekt při RibbonDialogLauncher se zobrazí ve skupině na pásu karet.Pokud uživatel však přidá RibbonDialogLauncher na panel nástrojů Rychlý přístup je tato vlastnost řídí chování obraz, který je zobrazen, pokud Image nebo OfficeImageId také vlastnost.
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í.
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ů