RibbonSplitButton.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 E:Microsoft.Office.Tools.Ribbon.LoadImage pour identifier une image pour le contrôle.
public:
property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };
public string ImageName { get; set; }
member this.ImageName : string with get, set
Public Property ImageName As String
Valeur de propriété
Chaîne que vous pouvez utiliser dans le gestionnaire d’événements E :Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage pour identifier une image pour le contrôle.
Remarques
La ImageName propriété identifie une image affichée par le contrôle. L’application Office ne récupère cette image de votre solution qu’une seule fois, pour améliorer les performances. Cette propriété ne peut être définie qu’au moment du design, car l’image qu’elle identifie est chargée pendant l’événement LoadImage . LoadImage n’est déclenché qu’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 gestionnaire d’événements LoadImage . Vérifiez la ImageName propriété du RibbonLoadImageEventArgs et définissez la Image propriété de l’objet RibbonLoadImageEventArgs sur l’image que vous souhaitez charger.
Cette propriété est ignorée si la Image propriété ou la OfficeImageId propriété est définie. Les images identifiées par la ImageName propriété peuvent être chargées un peu plus rapidement que les images identifiées par la Image propriété, car l’application Office ne récupère l’image de votre solution que la première fois que le ruban est affiché.