Interface IResultData (mmc.h)
L’interface IResultData permet à un utilisateur d’ajouter, de supprimer, de rechercher et de modifier des éléments associés au volet d’affichage des résultats. Il permet également la manipulation du style d’affichage du volet d’affichage des résultats.
L’interface IResultData a été conçue pour donner l’impression que le volet d’affichage des résultats ne serait utilisé que par un seul composant, mais les composants doivent savoir que le volet d’affichage de résultats peut, en fait, être partagé par plusieurs composants. Toutes les manipulations d’élément sont effectuées via l’utilisation d’un ID d’élément attribué lors de l’insertion de l’élément. Cet ID est garanti pour être à la fois statique et unique pendant la durée de vie de l’élément. Lorsqu’un élément est supprimé, l’ID est libéré et peut être utilisé par d’autres nouveaux éléments de la liste. Vous ne devez jamais conserver un ID d’élément une fois que l’élément associé a été supprimé.
L’interface IResultData gère également les listes virtuelles (données propriétaires). En raison de la nature des listes virtuelles, toutes les méthodes ne s’appliquent pas et certaines méthodes ont des fonctionnalités limitées. Ces différences sont détaillées dans les descriptions des méthodes individuelles. La principale différence dans la gestion des éléments virtuels indique que, étant donné que la console ne gère aucun stockage pour les éléments virtuels, elle ne fournit pas d’ID d’élément. Au lieu de cela, les éléments de liste virtuelle sont identifiés par leur position de liste (index).
Héritage
L’interface IResultData hérite de l’interface IUnknown. IResultData possède également les types de membres suivants :
Méthodes
L’interface IResultData contient ces méthodes.
| IResultData::D eleteAllRsltItems La méthode IResultData::D eleteAllRsltItems permet au composant logiciel enfichable de supprimer tous les éléments et sous-éléments insérés par l’utilisateur du volet d’affichage des résultats. |
| IResultData::D eleteItem Permet au composant logiciel enfichable de supprimer un seul élément dans le volet d’affichage des résultats. |
| IResultData::FindItemByLParam La méthode IResultData::FindItemByLParam permet au composant logiciel enfichable de rechercher un élément ou un sous-élément en fonction de sa valeur lParam insérée par l’utilisateur. |
| IResultData::GetItem Permet à un utilisateur de récupérer les paramètres d’un élément unique. |
| IResultData::GetNextItem La méthode IResultData::GetNextItem obtient l’élément suivant dans la vue des résultats avec les indicateurs d’état spécifiés. |
| IResultData::GetViewMode Permet au composant logiciel enfichable de récupérer un mode d’affichage pour le volet d’affichage des résultats. |
| IResultData::InsertItem La méthode IResultData::InsertItem permet au composant logiciel enfichable d’ajouter un seul nouvel élément à l’affichage du volet de résultats. |
| IResultData::ModifyItemState Permet au composant logiciel enfichable de modifier l’état d’un élément. |
| IResultData::ModifyViewStyle La méthode IResultData::ModifyViewStyle permet au composant logiciel enfichable de définir le style d’affichage du volet de résultats. |
| IResultData::SetDescBarText Définit le texte de la barre de description pour le volet d’affichage des résultats. |
| IResultData::SetItem La méthode IResultData::SetItem permet au composant logiciel enfichable de définir un seul élément dans le volet de résultats. |
| IResultData::SetItemCount Définit le nombre d’éléments dans une liste virtuelle. |
| IResultData::SetViewMode Permet au composant logiciel enfichable de définir le mode d’affichage dans lequel le volet d’affichage des résultats affiche ses éléments. |
| IResultData::Sort Trie tous les éléments du volet de résultats. |
| IResultData::UpdateItem Provoque le redessination d’un élément spécifié dans le volet de résultats. |
Spécifications
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |