CBaseList, classe
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La méthode CBaseList implémente une liste abtract. Le modèle de classe CGenericList , qui dérive de CBaseList, fournit la vérification des types et une interface plus simple que la classe CBaseList .
La classe CBaseList est modélisée d’après la classe CObList dans la bibliothèque MFC (Microsoft Foundation Classes). Les positions dans la liste sont représentées par une structure POSITION. L’appelant ne doit pas accéder aux membres internes de la structure POSITION ; le traiter comme un pointeur vers un nœud de liste. La position d’un objet dans la liste reste valide jusqu’à ce que l’objet soit supprimé.
La liste ne nécessite aucune prise en charge par les objets qu’elle contient. Il n’effectue aucune gestion ou copie du stockage sur les objets. Les objets peuvent se trouver dans plusieurs listes.
Environ la moitié des méthodes de cette classe agissent sur des objets uniques. Ces méthodes ont le suffixe I dans le nom de la méthode. Les autres méthodes agissent sur des listes entières. Par exemple, la méthode CBaseList::AddAfter ajoute une liste à une autre liste. Les opérations à objet unique retournent des valeurs POSITION ou NULL en cas d’échec. Les opérations de liste retournent TRUE si elles réussissent ou FALSE dans le cas contraire.
| Variables de membre protégé | Description |
|---|---|
| m_Count | Nombre d’éléments dans la liste. |
| m_pFirst | Pointeur vers le premier nœud de la liste. |
| m_pLast | Pointeur vers le dernier nœud de la liste. |
| Méthodes protégées | Description |
| GetNextI | Récupère l’élément à la position spécifiée et avance la position. |
| GetI | Récupère l’élément à la position spécifiée. |
| Findi | Récupère la première position qui contient l’élément spécifié. |
| RemoveHeadI | Supprime le premier élément de la liste. |
| RemoveTailI | Supprime le dernier élément de la liste. |
| RemoveI | Supprime l'élément à la position spécifiée. |
| AddTailI | Ajoute un élément à la fin de la liste. |
| AddHeadI | Ajoute un élément au début de la liste. |
| AddAfterI | Insère un élément après la position spécifiée. |
| AddBeforeI | Insère un élément avant la position spécifiée. |
| Méthodes publiques | Description |
| CBaseList | Méthode du constructeur. |
| ~ CBaseList | Méthode de destructeur. |
| RemoveAll | Supprime tous les nœuds de la liste. |
| GetHeadPositionI | Récupère la position du premier élément de la liste. |
| GetTailPositionI | Récupère la position du dernier élément de la liste. |
| GetCountI | Récupère le nombre d’éléments de la liste. |
| Suivant | Récupère la position suivante dans la liste. |
| Précédent | Récupère la position précédente dans la liste. |
| AddHead | Insère une autre liste au début de cette liste. |
| AddTail | Ajoute une autre liste à la fin de cette liste. |
| AddAfter | Insère une liste après la position spécifiée. |
| AddBefore | Insère une liste avant la position spécifiée. |
| MoveToTail | Fractionne la liste et ajoute la partie principale à la fin d’une autre liste. |
| MoveToHead | Fractionne la liste et insère la partie de queue en tête d’une autre liste. |
| Inverse | Inverse l’ordre de la liste. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|