Propriedade RibbonEditBox.Image

Obtém ou define a imagem que é exibida na caixa de ediçã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 na caixa de ediçã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.

Segurança do .NET Framework

Consulte também

Referência

RibbonEditBox Interface

Namespace Microsoft.Office.Tools.Ribbon

Outros recursos

Visão geral do modelo de objeto de faixa de opções