Compartilhar via


Evento OfficeRibbon.LoadImage

Ocorre quando o OfficeRibbon carrega, se a ImageName propriedade é definida para um ou mais controles.

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

Sintaxe

'Declaração
Event LoadImage As RibbonLoadImageEventHandler
event RibbonLoadImageEventHandler LoadImage

Comentários

O LoadImage evento permite imagens de cache na personalização da faixa de opções, que pode melhorar o desempenho.

Por padrão, uma imagem é carregada na faixa de opções sempre que o usuário exibe uma guia que contém a imagem. Uma imagem é recarregada sempre que você alterar programaticamente as propriedades de um controle no qual a imagem é exibida.

Use o LoadImage o evento para atribuir uma imagem para um controle. Quando o usuário seleciona uma guia da faixa de opções, o aplicativo de Microsoft Office usa a imagem em cache. Se você modificar uma propriedade de controle em tempo de execução, o aplicativo de Microsoft Office não recarregue a imagem no controle. Isso pode lhe dar um ganho de desempenho pequeno.

Se você desejar armazenar em cache a imagem de um controle, defina a ImageName a propriedade do controle. O LoadImage evento não é aumentado, a menos que você defina a ImageName propriedade de pelo menos um controle.

Segurança do .NET Framework

Consulte também

Referência

OfficeRibbon Interface

Namespace Microsoft.Office.Tools.Ribbon