CStringList Klasa

Obsługuje listy CString obiektów.

Składnia

class CStringList : public CObject

Członkowie

Funkcje CStringList składowe klasy są podobne do funkcji składowych klasy CObList. Ze względu na to podobieństwo można użyć dokumentacji referencyjnej CObList dla specyfiki funkcji składowych. Wszędzie tam, gdzie wskaźnik jest widoczny CObject jako wartość zwracana, zastąp CString wartość (a nie wskaźnikiem CString ). Wszędzie tam, gdzie wskaźnik jest wyświetlany CObject jako parametr funkcji, zastąp element LPCTSTR.

CObject*& CObList::GetHead() const;

na przykład przekłada się na

CString& CStringList::GetHead() const;

oraz

POSITION AddHead( CObject* <newElement> );

przekłada się na

POSITION AddHead( LPCTSTR <newElement> );

Konstruktory publiczne

Nazwa/nazwisko	opis
CStringList::CStringList	Tworzy pustą listę.

Metody publiczne

Nazwa/nazwisko	opis
CStringList::AddHead	Dodaje element (lub wszystkie elementy na innej liście) do nagłówka listy (tworzy nową głowę).
CStringList::AddTail	Dodaje element (lub wszystkie elementy na innej liście) do końca listy (tworzy nowy ogon).
CStringList::Find	Pobiera położenie elementu określonego przez wartość wskaźnika.
CStringList::FindIndex	Pobiera pozycję elementu określonego przez indeks oparty na zerze.
CStringList::GetAt	Pobiera element na danej pozycji.
CStringList::GetCount	Zwraca liczbę elementów na tej liście.
CStringList::GetHead	Zwraca element główny listy (nie może być pusty).
CStringList::GetHeadPosition	Zwraca położenie elementu głównego listy.
CStringList::GetNext	Pobiera następny element do iteracji.
CStringList::GetPrev	Pobiera poprzedni element na potrzeby iteracji.
CStringList::GetSize	Zwraca liczbę elementów na tej liście.
CStringList::GetTail	Zwraca element końcowy listy (nie może być pusty).
CStringList::GetTailPosition	Zwraca położenie elementu końcowego listy.
CStringList::InsertAfter	Wstawia nowy element po danej pozycji.
CStringList::InsertBefore	Wstawia nowy element przed daną pozycją.
CStringList::IsEmpty	Testuje pusty warunek listy (brak elementów).
CStringList::RemoveAll	Usuwa wszystkie elementy z tej listy.
CStringList::RemoveAt	Usuwa element z tej listy określony przez pozycję.
CStringList::RemoveHead	Usuwa element z nagłówka listy.
CStringList::RemoveTail	Usuwa element z końca listy.
CStringList::SetAt	Ustawia element na danej pozycji.

Uwagi

Wszystkie porównania są wykonywane według wartości, co oznacza, że znaki w ciągu są porównywane zamiast adresów ciągów.

CStringListIMPLEMENT_SERIAL uwzględnia makro w celu wspierania serializacji i dumpingu jej elementów. Jeśli lista CString obiektów jest przechowywana w archiwum, z przeciążonym operatorem wstawiania lub z Serialize funkcją składową, każdy CString element jest serializowany z kolei.

Jeśli potrzebujesz zrzutu poszczególnych CString elementów, musisz ustawić głębokość kontekstu zrzutu na 1 lub większą.

Aby uzyskać więcej informacji na temat korzystania z programu CStringList, zobacz artykuł Kolekcje.

Hierarchia dziedziczenia

CObject

CStringList

Wymagania

Nagłówka:afxcoll.h

Zobacz też

Przykład MFC COLLECT
CObject Klasa
Wykres hierarchii