Propriedade RibbonDialogLauncher.ImageName
Obtém ou define um identificador que é usado para atribuir uma imagem ao RibbonDialogLauncher quando ele é adicionado à barra de ferramentas de acesso rápido.
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
Um identificador que é usado para atribuir uma imagem ao RibbonDialogLauncher quando ele é adicionado à barra de ferramentas de acesso rápido.
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 não tem efeito visível quando o RibbonDialogLauncher é exibido em um grupo na faixa de opções. No entanto, quando um usuário adiciona um RibbonDialogLauncher na barra de ferramentas de acesso rápido, essa propriedade controla o comportamento da imagem que é mostrado, a menos que o Image ou OfficeImageId propriedade é também definido.
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
RibbonDialogLauncher Interface
Namespace Microsoft.Office.Tools.Ribbon