RibbonButton.Image (Propiedad) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece la imagen que se muestra en el botón.

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 RibbonButton
Dim value As Image

value = instance.Image

instance.Image = value

public 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. Si se establece la propiedad Image en tiempo de diseño, Visual Studio Tools para Office establece automáticamente 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 de Visual Studio Tools para Office.
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
    CustomerButton.ShowImage = True
    Button1.Image = My.Resources.Image1
    CustomerButton.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;
}

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.