RibbonDialogLauncher.Image (Propiedad) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece una imagen que aparece en 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.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxis

Public Property Image As Image

Dim instance As RibbonDialogLauncher
Dim value As Image

value = instance.Image

instance.Image = value

public Image Image { get; set; }

Valor de propiedad

Tipo: System.Drawing.Image

Imagen que aparece en este objeto RibbonDialogLauncher cuando se agrega a la barra de herramientas de acceso rápido.

Comentarios

El formato de imagen recomendado es PNG porque las imágenes en este formato admiten la transparencia a través de su canal alfa.

La propiedad Image 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.

La propiedad Image identifica una imagen mostrada por el control. Esta propiedad puede establecerse en tiempo de diseño o en tiempo de ejecución. Si actualiza esta propiedad en tiempo de ejecución, se actualizará la apariencia del control para reflejar el cambio.

Si se establece la propiedad Image, se omitirán las propiedades OfficeImageId e ImageName. Si bien la propiedad Image le proporciona mayor control que las otras dos propiedades, puede ser más lenta porque el objeto de imagen se envía a la aplicación de Office cada vez que se actualiza el control.

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.