Właściwość RibbonButton.OfficeImageId —

Artykuł
01/08/2014

Pobiera lub ustawia obraz wyświetlany na przycisku, jeśli chcesz użyć wbudowanego ikonę 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
Identyfikator wbudowanego ikonę programu Microsoft Office, która służy jako ikony dla tego formantu.

Uwagi

OfficeImageId Właściwość identyfikuje ikona pakietu Office jest wyświetlany przez formant.Wartość właściwości jest ciągiem, który określa imageMso wartość zaznaczona ikona.Tej właściwości można ustawić w czasie projektowania i w czasie wykonywania.Po zaktualizowaniu tej właściwości w czasie wykonywania, wygląd formantu jest aktualizowany w celu odzwierciedlenia zmian.

Aby uzyskać listę imageMso wartości, można znaleźć na stronie Microsoft Download Center 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ść, które mogą być ładowane nieco szybciej niż obrazy identyfikowane przez Image właściwość, ponieważ obrazy są buforowane w aplikacji pakietu Office.

ShowImage Właściwość musi być true do kontroli w celu wyświetlania obrazu.Podczas ustawiania OfficeImageId automatycznie ustawia właściwość w czasie projektowania programu Visual Studio ShowImage właściwość, aby true.Jeśli ustawisz OfficeImageId właściwość w czasie wykonywania, należy ustawić ShowImage właściwość, aby true w kodzie.

Przykłady

W poniższym przykładzie przypisuje ikona Microsoft Office do przycisku.

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

Dodaj wstążki (wizualnego projektowania) element do projektu utworzone za pomocą narzędzi programistycznych pakietu Office w programie Visual Studio.
Dodaj grupę na karcie niestandardowe.
Dodawanie przycisku do grupy.
Ustaw (nazwa) właściwości przycisku, aby mySaveButton.

Private Sub SetButtonImage()
    mySaveButton.OfficeImageId = "FileSave"
    mySaveButton.ShowImage = True
End Sub

private void SetButtonImage()
{
    mySaveButton.OfficeImageId = "FileSave";
    mySaveButton.ShowImage = true;
}

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 Używanie bibliotek pochodzących z częściowo zaufanego kodu.