CBaseList (clase)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El método CBaseList implementa una lista abtract. La plantilla de clase CGenericList , que deriva de CBaseList, proporciona comprobación de tipos y una interfaz más sencilla que la clase CBaseList .
La clase CBaseList se modela después de la clase CObList en la biblioteca Microsoft Foundation Classes (MFC). Las posiciones dentro de la lista se representan mediante una estructura POSITION. El autor de la llamada no debe tener acceso a los miembros internos de la estructura POSITION; tratarlo como puntero a un nodo de lista. La posición de un objeto de la lista permanece válida hasta que se elimina el objeto.
La lista no requiere ninguna compatibilidad con los objetos que contiene. No realiza ninguna administración de almacenamiento ni copia en los objetos . Los objetos pueden estar en varias listas.
Aproximadamente la mitad de los métodos de esta clase actúan en objetos individuales. Estos métodos tienen el sufijo - I en el nombre del método. Los demás métodos actúan en listas completas. Por ejemplo, el método CBaseList::AddAfter anexa una lista a otra lista. Las operaciones de objeto único devuelven valores POSITION o NULL en caso de error. Las operaciones de lista devuelven TRUE si se ejecuta correctamente o FALSE de lo contrario.
| Variables miembro protegidas | Descripción |
|---|---|
| m_Count | Número de elementos de la lista. |
| m_pFirst | Puntero al primer nodo de la lista. |
| m_pLast | Puntero al último nodo de la lista. |
| Métodos protegidos | Descripción |
| GetNextI | Recupera el elemento en la posición especificada y avanza la posición. |
| GetI | Recupera el elemento en la posición especificada. |
| FindI | Recupera la primera posición que contiene el elemento especificado. |
| RemoveHeadI | Quita el primer elemento de la lista. |
| RemoveTailI | Quita el último elemento de la lista. |
| RemoveI | Quita el elemento de en la posición especificada. |
| AddTailI | Agrega un elemento al final de la lista. |
| AddHeadI | Agrega un elemento al principio de la lista. |
| AddAfterI | Inserta un elemento después de la posición especificada. |
| AddBeforeI | Inserta un elemento antes de la posición especificada. |
| Métodos públicos | Descripción |
| CBaseList | Método constructor. |
| ~ CBaseList | Método de destructor. |
| RemoveAll | Quita todos los nodos de la lista. |
| GetHeadPositionI | Recupera la posición del primer elemento de la lista. |
| GetTailPositionI | Recupera la posición del último elemento de la lista. |
| GetCountI | Recupera el número de elementos de la lista. |
| Next | Recupera la siguiente posición de la lista. |
| Prev | Recupera la posición anterior de la lista. |
| AddHead | Inserta otra lista al principio de esta lista. |
| AddTail | Anexa otra lista al final de esta lista. |
| AddAfter | Inserta una lista después de la posición especificada. |
| AddBefore | Inserta una lista antes de la posición especificada. |
| MoveToTail | Divide la lista y anexa la parte principal a la cola de otra lista. |
| MoveToHead | Divide la lista e inserta la parte final en la cabeza de otra lista. |
| Marcha atrás | Invierte el orden de la lista. |
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|