RibbonLoadImageEventArgs (Interfaz)

Proporciona datos para el evento LoadImage.

Espacio de nombres:  Microsoft.Office.Tools.Ribbon
Ensamblado:  Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

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

El tipo RibbonLoadImageEventArgs expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	Image	Obtiene o establece la imagen de un control de la cinta de opciones que se desea cargar.
	ImageName	Obtiene el nombre de la imagen que se carga en la cinta de opciones.

Arriba

Comentarios

Controle el evento LoadImage si desea cargar una imagen identificada por la propiedad ImageName de un control. La aplicación de Microsoft Office recupera esta imagen de la solución sólo una vez, cuando se muestra la cinta de opciones, con el fin de mejorar el rendimiento. Después, no se puede cambiar la imagen del control.

Si desea cargar una imagen para un control, agregue código al controlador de eventos LoadImage. Si la propiedad ImageName de RibbonLoadImageEventArgs coincide con la propiedad ImageName del control, establezca la propiedad Image en la imagen que desee cargar.

Ejemplos

En el ejemplo siguiente se almacenan en memoria caché las imágenes de dos controles RibbonButton.

Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:

1. Agregue un elemento Cinta (diseñador visual) a un proyecto de Office.

2. Agregue un grupo a la ficha personalizada.

3. Agregue dos botones al grupo.

4. Agregue dos imágenes a los recursos del proyecto. Para obtener más información, vea Cómo: Agregar o quitar 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;
    }
}

Vea también

Referencia

Microsoft.Office.Tools.Ribbon (Espacio de nombres)