Propriedade RibbonDropDown.OfficeImageId
Obtém ou define a imagem para exibir em RibbonDropDown, 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 identificação de um ícone interno do Microsoft Office que serve como o ícone para esse controle.
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.
A propriedade de ShowImage deve ser true para que o controle exiba a imagem.Quando você define a propriedade de OfficeImageId em tempo de design, o Visual Studio automaticamente definir a propriedade de ShowImage a true.Se você definir a propriedade de OfficeImageId em tempo de execução, você deve definir a propriedade de ShowImage a true no seu código.
Exemplos
O exemplo a seguir atribui um ícone do Microsoft Office a uma caixa suspensa.
Para executar este exemplo de código, primeiro você deve executar as seguintes etapas:
Adicionar um item de Faixa de Opções (Visual Designer) a um projeto do Office.
Adicione um grupo para a guia personalizado.
Adicione uma caixa suspensa ao grupo.
Private Sub SetDropDownImage()
DropDown1.OfficeImageId = "FilterToggleFilter"
DropDown1.ShowImage = True
End Sub
private void SetDropDownImage()
{
dropDown1.OfficeImageId = "FilterToggleFilter";
dropDown1.ShowImage = true;
}
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.
Consulte também
Referência
Namespace Microsoft.Office.Tools.Ribbon