Propriedade RibbonEditBox.ImageName
Obtém ou define o nome que você pode usar para identificar a imagem de LoadImage manipulador de eventos.
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 LoadImage o manipulador de eventos para identificar a imagem.
Comentários
Essa propriedade pode ser definida em tempo de execução somente sob certas condições. For more information, see Visão geral do modelo de objeto de faixa de opções.
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.
O ShowImage a propriedade deve ser true para o controle para exibir a imagem. Ao definir o ImageName da propriedade em tempo de design, Visual Studio define automaticamente a ShowImage propriedade para true. Se você definir a ImageName a propriedade em tempo de execução, você deve definir o ShowImage propriedade para true em 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