Właściwość RibbonButton.Image —

Artykuł
05/08/2013

Pobiera lub ustawia obraz, który jest wyświetlany na przycisku.

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

Składnia

'Deklaracja
Property Image As Image

Image Image { get; set; }

Wartość właściwości

Typ: System.Drawing.Image
Image Który jest wyświetlany na przycisku.

Uwagi

Format obrazu zalecane jest PNG, ponieważ obrazy w formacie PNG obsługuje przezroczystość poprzez ich kanałem alfa.

Image Właściwość identyfikuje obraz, który jest wyświetlany przez formant.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.

Jeśli Image właściwość jest ustawiona, OfficeImageId i ImageName właściwości są ignorowane.Chociaż Image właściwość umożliwia lepszą kontrolę niż inne właściwości, może działać wolniej, ponieważ obiekt obraz jest wysyłane do aplikacji pakietu Office, za każdym razem, gdy formant jest aktualizowana.

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

Przykłady

W poniższym przykładzie Image właściwość dwa przyciski.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ć dwa przyciski do grupy.
Dodać dwa obrazy do zasobów projektu.Aby uzyskać więcej informacji, zobacz Jak: Dodawanie lub usuwanie zasobów.

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

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..