RibbonToggleButton.ImageName – vlastnost

Článek
01/03/2014

Získá nebo nastaví název používaný v LoadImage obslužnou rutinu události pro identifikaci obrázku pro ovládací prvek.

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 obrázku pro ovládací prvek.

Poznámky

ImageName Vlastnost určuje obrázek, který se zobrazí v ovládacím prvku.Office aplikace načte 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 při načtení obrazu identifikuje LoadImage události.LoadImageje vyvolána pouze jednou na název obrázku, když je zobrazena na pásu karet.Poté ovládací prvek obrázek nelze změnit 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 objektu k obrázku, který chcete načíst.

Tato vlastnost je ignorována, pokud Image vlastnost nebo OfficeImageId je vlastnost nastavena.Obrázky, které jsou označeny ImageName vlastnosti lze načíst mírně vyšší výkon než obrazy, které jsou označeny Image vlastnost, protože aplikace Office načte obrázek z vašeho řešení pouze první čas 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 za 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í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.
Dvě tlačítka přidáte do skupiny.
Dva obrázky přidáte do zdrojů projektu.Další informace naleznete v tématu Jak: Přidání nebo odebrání zdrojů.

Tento kód pak můžete spustit 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.