Evento RibbonBase.LoadImage
Ocorre quando o RibbonBase carrega, se a ImageName propriedade é 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 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.
Exemplos
O exemplo a seguir armazena em cache as imagens de dois RibbonButton controles.
Para executar este exemplo de código, realize as seguintes etapas:
Adicionar um a faixa de opções (Visual Designer) a um projeto do Office.
Se você estiver usando um projeto de Visual Basic, adicione a instrução a seguir na parte superior do arquivo de código da faixa de opções: Imports Microsoft.Office.Tools.Ribbon
Em seguida, você pode executar esse código na classe gerada da faixa de opções.
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.