RibbonGallery.OfficeImageId Propriedade

Definição

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

public string OfficeImageId { get; set; }

Valor da propriedade

String

O ID de um ícone do Microsoft Office interno que serve como o ícone desse controle.

Exemplos

O exemplo a seguir atribui Microsoft Office ícones a dois itens em um controle galeria.

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 criado usando modelos de projeto do Office no Visual Studio.

  2. Adicione um grupo à guia personalizada.

  3. Adicione uma galeria ao grupo.

private void SetGalleryImage()
{
    gallery1.OfficeImageId = "PersonaStatusOnline";
    gallery1.ShowImage = true;
}
Private Sub SetGalleryImage()
    Gallery1.OfficeImageId = "PersonaStatusOnline"
    Gallery1.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