Propriedade RibbonGallery.ImageName
Obtém ou define o nome que você pode usar para identificar RibbonGallery no manipulador de eventos de LoadImage .
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)
Sintaxe
'Declaração
Property ImageName As String
string ImageName { get; set; }
Valor de propriedade
Tipo: System.String
Uma cadeia de caracteres que você possa usar no manipulador de eventos de LoadImage para identificar RibbonGallery.
Comentários
Esta propriedade pode ser definida em tempo de execução somente sob certas condições.Para obter mais informações, consulte Visão geral do modelo de objeto de faixa de opções.
A propriedade de ImageName identifica uma imagem que é exibido pelo controle.O aplicativo do Office recupera esta imagem de sua solução somente uma vez, para melhorar o desempenho.Esta propriedade pode ser definida somente em tempo de design, porque a imagem que identifica é carregado durante o evento de LoadImage .LoadImage é gerado apenas uma vez pelo nome de imagem, quando a fita é exibida.Após o, a imagem do controle não pode ser modificada usando a propriedade.
Para carregar a imagem, adicione código ao manipulador de eventos de LoadImage .Verifique a propriedade de ImageName de RibbonLoadImageEventArgs e defina a propriedade de Image do objeto de RibbonLoadImageEventArgs para a imagem que você deseja carregar.
Esta propriedade é ignorada se a propriedade de Image ou a propriedade de OfficeImageId são definidas.Imagens identificadas pela propriedade de ImageName podem ser carregadas ligeiramente mais rápido do que as imagens identificadas pela propriedade de Image , porque o aplicativo do Office recupera a imagem de sua solução somente na primeira vez a fita são exibidas.
A propriedade de ShowImage deve ser true para que o controle exiba a imagem.Quando você define a propriedade de ImageName em tempo de design, o Visual Studio automaticamente definir a propriedade de ShowImage a true.Se você definir a propriedade de ImageName em tempo de execução, você deve definir a propriedade de ShowImage a true no seu código.
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