RibbonSplitButton.ImageName Propriedade

Definição

Namespace:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

Obtém ou define o nome que você pode usar no manipulador de eventos E:Microsoft.Office.Tools.Ribbon.LoadImage para identificar uma imagem para o controle.

public:
 property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };

public string ImageName { get; set; }

member this.ImageName : string with get, set

Public Property ImageName As String

Valor da propriedade

String

Uma cadeia de caracteres que você pode usar no manipulador de eventos E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage para identificar uma imagem para o controle.

Comentários

A ImageName propriedade identifica uma imagem exibida pelo controle . O aplicativo do Office recupera essa imagem da solução apenas uma vez para melhorar o desempenho. Esta propriedade só pode ser definida em tempo de design, porque a imagem que ela identifica é carregada durante o evento LoadImage. LoadImage só é acionado uma vez por nome da imagem, quando a Faixa de Opções é exibida. Depois disso, a imagem de controle não pode ser modificada usando-se essa propriedade.

Para carregar a imagem, adicione o código ao manipulador de eventos LoadImage. Verifique a propriedade ImageName do RibbonLoadImageEventArgs e defina a propriedade Image do objeto RibbonLoadImageEventArgs como a imagem que você deseja carregar.

Essa propriedade será ignorada se a Image propriedade ou a OfficeImageId propriedade estiver definida. As imagens identificadas pela ImageName propriedade podem ser carregadas um pouco mais rapidamente do que as Image imagens identificadas pela propriedade, pois o aplicativo do Office recupera a imagem da sua solução apenas na primeira vez que a Faixa de Opções é exibida.