Éléments récents
La liste Éléments récents est un volet du menu Application qui affiche les derniers éléments utilisés (MRU) pour une application.
Détails
La capture d’écran suivante illustre une liste d’éléments récents à partir de WordPad pour Windows 7.
Le menu Application peut avoir au maximum une liste ApplicationMenu.RecentItems , représentée par un élément ApplicationMenu.RecentItems , pour afficher des documents, images, films et autres projets récents sur 2000. Le nombre d’éléments répertoriés varie entre zéro et le nombre maximal spécifié dans le balisage, avec une valeur par défaut de dix. Les éléments récents sont affichés sous la forme d’une liste numérotée de chaînes indiquant des noms de fichiers. Il est recommandé d’utiliser la propriété Command.LabelDescription pour donner le chemin d’accès complet à l’emplacement du fichier, comme illustré dans la capture d’écran suivante.
L’élément RecentItems a un attribut EnablePinning qui, s’il est défini sur true, affiche une icône d’épingle à droite de chaque élément de la liste, comme illustré dans la capture d’écran suivante.
Notes
L’épinglage est activé par défaut si l’attribut EnablePinning n’est pas spécifié.
L’algorithme d’épinglage est destiné à empêcher les éléments de tomber de la liste Éléments récents . L’algorithme produit le comportement suivant :
- Un nouvel élément est toujours ajouté en haut de la liste Éléments récents .
- Les éléments seront déplacés vers le bas dans la liste au fil du temps. Une fois que la liste est complète (atteint le nombre maximal d’éléments spécifiés dans le balisage), les éléments plus anciens tombent du bas de la liste à mesure que de nouveaux éléments sont ajoutés en haut de la liste.
- Si un élément apparaît déjà quelque part dans la liste, mais qu’il est de nouveau accessible, il revient en haut de la liste.
- Si un élément est épinglé, il se déplace toujours vers le bas de la liste, mais il ne tombe pas du bas. Au lieu de cela, une fois la liste complète, le premier élément non épinglé au-dessus de l’élément épinglé tombe lors de l’ajout d’un nouvel élément à la liste.
- Si le nombre d’éléments épinglés atteint le nombre maximal d’éléments, aucun nouvel élément n’est ajouté à la liste tant qu’un élément n’est pas épinglé.
Propriétés des éléments récents
L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Éléments récents.
En règle générale, une propriété Éléments récents est mise à jour dans l’interface utilisateur du ruban en invalidant la commande associée au contrôle par un appel à la méthode IUIFramework::InvalidateUICommand . L’événement d’invalidation est géré et les mises à jour de propriété définies par la méthode de rappel IUICommandHandler::UpdateProperty .
La méthode de rappel IUICommandHandler::UpdateProperty n’est pas exécutée et l’application interrogée pour obtenir une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par le framework. Par exemple, lorsqu’un onglet est activé et qu’un contrôle est révélé dans l’interface utilisateur du ruban, ou lorsqu’une info-bulle est affichée.
Notes
Dans certains cas, une propriété peut être récupérée via la méthode IUIFramework::GetUICommandProperty et définie avec la méthode IUIFramework::SetUICommandProperty .
Le tableau suivant répertorie les clés de propriété associées au contrôle Éléments récents.
| Clé de propriété | Notes |
|---|---|
| UI_PKEY_Keytip | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_RecentItems | Peut être mis à jour uniquement par invalidation. |
Notes
La méthode IApplicationDocumentLists::GetList peut être utilisée pour récupérer la liste MRU de l’interpréteur de commandes Windows pour l’application Ruban. L’objet récupéré par cette méthode peut ensuite être utilisé par l’application pour créer les données requises par l’infrastructure du ruban pour remplir la liste Éléments récents du menu Application.
Notes
Lorsque vous utilisez cette méthode, listtype doit avoir la valeur ADLT_RECENT.
Pour obtenir un exemple d’implémentation d’une liste d’éléments MRU dans une application d’infrastructure de ruban, consultez l’exemple HTMLEditRibbon.
Rubriques connexes