RibbonButton.Image – vlastnost

Článek
08/11/2011

Získá nebo nastaví bitová kopie 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
    Get
    Set

Image Image { get; set; }

Hodnota vlastnosti

Typ: System.Drawing.Image
Image , Je zobrazen na tlačítko.

Poznámky

Formát doporučený bitová kopie je PNG, protože obrázky ve formátu PNG podporuje transparentnost pomocí alfa verze kanál.

Image Vlastnost identifikuje obraz, který je zobrazen ovládací prvek. Tuto vlastnost lze nastavit v době návrhu nebo za běhu. Pokud aktualizace vlastnost při běhu vzhled ovládacího prvku je aktualizován, aby odrážel změny.

Pokud Image je nastavena OfficeImageId a ImageName Vlastnosti ignorovány. Ačkoli Image vlastnost poskytuje větší možnosti než dvě vlastnosti, může být pomalejší, protože objektu Bitová kopie je odeslána do aplikace Office při každé aktualizaci ovládacího prvku.

ShowImage Vlastnost musí být true ovládacího prvku zobrazení obrazu. Při nastavení Image vlastnost v návrhové aplikaci Visual Studio automaticky nastaví ShowImage Vlastnost true. Pokud nastavíte Image Vlastnost za běhu, je nutné nastavit ShowImage Vlastnost true v kódu.

Příklady

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

Přidat Pás karet (vizuální Návrhář) položka projekt vytvořený pomocí nástroje Office vývoj v Visual Studio.
Přidat na kartu vlastní skupinu.
Do skupinyPřidat dvě tlačítka.
Přidat dva obrazy zdrojů projekt . Další informace naleznete v tématu Postupy: Přidat nebo odebrat prostředky.

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.