RibbonButton.Image – vlastnost

Článek
01/03/2014

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

Image Image { get; set; }

Hodnota vlastnosti

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

Poznámky

Doporučené obrazový formát je PNG, obrázky ve formátu PNG nepodporují 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 za běhu, projeví se změna při aktualizaci vzhled ovládacího prvku.

Pokud Image je nastavena OfficeImageId a ImageName vlastnosti ignorovány.I když Image vlastnost poskytuje větší kontrolu 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 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 za 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íte nejprve provést následující kroky:

Přidat pásu karet (vizuální návrhář) položku do projektu vytvořeného pomocí vývojářských nástrojů sady Office v aplikaci Visual Studio.
Přidání skupiny do vlastní karty.
Dvě tlačítka přidáte do skupiny.
Dva obrázky přidáte do 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.