RibbonLoadImageEventArgs Classe (sistema de 2007)

Artigo
08/25/2010

Fornece dados para o LoadImage evento.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxe

Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs

Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

Comentários

Manipular o LoadImage evento para carregar uma imagem que é identificada pela ImageName propriedade de um controle. O aplicativo do Microsoft Office recupera essa imagem de sua solução apenas uma vez, quando a faixa de opções é exibida, para melhorar o desempenho.Depois disso, a imagem do controle não pode ser alterada.

Para carregar uma imagem para um controle, adicione código para o LoadImage manipulador de eventos. Se o ImageName propriedade das RibbonLoadImageEventArgs coincide com o ImageName propriedade do controle, conjunto o Image propriedade para a imagem que você deseja carregar.

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) item to a Visual Studio Tools for Office projeto.
Adicione um agrupar à guia personalizada.
Adicione dois botões ao agrupar.
Adicione duas imagens para os recursos do projeto.Para obter mais informações, consulte Como: Adicionar ou remover recursos.

PrivateSub Ribbon1_LoadImage(ByVal sender AsObject, _
    ByVal e As RibbonLoadImageEventArgs)
    SelectCase e.ImageName
        Case"Button1Image"
            e.Image = My.Resources.Image1
        Case"Button2Image"
            e.Image = My.Resources.Image2
    EndSelectEndSub

privatevoid 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;
    }
}

Hierarquia de herança

System.Object
System.EventArgs
Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Membros RibbonLoadImageEventArgs

Namespace Microsoft.Office.Tools.Ribbon

Compartilhar via