Klasa CVSListBox
Klasa CVSListBox obsługuje kontrolkę listy edytowalnej.
Składnia
class CVSListBox : public CVSListBoxBase
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CVSListBox::CVSListBox | CVSListBox Tworzy obiekt. |
CVSListBox::~CVSListBox |
Destruktor. |
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
CVSListBoxBase
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 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.