RibbonSplitButton.ImageName Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el nombre que se puede usar en el controlador de eventos E:Microsoft.Office.Tools.Ribbon.LoadImage para identificar una imagen del control.
public:
property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };public string ImageName { get; set; }member this.ImageName : string with get, setPublic Property ImageName As StringValor de propiedad
Cadena que puede usar en el controlador de eventos E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage para identificar una imagen para el control.
Comentarios
La ImageName propiedad identifica una imagen que el control muestra. La aplicación de Office recupera esta imagen de la solución solo una vez para mejorar el rendimiento. Esta propiedad solo se puede establecer en tiempo de diseño, ya que la imagen que identifica se carga durante el LoadImage evento. LoadImage se genera solo una vez por nombre de imagen, cuando se muestra la cinta de opciones. Después de eso, la imagen de control no se puede cambiar mediante esta propiedad.
Para cargar la imagen, agregue código al controlador de LoadImage eventos. Compruebe la ImageName propiedad de RibbonLoadImageEventArgs y establezca la Image propiedad del RibbonLoadImageEventArgs objeto en la imagen que desea cargar.
Esta propiedad se omite si se establece la Image propiedad o la OfficeImageId propiedad . Las imágenes identificadas por la ImageName propiedad se pueden cargar ligeramente más rápido que las imágenes identificadas por la Image propiedad , ya que la aplicación de Office recupera la imagen de la solución solo la primera vez que se muestra la cinta de opciones.