Evento RibbonBase.LoadImage
Ocorre quando RibbonBase carregar, se a propriedade de ImageName é definida para um ou mais controles.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v4.0.Utilities (em Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Sintaxe
'Declaração
Public Event LoadImage As RibbonLoadImageEventHandler
public event RibbonLoadImageEventHandler LoadImage
Comentários
O evento de LoadImage permite que você armazene em cache imagens a personalização de fita, que pode melhorar o desempenho.
Por padrão, uma imagem é carregada em fita sempre que o usuário exibe um guia que contém a imagem.Uma imagem é recarregada em qualquer momento que você modifique programaticamente as propriedades de um controle em que a imagem aparece.
Use o evento de LoadImage para atribuir uma imagem a um controle.Quando o usuário seleciona uma guia em fita, o aplicativo do Microsoft Office usa a imagem armazenada em cache.Se você alterar uma propriedade do controle em tempo de execução, o aplicativo do Microsoft Office a imagem não recarregado no controle.Isso pode exercer um ganho pequeno de desempenho.
Se você desejar armazenar em cache a imagem de um controle, defina a propriedade de ImageName do controle.O evento de LoadImage não é gerado a menos que você defina a propriedade de ImageName pelo menos de um controle.
Exemplos
O exemplo também as imagens para dois controles de RibbonButton .
Para executar este exemplo de código, primeiro você deve executar as seguintes etapas:
Adicione Faixa de Opções (Visual Designer) a um projeto do Office.
Se você estiver usando um projeto Visual Basic, adicione a seguinte instrução à parte superior do arquivo de código de fita: Imports Microsoft.Office.Tools.Ribbon
Você pode então executar esse código na classe gerada de fita.
Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)
Select Case e.ImageName
Case "Button1Image"
e.Image = My.Resources.Image1
Case "Button2Image"
e.Image = My.Resources.Image2
End Select
End Sub
private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
switch (e.ImageName)
{
case "Button1Image":
e.Image = Properties.Resources.Image1;
break;
case "Button2Image":
e.Image = Properties.Resources.Image2;
break;
}
}
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.