Propriedade RibbonButton.Image

Artigo
08/01/2011

Obtém ou define a imagem que é exibida no botão.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)

Sintaxe

'Declaração
Property Image As Image
    Get
    Set

Image Image { get; set; }

Valor de propriedade

Tipo: System.Drawing.Image
Um Image que é exibido no botão.

Comentários

O formato de imagem recomendada é PNG, porque as imagens no formato PNG suportam transparência por meio de seus canais alfa.

O Image propriedade identifica uma imagem que é exibida pelo controle. Essa propriedade pode ser definida em tempo de design ou em tempo de execução. Se você atualizar essa propriedade em tempo de execução, a aparência do controle é atualizada para refletir a alteração.

Se a Image for definida, a OfficeImageId e ImageName propriedades são ignoradas. Embora o Image propriedade dá mais controle do que as duas propriedades, pode ser mais lenta porque o objeto de imagem é enviado ao aplicativo do Office sempre que o controle for atualizado.

O ShowImage a propriedade deve ser true para o controle para exibir a imagem. Ao definir o Image da propriedade em tempo de design, Visual Studio define automaticamente a ShowImage propriedade para true. Se você definir a Image a propriedade em tempo de execução, você deve definir o ShowImage propriedade para true em seu código.

Exemplos

O exemplo a seguir define o Image propriedade de dois botões. Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um a faixa de opções (Visual Designer) item a um projeto criado usando ferramentas de desenvolvimento do Office em Visual Studio.
Adicione um grupo à guia personalizada.
Adicione dois botões ao grupo.
Adicione duas imagens aos recursos do projeto. For more information, see Como: Adicionar ou remover recursos.

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;
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.