RibbonButton.ImageName – vlastnost

Článek
05/14/2013

Získá nebo nastaví název používaný pro identifikaci tlačítka v LoadImage obslužnou rutinu události.

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

Syntaxe

'Deklarace
Property ImageName As String

string ImageName { get; set; }

Hodnota vlastnosti

Typ: System.String
Řetězec, který lze použít v LoadImage obslužnou rutinu události pro identifikaci tlačítka.

Poznámky

Tuto vlastnost lze nastavit v době běhu, pouze za určitých podmínek.Další informace naleznete v tématu Přehled modelu objektu pásu karet.

Informace o nastavení této vlastnosti naleznete v tématu Přehled modelu objektu pásu karet.

ImageName Vlastnost určuje obrázek, který se zobrazí v ovládacím prvku.Office aplikace načte tento obrázek z vašeho řešení pouze jednou ke zlepšení výkonu.Tuto vlastnost lze nastavit pouze v době návrhu, protože obraz identifikuje je načítán během LoadImage události.LoadImageje vyvolána pouze jednou na název obrázku, když se zobrazí na pásu karet.Po tomto nelze změnit ovládací prvek obrázek pomocí této vlastnosti.

K načtení obrázku, přidejte kód, který LoadImage obslužnou rutinu události.Kontrola ImageName vlastnost RibbonLoadImageEventArgs a Image vlastnost RibbonLoadImageEventArgs objekt k obrázku, který chcete načíst.

Tato vlastnost je ignorována, pokud buď Image vlastnost nebo OfficeImageId vlastnost.Obrázky, které jsou označeny ImageName vlastností, které mohou být načteny mírně vyšší výkon než obrazy, které jsou označeny Image vlastnost, protože aplikace Office načte obraz z vašeho řešení pouze první čas na pásu karet se zobrazí.

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

Příklady

Následující příklad uloží obrazy pro dvě tlačítka.

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.
Dvě tlačítka přidáte do skupiny.
Přidejte dva obrazy zdrojů projektu.Další informace naleznete v tématu Jak: Přidání nebo odebrání zdrojů.

Pak spuštěním tohoto kódu v generované třídy pásu karet.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal e As RibbonLoadImageEventArgs)
    Select Case e.ImageName
        Case "Button1Image"
            e.Image = My.Resources.Image1
        Case "Button2Image"
            e.Image = My.Resources.Image2
    End Select
End Sub

private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
    switch (e.ImageName)
    {
        case "Button1Image":
            e.Image = Properties.Resources.Image1;
            break;
        case "Button2Image":
            e.Image = Properties.Resources.Image2;
            break;
    }
}

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.