RibbonToggleButton.OfficeImageId – vlastnost

Článek
01/03/2014

Získá nebo nastaví obrázek zobrazit na RibbonToggleButton, 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 Office ikonu, která se zobrazí v ovládacím prvku.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 za běhu, projeví se změna při aktualizaci vzhled ovládacího prvku.

Seznam imageMso hodnoty, naleznete na stránce Microsoft Download Center Add-In systém 2010 Office: Galerie ikon.

Tato vlastnost je ignorována, pokud Image je vlastnost nastavena.Obrázky, které jsou označeny OfficeImageId vlastnosti lze načíst 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í 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 přiřazuje aplikace Microsoft Office ikonu do nabídky.

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 Office project.
Přidání skupiny do vlastní karty.
Přepínací tlačítko přidáte do skupiny.

Private Sub SetToggleButtonImage()
    ToggleButton1.OfficeImageId = "PersonaStatusOnline"
    ToggleButton1.ShowImage = True
End Sub

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