Interface RibbonLoadImageEventArgs

Artigo
05/21/2013

Fornece dados para o evento LoadImage.

Namespace: Microsoft.Office.Tools.Ribbon
Assemblies: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)
Microsoft.Office.Tools.Common.v4.0.Utilities (em Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Sintaxe

'Declaração
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

O tipo RibbonLoadImageEventArgs expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Image	Obtém ou define a imagem de um controle de faixa de opções que você deseja carregar.
	ImageName	Obtém o nome da imagem que está sendo carregada na faixa de opções.

Superior

Comentários

Lidar com o LoadImage evento se desejar carregar uma imagem que é identificada pelo ImageName propriedade de um controle.O aplicativo 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 a ImageName propriedade da RibbonLoadImageEventArgs corresponde a ImageName definir a propriedade do controle, 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, você deve, primeiro, execute as seguintes etapas:

Adicionar um a faixa de opções (Visual Designer) item para um projeto do Office.
Adicione um grupo à guia personalizada.
Adicione dois botões ao grupo.
Adicione duas imagens aos recursos do projeto.Para obter mais informações, consulte Como: Adicionar ou remover recursos.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal 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;
    }
}

Consulte também

Referência

Namespace Microsoft.Office.Tools.Ribbon

Compartilhar via