RibbonButton.OfficeImageId (Propiedad) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece la imagen que se va a mostrar en el botón si desea utilizar un icono integrado de Microsoft Office.

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 OfficeImageId As String

Dim instance As RibbonButton
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value

public string OfficeImageId { get; set; }

Valor de propiedad

Tipo: System.String

Identificador de un icono integrado de Microsoft Office que sirve como icono para este control.

Comentarios

La propiedad OfficeImageId identifica un icono de Office mostrado por el control. El valor de la propiedad es una cadena que identifica el valor de imageMso del icono seleccionado. 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.

Para obtener una lista de los valores de imageMso, visite la página del Centro de descarga de Microsoft 2007 Office System Add-In: Icons Gallery.

Esta propiedad se omite si está establecida la propiedad Image. Las imágenes identificadas por la propiedad OfficeImageId pueden cargarse un poco más rápido que las imágenes identificadas por la propiedad Image, porque están almacenadas en la memoria caché de la aplicación de Office.

La propiedad ShowImage debe ser true para que el control muestre la imagen. Si se establece la propiedad OfficeImageId en tiempo de diseño, Visual Studio Tools para Office establece automáticamente la propiedad ShowImage en true. Si establece la propiedad OfficeImageId en tiempo de ejecución, debe establecer la propiedad ShowImage en true en el código.

Ejemplos

En el ejemplo siguiente se asigna un icono de Microsoft Office a un botón.

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 un botón al grupo.
Establezca la propiedad (Name) del botón en mySaveButton.

Private Sub SetButtonImage()
    mySaveButton.OfficeImageId = "FileSave"
    mySaveButton.ShowImage = True
End Sub

private void SetButtonImage()
{
    mySaveButton.OfficeImageId = "FileSave";
    mySaveButton.ShowImage = true;
}

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.