Klasa CVSListBox

Klasa CVSListBox obsługuje kontrolkę listy edytowalnej.

Składnia

class CVSListBox : public CVSListBoxBase

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CVSListBox::CVSListBox	CVSListBox Tworzy obiekt.
CVSListBox::~CVSListBox	Destruktora.

Metody publiczne

Nazwa/nazwisko	opis
CVSListBox::AddItem	Dodaje ciąg do kontrolki listy. (Przesłania CVSListBoxBase::AddItem).
CVSListBox::EditItem	Uruchamia operację edycji w tekście elementu kontrolki listy. (Przesłania CVSListBoxBase::EditItem).
CVSListBox::GetCount	Pobiera liczbę ciągów w kontrolce listy edytowalnej. (Przesłania CVSListBoxBase::GetCount).
CVSListBox::GetItemData	Pobiera wartość 32-bitową specyficzną dla aplikacji skojarzona z edytowalnym elementem kontrolki listy. (Przesłania CVSListBoxBase::GetItemData).
CVSListBox::GetItemText	Pobiera tekst edytowalnego elementu kontrolki listy. (Przesłania CVSListBoxBase::GetItemText).
CVSListBox::GetSelItem	Pobiera indeks zerowy aktualnie wybranego elementu w kontrolce listy edytowalnej. (Przesłania CVSListBoxBase::GetSelItem).
CVSListBox::PreTranslateMessage	Tłumaczy komunikaty okien przed ich wysłaniem do funkcji TranslateMessage i DispatchMessage systemu Windows. Aby uzyskać więcej informacji i składni metody, zobacz CWnd::P reTranslateMessage. (Przesłania CVSListBoxBase::PreTranslateMessage).
CVSListBox::RemoveItem	Usuwa element z kontrolki listy edytowalnej. (Przesłania CVSListBoxBase::RemoveItem).
CVSListBox::SelectItem	Wybiera edytowalny ciąg kontrolki listy. (Przesłania CVSListBoxBase::SelectItem).
CVSListBox::SetItemData	Kojarzy wartość 32-bitową specyficzną dla aplikacji z edytowalnym elementem kontrolki listy. (Przesłania CVSListBoxBase::SetItemData).

Metody chronione

Nazwa/nazwisko	opis
CVSListBox::GetListHwnd	Zwraca uchwyt do bieżącej osadzonej kontrolki widoku listy.

Uwagi

Klasa CVSListBox udostępnia zestaw przycisków edycji, które umożliwiają użytkownikowi tworzenie, modyfikowanie, usuwanie lub zmienianie kolejności elementów w kontrolce listy.

Poniżej przedstawiono obraz kontrolki listy edytowalnej. Drugi wpis listy, zatytułowany "Item2", jest wybierany do edycji.

Jeśli używasz edytora zasobów do dodawania kontrolki listy edytowalnej, zwróć uwagę, że okienko Przybornik edytora nie udostępnia wstępnie zdefiniowanej kontrolki listy edytowalnej. Zamiast tego dodaj kontrolkę statyczną, taką jak kontrolka Group Box . Struktura używa kontrolki statycznej jako symbolu zastępczego, aby określić rozmiar i położenie kontrolki listy edytowalnej.

Aby użyć edytowalnej kontrolki listy w szablonie okna dialogowego, zadeklaruj zmienną CVSListBox w klasie okna dialogowego. Aby obsługiwać wymianę danych między zmienną a kontrolką, zdefiniuj DDX_Control wpis makra w DoDataExchange metodzie okna dialogowego. Domyślnie kontrolka listy edytowalnej jest tworzona bez przycisków edycji. Użyj dziedziczonej metody CVSListBoxBase::SetStandardButtons, aby włączyć przyciski edycji.

Aby uzyskać więcej informacji, zobacz katalog Samples, New Controls przykład, pliki Page3.cpp i Page3.h.

Hierarchia dziedziczenia

Cobject

Ccmdtarget

Cwnd

Cstatic

CVSListBoxBase

CVSListBox

Wymagania

Nagłówek: afxvslistbox.h

CVSListBox::AddItem

Dodaje ciąg do kontrolki listy.

virtual int AddItem(
    const CString& strIext,
    DWORD_PTR dwData=0,
    int iIndex=-1);

Parametry

strIext
[in] Odwołanie do ciągu.

dwData
[in] Wartość 32-bitowa specyficzna dla aplikacji, która jest skojarzona z ciągiem. Wartość domyślna to 0.

