Propriedade RibbonDialogLauncher.ImageName
Obtém ou define um identificador que é usado para atribuir uma imagem a este RibbonDialogLauncher quando é adicionada à 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
string ImageName { get; set; }
Valor de propriedade
Tipo: System.String
Um identificador que é usado para atribuir uma imagem a este RibbonDialogLauncher quando é adicionada à barra de ferramentas de acesso rápido.
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 não tem efeito visível quando RibbonDialogLauncher é exibido em um grupo em fita.No entanto, quando um usuário RibbonDialogLauncher adicionar à barra de ferramentas de acesso rápido, controles desta propriedade comportamento de imagem que é mostrada, a menos que a propriedade de Image ou de OfficeImageId também é definida.
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.
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