Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualización: noviembre 2007
Obtiene o establece el nombre que se puede usar en el controlador de eventos LoadImage para identificar una imagen del menú.
Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)
Sintaxis
Public Property ImageName As String
Dim instance As RibbonMenu
Dim value As String
value = instance.ImageName
instance.ImageName = value
public string ImageName { get; set; }
Valor de propiedad
Tipo: System.String
Nombre que se puede usar en el controlador de eventos LoadImage para identificar una imagen del menú.
Comentarios
La propiedad ImageName identifica una imagen mostrada por el control. La aplicación de Office recupera esta imagen de la solución sólo una vez para mejorar el rendimiento. Esta propiedad sólo se puede establecer en tiempo de diseño porque la imagen que identifica se carga durante el evento LoadImage. El evento LoadImage se provoca sólo una vez por cada nombre de imagen cuando se muestra la cinta de opciones. Después, no se puede cambiar la imagen del control mediante esta propiedad.
Para cargar la imagen, agregue código al controlador de eventos LoadImage. Compruebe la propiedad ImageName de RibbonLoadImageEventArgs y establezca la propiedad Image del objeto RibbonLoadImageEventArgs en la imagen que desee cargar.
Esta propiedad se omite si se ha establecido la propiedad Image o OfficeImageId. Las imágenes identificadas por la propiedad ImageName se pueden cargar un poco más rápido que las imágenes identificadas por la propiedad Image, porque la aplicación de Office recupera la imagen de la solución sólo la primera vez que se muestra la cinta de opciones.
La propiedad ShowImage debe ser true para que el control muestre la imagen. Si se establece la propiedad ImageName en tiempo de diseño, Visual Studio Tools para Office establece automáticamente la propiedad ShowImage en true. Si establece la propiedad ImageName en tiempo de ejecución, debe establecer la propiedad ShowImage en true en el código.
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.
Vea también
Referencia
Microsoft.Office.Tools.Ribbon (Espacio de nombres)
Otros recursos
Información general sobre el modelo de objetos para la cinta de opciones