RibbonButton.Image – vlastnost

Článek
05/14/2013

Získá nebo nastaví obrázek, který je zobrazen na tlačítku.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
Property Image As Image

Image Image { get; set; }

Hodnota vlastnosti

Typ: System.Drawing.Image
Image Který je zobrazen na tlačítku.

Poznámky

Doporučená obrázek formátu PNG, totiž, že obrázky ve formátu PNG podporuje průhlednost pomocí alfa kanálu.

Image Vlastnost určuje obrázek, který se zobrazí v ovládacím prvku.Tuto vlastnost lze nastavit v době návrhu nebo za běhu.Pokud aktualizujete tuto vlastnost v době běhu, vzhled ovládacího prvku je aktualizován tak, aby odrážel změny.

Pokud Image vlastnost, OfficeImageId a ImageName jsou ignorovány vlastnosti.I když Image vlastnost vám dává větší kontrolu než dvě vlastnosti, může být pomalejší, protože objekt obrázek je odeslána do aplikace sady Office při každé aktualizaci ovládacího prvku.

ShowImage , Musí být vlastnost true pro ovládací prvek pro zobrazení obrazu.Při nastavení Image vlastnost v době návrhu aplikace Visual Studio automaticky nastaví ShowImage vlastnost true.Nastavíte-li Image vlastnost v době běhu, je nutné nastavit ShowImage vlastnost true ve vašem kódu.

Příklady

Následující příklad nastavuje Image vlastnost dvě tlačítka.Chcete-li spustit příklad kódu, musí nejprve provést následující kroky:

Přidat pásu karet (vizuální návrhář) položky do projektu vytvořeného pomocí nástrojů pro vývoj Office v sadě Visual Studio.
Přidání skupiny do vlastní kartu.
Dvě tlačítka přidáte do skupiny.
Přidejte dva obrazy zdrojů projektu.Další informace naleznete v tématu Jak: Přidání nebo odebrání zdrojů.

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

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.