RibbonButton.Image (Propiedad)

Artículo
05/15/2013

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

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.