RibbonComboBox.ImageName Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le nom que vous pouvez utiliser dans le gestionnaire d’événements LoadImage pour identifier une image pour le contrôle.
public string ImageName { get; set; }
Valeur de propriété
Chaîne que vous pouvez utiliser dans le gestionnaire d’événements LoadImage pour identifier une image pour le contrôle.
Remarques
Cette propriété peut être définie au moment de l’exécution uniquement sous certaines conditions. Pour plus d’informations, consultez vue d’ensemble du modèle d’objet de ruban.
Pour plus d’informations sur la définition de cette propriété, consultez vue d’ensemble du modèle d’objet de ruban.
La ImageName propriété identifie une image affichée par le contrôle. L’application Office récupère cette image à partir de votre solution une seule fois, afin d’améliorer les performances. Cette propriété ne peut être définie qu’au moment de la conception, car l’image qu’elle identifie est chargée pendant l' LoadImage événement. LoadImageest déclenché une seule fois par nom d’image, lorsque le ruban est affiché. Après cela, l’image de contrôle ne peut pas être modifiée à l’aide de cette propriété.
Pour charger l’image, ajoutez du code au LoadImage Gestionnaire d’événements. Vérifiez la ImageName propriété de RibbonLoadImageEventArgs et affectez Image à la propriété de l' RibbonLoadImageEventArgs objet l’image que vous souhaitez charger.
Cette propriété est ignorée si la propriété Image ou la OfficeImageId propriété est définie. Les images identifiées par la ImageName propriété peuvent être chargées légèrement plus rapidement que les images identifiées par la Image propriété, car l’application Office récupère l’image de votre solution uniquement la première fois que le ruban est affiché.
La ShowImage propriété doit être true pour que le contrôle affiche l’image. Quand vous définissez la ImageName propriété au moment du design, Visual Studio affecte automatiquement ShowImage à la propriété la valeur true . Si vous définissez la ImageName propriété au moment de l’exécution, vous devez affecter à la propriété la valeur ShowImage true dans votre code.