RibbonBase.LoadImage Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.