OfficeRibbon.LoadImage (Evento) (2007 System)
Actualización: noviembre 2007
Se produce cuando se carga OfficeRibbon si la propiedad ImageName está establecida para uno o varios controles.
Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)
Sintaxis
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)
AddHandler instance.LoadImage, handler
[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> LoadImage
Comentarios
El evento LoadImage permite almacenar en la memoria caché las imágenes de la personalización de la cinta de opciones, lo cual puede mejorar el rendimiento.
De forma predeterminada, una imagen se carga en la cinta de opciones cada vez que el usuario muestra una ficha que contiene la imagen. Una imagen se vuelve a cargar cada vez que se cambian mediante programación las propiedades de un control en el que aparece la imagen.
Utilice el evento LoadImage para asignar una imagen a un control. Cuando el usuario selecciona una ficha en la cinta de opciones, la aplicación de Microsoft Office utiliza la imagen almacenada en la memoria caché. Si modifica la propiedad de un control en tiempo de ejecución, la aplicación de Microsoft Office no volverá a cargar la imagen en el control. De este modo, el rendimiento puede ser un poco mayor.
Si desea almacenar en memoria caché la imagen de un control, establezca la propiedad ImageName del control. No se provoca el evento LoadImage, a menos que establezca la propiedad ImageName de al menos un control.
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.
Si usa un proyecto de Visual Basic, agregue la siguiente instrucción al principio del archivo de código de la cinta de opciones: Imports Microsoft.Office.Tools.Ribbon
A continuación, podrá 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;
}
}
Permisos
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.