Partilhar via


Propriedade RibbonComboBox.Image

Obtém ou define uma imagem é exibido nesta RibbonComboBox.

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
A imagem é exibida nesta RibbonComboBox.

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.

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

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

RibbonComboBox Interface

Namespace Microsoft.Office.Tools.Ribbon

Outros recursos

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