RibbonLoadImageEventArgs (Clase) (2007 System)

Actualización: noviembre 2007

Proporciona datos para el evento LoadImage.

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

Sintaxis

Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs

Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

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:

Agregue un elemento Cinta (diseñador visual) a un proyecto de Visual Studio Tools para Office.
Agregue un grupo a la ficha personalizada.
Agregue dos botones al grupo.
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;
    }
}

Jerarquía de herencia

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

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

RibbonLoadImageEventArgs (Miembros)

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

Last updated on 2008-09-04