Partilhar via


Propriedade RibbonDropDownItem.OfficeImageId

Obtém ou define a imagem para exibir em RibbonDropDownItem, se você desejar usar um ícone interno do Microsoft Office.

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

Sintaxe

'Declaração
Property OfficeImageId As String
string OfficeImageId { get; set; }

Valor de propriedade

Tipo: System.String
A imagem para exibir em RibbonDropDownItem, se você desejar usar um ícone interno do Microsoft Office.

Comentários

A propriedade de OfficeImageId identifica um ícone do Office que é exibido pelo controle.O valor da propriedade é uma cadeia de caracteres que identifica o valor de imageMso de ícone selecionado.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.

Para obter uma lista de valores de imageMso , consulte a página Suplemento ao Office: 2010 Galeria de íconesdo Microsoft Download Center.

Esta propriedade é ignorada se a propriedade de Image é definida.Imagens identificadas pela propriedade de OfficeImageId podem ser carregadas ligeiramente mais rápido do que as imagens identificadas pela propriedade de Image , como imagens são armazenadas em cache no aplicativo do Office.

Exemplos

O exemplo a seguir atribui ícones do Microsoft Office a dois itens em uma caixa suspensa.

Para executar este exemplo de código, primeiro você deve executar as seguintes etapas:

  1. Adicionar um item de Faixa de Opções (Visual Designer) a um projeto criado usando ferramentas de desenvolvimento do Office no Visual Studio.

  2. Adicione um grupo para a guia personalizado.

  3. Adicione uma caixa suspensa ao grupo.

Private Sub PopulateDropDown()
    Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status1.Label = "Away"
    status1.OfficeImageId = "PersonaStatusAway"
    DropDown1.Items.Add(status1)
    Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status2.Label = "Online"
    status2.OfficeImageId = "PersonaStatusOnline"
    DropDown1.Items.Add(status2)
End Sub
private void PopulateDropDown()
{
    RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
    status1.Label = "Away";
    status1.OfficeImageId = "PersonaStatusAway";
    dropDown1.Items.Add(status1);
    RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
    status2.Label = "Online";
    status2.OfficeImageId = "PersonaStatusOnline";
    dropDown1.Items.Add(status2);
}

Segurança do .NET Framework

Consulte também

Referência

RibbonDropDownItem Interface

Namespace Microsoft.Office.Tools.Ribbon

Outros recursos

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