RibbonBase.LoadImage Evento

Referência

Definição

Namespace:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Ocorre quando o RibbonBase é carregado, caso a propriedade ImageName esteja definida para um ou mais controles.

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;

public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;

member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler

Public Custom Event LoadImage As RibbonLoadImageEventHandler

Tipo de evento

RibbonLoadImageEventHandler

Exemplos

O exemplo a seguir armazena em cache as imagens para dois RibbonButton controles.

Para executar esse exemplo de código, você deve primeiro executar as seguintes etapas:

Adicione uma Faixa de Opções (Visual Designer) a um projeto do Office.
Se você estiver usando um projeto do Visual Basic, adicione a seguinte instrução à parte superior do arquivo de código da Faixa de Opções: Imports Microsoft.Office.Tools.Ribbon

Em seguida, é possível executar esse código na classe Ribbon 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;  
    }  
}

Comentários

O LoadImage evento permite que você armazene imagens em cache na personalização da Faixa de Opções, o 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ê altera programaticamente as propriedades de um controle no qual 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 armazenada em cache. Se você modificar uma propriedade de controle em tempo de execução, o aplicativo do Microsoft Office não recarregará a imagem no controle. Isso pode lhe dar um pequeno ganho de desempenho.

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

Aplica-se a

Compartilhar via