RibbonMenu.ImageName A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define o nome que você pode usar no LoadImage evento manipulador para identificar uma imagem para o menu.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxe

Public Property ImageName As String

Dim instance As RibbonMenu
Dim value As String

value = instance.ImageName

instance.ImageName = value

public string ImageName { get; set; }

Valor de propriedade

Tipo: System.String
O nome que você pode usar no LoadImage manipulador de eventos para identificar uma imagem para o menu.

Comentários

The ImageName propriedade identifica uma imagem que é exibida pelo controle. O aplicativo recupera a essa imagem de sua solução apenas uma vez, para melhorar o desempenho.Esta propriedade pode ser conjunto somente em time de design, como a imagem identifica é carregado durante o LoadImage evento. LoadImage é disparado somente uma vez por nome de 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 das RibbonLoadImageEventArgs e conjunto o Image propriedade das RibbonLoadImageEventArgs objeto para a imagem que você deseja carregar.

Esta propriedade é ignorada se a Image propriedade ou o OfficeImageId propriedade é conjunto. Imagens identificadas pelo ImageName propriedade pode ser carregada ligeiramente mais rápido do que imagens identificadas pela Image propriedade, porque o aplicativo recupera a imagem do seu time de solução somente o primeiro a faixa de opções é exibida.

The ShowImage propriedade deve ser true para o controle exibir a imagem. Ao conjunto o ImageName propriedade pelo time de design, Visual Studio Tools for Office define automaticamente a ShowImage propriedade para true. Se você conjunto o ImageName propriedade em time de execução, você deve conjunto o ShowImage propriedade para true em seu código.

Permissões

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ódigos parcialmente Confiável.