Evento OfficeRibbon.LoadImage (sistema de 2007)
Ocorre quando o OfficeRibbon é carregado, se a ImageNamepropriedade é conjunto para um ou mais controles.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)
Sintaxe
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)
AddHandler instance.LoadImage, handler
[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> LoadImage
Comentários
The LoadImage evento permite que a cache de imagens a personalização da faixa de opções, que pode melhorar o desempenho.
Por padrão, uma imagem é carregada na faixa de opções cada time o usuário exibe uma guia que contém a imagem.Uma imagem é recarregada sempre que você alterar programaticamente as propriedades de um controle em que a imagem é exibida.
Use o LoadImage evento para atribuir uma imagem a um controle. Quando o usuário seleciona uma guia na faixa de opções, o aplicativo do Microsoft Office usa a imagem em cache.Se você modificar uma propriedade do controle em time de execução, o aplicativo do Microsoft Office não recarregará a imagem para o controle.Isso pode fornecer a você um ganho de desempenho pequeno.
Se você desejar armazenar em cache a imagem de um controle, conjunto o ImageName propriedade do controle.The LoadImage evento não é aumentado, a menos que você defina o ImageName propriedade de pelo menos um controle.
Exemplos
O exemplo a seguir armazena em cache as imagens para dois RibbonButton controles.
Para executar este exemplo de código, realize as seguintes etapas:
Adicionar um Faixa de opções (Visual Designer) to a Visual Studio Tools for Office projeto.
Se você estiver usando um projeto Visual Basic, adicione a demonstrativo a seguir para a 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 Faixa de Opções de Opções gerada.
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;
}
}
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.