RibbonGallery.OfficeImageId – vlastnost

Článek
05/14/2013

Získá nebo nastaví obrázek zobrazit v ovládacím prvku, pokud chcete 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 Microsoft Office ikony dvě položky v ovládacím prvku galerie.

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í šablony projektu v aplikaci Visual Studio.
Přidání skupiny do vlastní kartu.
Do skupiny přidáte galerii.

Private Sub SetGalleryImage()
    Gallery1.OfficeImageId = "PersonaStatusOnline"
    Gallery1.ShowImage = True
End Sub

private void SetGalleryImage()
{
    gallery1.OfficeImageId = "PersonaStatusOnline";
    gallery1.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.