RibbonButton.Image A propriedade (sistema de 2007)

Artigo
08/25/2010

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

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

Sintaxe

Public Property Image As Image

Dim instance As RibbonButton
Dim value As Image

value = instance.Image

instance.Image = value

public Image Image { get; set; }

Valor de propriedade

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

Comentários

O formato de imagem recomendada é PNG, como imagens no formato PNG oferecem suporte a transparência por meio de seu canal alfa.

The Image propriedade identifica uma imagem que é exibida pelo controle. Esta propriedade pode ser conjunto em time de design ou em time de execução.Se você atualizar essa propriedade em time de execução, a aparência do controle é atualizada para refletir a alterar.

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

The ShowImage propriedade deve ser true para o controle exibir a imagem. Ao conjunto o Image propriedade pelo time de design, Visual Studio Tools for Office define automaticamente a ShowImage propriedade para true. Se você conjunto o Image propriedade em time de execução, você deve conjunto 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 Faixa de opções (Visual Designer) item to a Visual Studio Tools for Office projeto.
Adicione um agrupar à guia personalizada.
Adicione dois botões ao agrupar.
Adicione duas imagens para os recursos do projeto.Para obter mais informações, consulte Como: Adicionar ou remover recursos.

PrivateSub LoadImages()
    button1.ShowImage = True
    CustomerButton.ShowImage = True
    Button1.Image = My.Resources.Image1
    CustomerButton.Image = My.Resources.Image2
EndSub

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

Permissões

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ódigos parcialmente Confiável.