Compartir a través de


RibbonBase.LoadImage Evento

Definición

Se produce cuando se carga RibbonBase si la propiedad ImageName está establecida para uno o varios controles.

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;
public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;
member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 
Public Custom Event LoadImage As RibbonLoadImageEventHandler 

Tipo de evento

Ejemplos

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

Para ejecutar este ejemplo de código, primero debe realizar los pasos siguientes:

  • Agregue una cinta de opciones (Visual Designer) a un proyecto de Office.

  • Si usa un proyecto de Visual Basic, agregue la siguiente instrucción a la parte superior del archivo de código de la cinta de opciones: Imports Microsoft.Office.Tools.Ribbon

A continuación, puede ejecutar este código en la clase Ribbon generada.

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

Comentarios

El LoadImage evento permite almacenar en caché imágenes en la personalización de la cinta de opciones, lo que puede mejorar el rendimiento.

De forma predeterminada, una imagen se carga en la cinta cada vez que el usuario muestra una pestaña que contiene la imagen. Se vuelve a cargar una imagen cada vez que cambie mediante programación las propiedades de un control en el que aparece la imagen.

Use el LoadImage evento para asignar una imagen a un control . Cuando el usuario selecciona una pestaña en la cinta de opciones, la aplicación de Microsoft Office usa la imagen almacenada en caché. Si modifica una propiedad de control en tiempo de ejecución, la aplicación de Microsoft Office no volverá a cargar la imagen en el control. Esto puede proporcionarle una pequeña ganancia de rendimiento.

Si desea almacenar en caché la imagen de un control, establezca la propiedad ImageName del control. El LoadImage evento no se genera a menos que establezca la propiedad ImageName de al menos un control.

Se aplica a