Interface RibbonLoadImageEventArgs

Artigo
08/01/2011

Provides data for the LoadImage event.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.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.

Início

Comentários

Lidar com o LoadImage evento se você deseja carregar uma imagem que é identificada pelo ImageName a 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 de dois RibbonButton controles.

Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um a faixa de opções (Visual Designer) item a um projeto do Office.
Adicione um grupo à guia personalizada.
Adicione dois botões ao grupo.
Adicione duas imagens aos recursos do projeto. For more information, see 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

Partilhar via