RibbonDropDownItem.OfficeImageId (Propiedad)
Obtiene o establece la imagen que se va a mostrar en el objeto RibbonDropDownItem si desea utilizar un icono integrado de Microsoft Office.
Espacio de nombres: Microsoft.Office.Tools.Ribbon
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
Sintaxis
'Declaración
Property OfficeImageId As String
Get
Set
string OfficeImageId { get; set; }
Valor de propiedad
Tipo: System.String
Imagen que se va a mostrar en el objeto RibbonDropDownItem si desea utilizar un icono integrado de Microsoft Office.
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 Microsoft2007 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.
Ejemplos
En el ejemplo siguiente se asignan iconos de Microsoft Office a dos elementos de un cuadro desplegable.
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 un cuadro desplegable al grupo.
Private Sub PopulateDropDown()
Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
status1.Label = "Away"
status1.OfficeImageId = "PersonaStatusAway"
DropDown1.Items.Add(status1)
Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
status2.Label = "Online"
status2.OfficeImageId = "PersonaStatusOnline"
DropDown1.Items.Add(status2)
End Sub
private void PopulateDropDown()
{
RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
status1.Label = "Away";
status1.OfficeImageId = "PersonaStatusAway";
dropDown1.Items.Add(status1);
RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
status2.Label = "Online";
status2.OfficeImageId = "PersonaStatusOnline";
dropDown1.Items.Add(status2);
}
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 el modelo de objetos para la cinta de opciones