Propriedade RibbonSplitButton.ImageName
Obtém ou define o nome que você pode usar o E:Microsoft.Office.Tools.Ribbon.LoadImage o manipulador de eventos para identificar uma imagem para o controle.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)
Sintaxe
'Declaração
Property ImageName As String
Get
Set
string ImageName { get; set; }
Valor de propriedade
Tipo: System.String
Uma seqüência de caracteres que você pode usar o E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage o manipulador de eventos para identificar uma imagem para o controle.
Comentários
O ImageName propriedade identifica uma imagem que é exibida pelo controle. O aplicativo do Office recupera essa imagem de sua solução apenas uma vez, para melhorar o desempenho. Essa propriedade pode ser definida apenas em tempo de design, porque a imagem que ele identifica é carregada durante a LoadImage de evento. LoadImageé gerado apenas uma vez por nome da imagem, quando a faixa de opções é exibida. Depois disso, a imagem do controle não pode ser alterada usando essa propriedade.
Para carregar a imagem, adicione código para o LoadImage manipulador de eventos. Verifique o ImageName propriedade da RibbonLoadImageEventArgs e defina a Image propriedade da RibbonLoadImageEventArgs objeto para a imagem que você deseja carregar.
Esta propriedade é ignorada se a Image propriedade ou o OfficeImageId propriedade é definido. Imagens identificadas pelo ImageName propriedade pode ser carregada ligeiramente mais rápido do que imagens identificadas pelo Image propriedade, porque o aplicativo do Office recupera a imagem de seu tempo de solução somente a primeira a faixa de opções é exibida.
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