Propriedade RibbonDropDownItem.OfficeImageId

Artigo
08/01/2011

Obtém ou define a imagem para exibir o RibbonDropDownItem, se você desejar usar um ícone de Microsoft Office internos.

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

Sintaxe

'Declaração
Property OfficeImageId As String
    Get
    Set

string OfficeImageId { get; set; }

Valor de propriedade

Tipo: System.String
A imagem para exibir o RibbonDropDownItem, se você desejar usar um ícone de Microsoft Office internos.

Comentários

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

Para obter uma lista de imageMso valores, consulte a página do Centro de Download da Microsoft Add-In do 2007 Office System: Galeria de ícones.

Esta propriedade é ignorada se a Image propriedade é definido. Imagens identificadas pelo OfficeImageId propriedade pode ser carregada ligeiramente mais rápido do que imagens identificadas pelo Image propriedade, porque as imagens são armazenadas em cache no aplicativo Office.

Exemplos

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

Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um a faixa de opções (Visual Designer) item a um projeto criado usando ferramentas de desenvolvimento do Office em Visual Studio.
Adicione um grupo à guia personalizada.
Adicione uma caixa suspensa para o 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

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.