CStringList Třída

Podporuje seznamy CString objektů.

Syntaxe

class CStringList : public CObject

Členové

Členské funkce CStringList jsou podobné členským funkcím třídy CObList. Vzhledem k této podobnosti můžete použít CObList referenční dokumentaci pro specifika členské funkce. Všude, kde se ukazatel zobrazuje jako návratová CObject hodnota, nahraďte znakem CString (nikoli ukazatelem CString ). Kdykoli uvidíte CObject ukazatel jako parametr funkce, nahraďte ho .LPCTSTR

CObject*& CObList::GetHead() const;

Například se přeloží na

CString& CStringList::GetHead() const;

a

POSITION AddHead( CObject* <newElement> );

překládá na

POSITION AddHead( LPCTSTR <newElement> );

Veřejné konstruktory

Název	Popis
CStringList::CStringList	Vytvoří prázdný seznam.

Veřejné metody

Název	Popis
CStringList::AddHead	Přidá prvek (nebo všechny prvky v jiném seznamu) do hlavy seznamu (vytvoří novou hlavu).
CStringList::AddTail	Přidá prvek (nebo všechny prvky v jiném seznamu) na konec seznamu (vytvoří nový ocas).
CStringList::Find	Získá pozici prvku určeného hodnotou ukazatele.
CStringList::FindIndex	Získá pozici prvku určeného indexem založeným na nule.
CStringList::GetAt	Získá prvek na dané pozici.
CStringList::GetCount	Vrátí počet prvků v tomto seznamu.
CStringList::GetHead	Vrátí hlavní prvek seznamu (nemůže být prázdný).
CStringList::GetHeadPosition	Vrátí pozici hlavního prvku seznamu.
CStringList::GetNext	Získá další prvek pro iterování.
CStringList::GetPrev	Získá předchozí prvek pro iterování.
CStringList::GetSize	Vrátí počet prvků v tomto seznamu.
CStringList::GetTail	Vrátí koncovou část seznamu (nemůže být prázdný).
CStringList::GetTailPosition	Vrátí pozici koncového prvku seznamu.
CStringList::InsertAfter	Vloží nový prvek za danou pozici.
CStringList::InsertBefore	Vloží nový prvek před danou pozici.
CStringList::IsEmpty	Testuje prázdnou podmínku seznamu (žádné prvky).
CStringList::RemoveAll	Odebere všechny prvky z tohoto seznamu.
CStringList::RemoveAt	Odebere prvek z tohoto seznamu určený pozicí.
CStringList::RemoveHead	Odebere prvek z hlavy seznamu.
CStringList::RemoveTail	Odebere prvek z konce seznamu.
CStringList::SetAt	Nastaví prvek na dané pozici.

Poznámky

Všechna porovnání se provádějí podle hodnoty, což znamená, že se znaky v řetězci porovnávají místo adres řetězců.

CStringListIMPLEMENT_SERIAL obsahuje makro pro podporu serializace a dumpingu jeho prvků. Pokud je seznam CString objektů uložen v archivu, buď s přetíženým operátorem vložení, nebo s Serialize členské funkce, každý CString prvek je serializován postupně.

Pokud potřebujete výpis jednotlivých CString prvků, musíte nastavit hloubku kontextu výpisu na hodnotu 1 nebo vyšší.

Další informace o použití CStringListnaleznete v článku Kolekce.

Hierarchie dědičnosti

CObject

CStringList

Požadavky

Záhlaví: afxcoll.h

Viz také

Mfc – ukázka COLLECT
CObject Třída
Graf hierarchie