Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La liste Éléments récents est un volet du menu application qui affiche les éléments les plus récemment utilisés pour une application.
- Détails
- propriétés d’éléments récents
- Remarques
- rubriques connexes
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 plus un ApplicationMenu.RecentItems liste, représentée par un élément ApplicationMenu.RecentItems, pour afficher des documents récents, des images, des films et d’autres projets sur utilisant un utilisateur. Le nombre d’éléments répertoriés est compris 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 les noms de fichiers. Il est recommandé que la propriété Command.LabelDescription soit utilisée pour donner le chemin complet de l’emplacement du fichier, comme indiqué 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.
Note
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 dans 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 liste.
- Les éléments sont déplacés vers le bas dans la liste au fil du temps. Une fois la liste pleine (atteint le nombre maximal d’éléments spécifiés dans le balisage), les anciens éléments tombent en bas de la liste lorsque 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 est à 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 en 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 lorsqu’un nouvel élément est ajouté à 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 via un appel à la méthode IUIFramework ::InvalidateUICommand. L’événement d’invalidation est géré et les mises à jour de propriétés définies par l'IUICommandHandler ::UpdateProperty méthode de rappel.
La méthode de rappel IUICommandHandler ::UpdateProperty n’est pas exécutée et l’application interrogée pour une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par l’infrastructure. 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.
Note
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 | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_RecentItems | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
Remarques
La méthode IApplicationDocumentLists ::GetList peut être utilisée pour récupérer la liste MRU Windows Shell 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 les Éléments récents liste des menu Application.
Note
Lorsque vous utilisez cette méthode, type de liste 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 sample.
Rubriques connexes