Właściwość RibbonDropDownItem.OfficeImageId —

Artykuł
05/08/2013

Pobiera lub ustawia obraz wyświetlany na RibbonDropDownItem, aby użyć wbudowanego ikony programu Microsoft Office.

Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
Property OfficeImageId As String

string OfficeImageId { get; set; }

Wartość właściwości

Typ: System.String
Obraz wyświetlany na RibbonDropDownItem, aby użyć wbudowanego ikony programu Microsoft Office.

Uwagi

OfficeImageId Właściwość identyfikuje ikonę pakietu Office, który jest wyświetlany przez formant.Wartość właściwości jest ciągiem, który identyfikuje imageMso wartość zaznaczona ikona.Ta właściwość zestaw w czasie projektowania lub w czasie wykonywania.Jeżeli ta właściwość zostanie zaktualizowany w czasie wykonywania, wygląd formantu zostanie uaktualniony na odpowiednio się zmieni.

Aby uzyskać listę imageMso wartości, zobacz stronę Microsoft Download Center pakietu Office 2010 Add-In: Galeria ikony.

Ta właściwość jest ignorowana, jeśli Image właściwość jest ustawiona.Obrazy, identyfikowane przez OfficeImageId właściwości, które mogą być ładowane nieco szybciej niż obrazy, identyfikowane przez Image właściwość, ponieważ obrazy są buforowane w aplikacji pakietu Office.

Przykłady

Poniższy przykład przypisuje dwie pozycje w polu rozwijanym ikony programu Microsoft Office.

Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodać wstążki (Visual Designer) element, aby projekt utworzony przy użyciu narzędzia programowania pakietu Office w programie Visual Studio.
Dodaj grupę do karty niestandardowe.
Dodaj menu rozwijanym do grupy.

Private Sub PopulateDropDown()
    Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status1.Label = "Away"
    status1.OfficeImageId = "PersonaStatusAway"
    DropDown1.Items.Add(status1)
    Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status2.Label = "Online"
    status2.OfficeImageId = "PersonaStatusOnline"
    DropDown1.Items.Add(status2)
End Sub

private void PopulateDropDown()
{
    RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
    status1.Label = "Away";
    status1.OfficeImageId = "PersonaStatusAway";
    dropDown1.Items.Add(status1);
    RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
    status2.Label = "Online";
    status2.OfficeImageId = "PersonaStatusOnline";
    dropDown1.Items.Add(status2);
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..