Właściwość RibbonButton.OfficeImageId —

Artykuł
05/08/2013

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

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.

ShowImage Właściwość musi być true do celów 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

Poniższy przykład przypisuje ikonę programu Microsoft Office do przycisku.

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.
Dodać przycisk do grupy.
Ustaw (nazwa) właściwość przycisk, 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 Przy użyciu bibliotek z częściowo zaufanego kodu..