RibbonButton.OfficeImageId – vlastnost

Článek
08/11/2011

Získá nebo nastaví bitová kopie zobrazit na tlačítku, pokud chcete použít předdefinovaný ikonu systém 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
    Get
    Set

string OfficeImageId { get; set; }

Hodnota vlastnosti

Typ: System.String
ID předdefinované systém Microsoft Office ikonu, která slouží jako ikonu pro tento ovládací prvek.

Poznámky

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

Seznam imageMso hodnoty, naleznete na stránce Microsoft Download Center systému Office 2007 Přidat-V: Galerie ikon.

Tato vlastnost je ignorována, pokud Image je vlastnost nastavit. Obrázky označeny OfficeImageId Vlastnosti lze načíst mírně rychlejší než obrázky označeny Image vlastnost, protože obrazy jsou uložené v aplikaci sady Office.

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

Příklady

Následující příklad přiřadí systém Microsoft Office ikonu 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.
Přidat tlačítko do skupiny.
Nastavit (Název) vlastnost tlačítko 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.