RibbonMenu.OfficeImageId Propriedade

Definição

Obterá ou definirá a imagem a ser exibida no menu, se você quiser usar um ícone interno do Microsoft Office.

public string OfficeImageId { get; set; }

Valor da propriedade

String

A ID de um ícone do Microsoft Office interno que serve como ícone desse menu.

Exemplos

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

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

  1. Adicione um item da faixa de Ribbon (designer visual) a um projeto do Office.

  2. Adicione um grupo à guia personalizada.

  3. Adicione um menu ao grupo.

  4. Defina a propriedade dinâmica do menu como true .

private void SetMenuImage()
{
    menu1.OfficeImageId = "HighImportance";
    menu1.ShowImage = true;
}
Private Sub SetMenuImage()
    Menu1.OfficeImageId = "HighImportance"
    Menu1.ShowImage = True
End Sub

Comentários

A OfficeImageId propriedade identifica um ícone do Office que é exibido pelo controle. O valor da propriedade é uma cadeia de caracteres que identifica o valor imageMso do ícone selecionado. Esta propriedade pode ser definida em tempo de design ou em tempo de execução. Caso você atualize 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 Office 2010 suplemento: Galeria de ícones.

Essa propriedade será ignorada se a Image propriedade estiver definida. As imagens identificadas pela OfficeImageId propriedade podem ser carregadas ligeiramente mais rápido que as imagens identificadas pela Image propriedade, pois as imagens são armazenadas em cache no aplicativo do Office.

A ShowImage propriedade deve ser true para o controle exibir a imagem. Quando você define a OfficeImageId propriedade em tempo de design, o Visual Studio define automaticamente a ShowImage propriedade como true . Se você definir a OfficeImageId propriedade em tempo de execução, deverá definir a ShowImage propriedade como true em seu código.

Aplica-se a