Evento OfficeRibbon.LoadImage (sistema de 2007)

Artigo
08/25/2010

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.

Consulte também

Referência

OfficeRibbon Classe

Membros OfficeRibbon

Namespace Microsoft.Office.Tools.Ribbon

Partilhar via