Compartir a través de


RibbonDropDown.ImageName (Propiedad)

Obtiene o establece el nombre que se puede usar en el controlador de eventos LoadImage para identificar una imagen del control.

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
Cadena que se puede usar en el controlador de eventos LoadImage para identificar una imagen del control.

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. 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 obtener más información sobre cómo establecer esta propiedad, vea Información general sobre el modelo de objetos para la cinta de opciones.

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. Cuando se establece la propiedad ImageName en tiempo de diseño, Visual Studio automáticamente establece 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.

Seguridad de .NET Framework

Vea también

Referencia

RibbonDropDown Interfaz

Microsoft.Office.Tools.Ribbon (Espacio de nombres)

Otros recursos

Información general sobre el modelo de objetos para la cinta de opciones