RibbonButton.OfficeImageId – vlastnost

Článek
05/14/2013

Získá nebo nastaví obrázek zobrazit na tlačítko, chcete-li použít integrovanou ikonu Microsoft Office.

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

Syntaxe

'Deklarace
Property OfficeImageId As String

string OfficeImageId { get; set; }

Hodnota vlastnosti

Typ: System.String
ID integrovanou ikonu Microsoft Office, která slouží jako ikonu pro tento ovládací prvek.

Poznámky

OfficeImageId Vlastnost určuje ikonu Office zobrazený ovládacím prvkem.Hodnota vlastnosti je řetězec, který identifikuje imageMso hodnotu vybrané ikony.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.

Seznam imageMso hodnoty, naleznete na stránce Microsoft Download Center doplněk Office 2010: Galerie ikon.

Tato vlastnost je ignorována, pokud Image vlastnost.Obrázky, které jsou označeny OfficeImageId vlastností, které mohou být načteny mírně vyšší výkon než obrazy, které jsou označeny Image vlastnost, protože obrazy jsou ukládány do mezipaměti v aplikaci sady Office.

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

Příklady

Následující příklad přiřazuje ikonu Microsoft Office k tlačítku.

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.
Přidání tlačítka do skupiny.
Nastavit (název) vlastnosti tlačítka na mySaveButton.

Private Sub SetButtonImage()
    mySaveButton.OfficeImageId = "FileSave"
    mySaveButton.ShowImage = True
End Sub

private void SetButtonImage()
{
    mySaveButton.OfficeImageId = "FileSave";
    mySaveButton.ShowImage = true;
}

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.