Partilhar via


RibbonMenu.OfficeImageId A propriedade (sistema de 2007)

Obtém ou define a imagem a ser exibida no menu, se você quiser usar um ícone do Microsoft Office interno.

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

Sintaxe

Public Property OfficeImageId As String

Dim instance As RibbonMenu
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value
public string OfficeImageId { get; set; }

Valor de propriedade

Tipo: System.String
A ID de um ícone do Microsoft Office interna que serve sistema autônomo o ícone desse menu.

Comentários

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

Para obter uma lista de imageMso valores, consulte a página do centralizar de baixar da Microsoft Suplemento do 2007 office sistema: Http://go.microsoft.com/fwlink/?LinkId=93525 ícones galeria.

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

The ShowImage propriedade deve ser true para o controle exibir a imagem. Ao conjunto o OfficeImageId propriedade pelo time de design, Visual Studio Tools for Office define automaticamente a ShowImage propriedade para true. Se você conjunto o OfficeImageId propriedade em time de execução, você deve conjunto o ShowImage propriedade para true em seu código.

Exemplos

O exemplo a seguir atribui um ícone do Microsoft Office a um menu.

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

  1. Adicionar um Faixa de opções (Visual Designer) item to a Visual Studio Tools for Office projeto.

  2. Adicione um agrupar à guia personalizada.

  3. Adicione um menu ao agrupar.

  4. conjunto o Dinâmico propriedade do menu para true.

PrivateSub SetMenuImage()
    Menu1.OfficeImageId = "HighImportance"
    Menu1.ShowImage = TrueEndSub
privatevoid SetMenuImage()
{
    menu1.OfficeImageId = "HighImportance";
    menu1.ShowImage = true;
}

Permissões

Consulte também

Referência

RibbonMenu Classe

Membros RibbonMenu

Namespace Microsoft.Office.Tools.Ribbon