RibbonButton.Image (Propiedad)
Obtiene o establece la imagen que se muestra en el botón.
Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
Sintaxis
'Declaración
Property Image As Image
Get
Set
Image Image { get; set; }
Valor de propiedad
Tipo: System.Drawing.Image
Image que se muestra en el botón.
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 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 omiten las propiedades OfficeImageId e ImageName. Aunque la propiedad Image proporciona mayor control que las otras dos propiedades, puede resultar más lenta porque el objeto de imagen se envía a la aplicación de Office cada vez que se actualiza el control.
La propiedad ShowImage debe ser true para que el control muestre la imagen. Cuando se establece la propiedad Image en tiempo de diseño, Visual Studio automáticamente establece la propiedad ShowImage en true. Si establece la propiedad Image en tiempo de ejecución, debe establecer la propiedad ShowImage en true en el código.
Ejemplos
En el siguiente ejemplo se establece la propiedad Image de dos botones. Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:
Agregue un elemento Cinta (diseñador visual) a un proyecto creado mediante las herramientas de desarrollo de Office en Visual Studio.
Agregue un grupo a la ficha personalizada.
Agregue dos botones al grupo.
Agregue dos imágenes a los recursos del proyecto. Para obtener más información, vea Cómo: Agregar o quitar recursos.
Private Sub LoadImages()
button1.ShowImage = True
Button2.ShowImage = True
Button1.Image = My.Resources.Image1
Button2.Image = My.Resources.Image2
End Sub
private void LoadImages()
{
button1.ShowImage = true;
button2.ShowImage = true;
button1.Image = Properties.Resources.Image1;
button2.Image = Properties.Resources.Image2;
}
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 la cinta de opciones
Información general sobre el modelo de objetos para la cinta de opciones