Propriedade RibbonButton.Image

Artigo
05/21/2013

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

Image Image { get; set; }

Valor de propriedade

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

Comentários

O formato de imagem recomendado é PNG, como imagens no formato PNG oferecem suporte à transparência através do canal alfa.

A propriedade de Image identifica uma imagem que é exibido pelo controle.Esta propriedade pode ser definida em tempo de design ou em tempo de execução.Se você atualizar esta propriedade em tempo de execução, a aparência do controle é atualizado para refletir a alteração.

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

A propriedade de ShowImage deve ser true para que o controle exiba a imagem.Quando você define a propriedade de Image em tempo de design, o Visual Studio automaticamente definir a propriedade de ShowImage a true.Se você definir a propriedade de Image em tempo de execução, você deve definir a propriedade de ShowImage a true no seu código.

Exemplos

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

Adicionar um item de Faixa de Opções (Visual Designer) a um projeto criado usando ferramentas de desenvolvimento do Office no Visual Studio.
Adicione um grupo para a guia personalizado.
Adicione dois botões ao grupo.
Adicionar duas imagens aos recursos do projeto.Para obter mais informações, consulte 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.