Iindex
[in] Indeks oparty na zera pozycji, która będzie przechowywać ciąg. Jeśli parametr iIndex to -1, ciąg zostanie dodany na końcu listy. Wartość domyślna to -1.

Wartość zwracana

Indeks oparty na zera pozycji ciągu w kontrolce listy.

Uwagi

Użyj metody CVSListBox::GetItemData, aby pobrać wartość określoną przez parametr dwData. Ta wartość może być liczbą całkowitą specyficzną dla aplikacji lub wskaźnikiem do innych danych.

CVSListBox::CVSListBox

CVSListBox Tworzy obiekt.

CVSListBox();

Wartość zwracana

Uwagi

CVSListBox::EditItem

Uruchamia operację edycji w tekście elementu kontrolki listy.

virtual BOOL EditItem(int iIndex);

Parametry

Iindex
[in] Zerowy indeks elementu kontrolki listy.

Wartość zwracana

WARTOŚĆ TRUE, jeśli operacja edycji zostanie pomyślnie uruchomiona; w przeciwnym razie, FAŁSZ.

Uwagi

Użytkownik uruchamia operację edycji, klikając dwukrotnie etykietę elementu lub naciskając klawisz F2 lub SPACJA , gdy element ma fokus.

CVSListBox::GetCount

Pobiera liczbę ciągów w kontrolce listy edytowalnej.

virtual int GetCount() const;

Wartość zwracana

Liczba elementów w kontrolce listy.

Uwagi

Należy pamiętać, że liczba jest większa niż wartość indeksu ostatniego elementu, ponieważ indeks jest oparty na zera.

CVSListBox::GetItemData

Pobiera wartość 32-bitową specyficzną dla aplikacji skojarzona z edytowalnym elementem kontrolki listy.

virtual DWORD_PTR GetItemData(int iIndex) const;

Parametry

Iindex
[in] Indeks zerowy edytowalnego elementu kontrolki listy.

Wartość zwracana

Wartość 32-bitowa skojarzona z określonym elementem.

Uwagi

Użyj metody CVSListBox::SetItemData lub CVSListBox::AddItem, aby skojarzyć wartość 32-bitową z elementem kontrolki listy. Ta wartość może być liczbą całkowitą specyficzną dla aplikacji lub wskaźnikiem do innych danych.

CVSListBox::GetItemText

Pobiera tekst edytowalnego elementu kontrolki listy.

virtual CString GetItemText(int iIndex) const;

Parametry

Iindex
[in] Indeks zerowy edytowalnego elementu kontrolki listy.

Wartość zwracana

Obiekt CString zawierający tekst określonego elementu.

Uwagi

CVSListBox::GetListHwnd

Zwraca uchwyt do bieżącej osadzonej kontrolki widoku listy.

virtual HWND GetListHwnd() const;

Wartość zwracana

Uchwyt do osadzonej kontrolki widoku listy.

Uwagi

Użyj tej metody, aby pobrać uchwyt do osadzonej kontrolki widoku listy, która obsługuje klasę CVSListBox .

CVSListBox::GetSelItem

Pobiera indeks zerowy aktualnie wybranego elementu w kontrolce listy edytowalnej.

virtual int GetSelItem() const;

Wartość zwracana

Jeśli ta metoda zakończy się pomyślnie, indeks oparty na zerze aktualnie wybranego elementu; w przeciwnym razie, -1.

Uwagi

CVSListBox::RemoveItem

Usuwa element z kontrolki listy edytowalnej.

virtual BOOL RemoveItem(int iIndex);

Parametry

Iindex
[in] Indeks zerowy edytowalnego elementu kontrolki listy.

Wartość zwracana

WARTOŚĆ TRUE, jeśli określony element zostanie usunięty; w przeciwnym razie, FAŁSZ.

Uwagi

CVSListBox::SelectItem

Wybiera edytowalny ciąg kontrolki listy.

virtual BOOL SelectItem(int iItem);

Parametry

Iitem
[in] Indeks zerowy edytowalnego elementu kontrolki listy.

Wartość zwracana

Wartość TRUE, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ.

Uwagi

Ta metoda wybiera określony element, a jeśli jest to wymagane, przewija element do widoku.

CVSListBox::SetItemData

Kojarzy wartość 32-bitową specyficzną dla aplikacji z edytowalnym elementem kontrolki listy.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Parametry

Iindex
[in] Indeks zerowy edytowalnego elementu kontrolki listy.

dwData
[in] Wartość 32-bitowa. Ta wartość może być liczbą całkowitą specyficzną dla aplikacji lub wskaźnikiem do innych danych.

Uwagi

Zobacz też

Wykres hierarchii
Klasy