RibbonDialogLauncher.ImageName (Propiedad)
Obtiene o establece un identificador que se utiliza para asignar una imagen a este objeto RibbonDialogLauncher cuando se agrega a la barra de herramientas de acceso rápido.
Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
Sintaxis
'Declaración
Property ImageName As String
Get
Set
string ImageName { get; set; }
Valor de propiedad
Tipo: System.String
Identificador que se utiliza para asignar una imagen a este objeto RibbonDialogLauncher cuando se agrega a la barra de herramientas de acceso rápido.
Comentarios
Esta propiedad solo puede establecerse en tiempo de ejecución bajo determinadas condiciones. Para obtener más información, vea Información general sobre el modelo de objetos para la cinta de opciones.
La propiedad ImageName no tiene ningún efecto visible cuando RibbonDialogLauncher se muestra en un grupo de la cinta de opciones. Sin embargo, cuando el usuario agrega un objeto RibbonDialogLauncher a la barra de herramientas de acceso rápido, esta propiedad controla el comportamiento de la imagen mostrada, a menos que también se haya establecido la propiedad Image u OfficeImageId.
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. Se puede establecer esta propiedad sólo en tiempo de diseño, porque la imagen que identifica se carga durante el evento LoadImage. LoadImage sólo se eleva una vez por el nombre de imagen, cuando se muestra la Cinta. 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 u 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.
Seguridad de .NET Framework
- 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