CVSListBox 클래스
이 클래스는 CVSListBox 편집 가능한 목록 컨트롤을 지원합니다.
구문
class CVSListBox : public CVSListBoxBase
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CVSListBox::CVSListBox | CVSListBox 개체를 생성합니다. |
CVSListBox::~CVSListBox |
소멸자 |
공용 메서드
| 이름 | 설명 |
|---|---|
| CVSListBox::AddItem | 목록 컨트롤에 문자열을 추가합니다. ( CVSListBoxBase::AddItem을 재정의합니다.) |
| CVSListBox::EditItem | 목록 컨트롤 항목의 텍스트에 대한 편집 작업을 시작합니다. ( CVSListBoxBase::EditItem을 재정의합니다.) |
| CVSListBox::GetCount | 편집 가능한 목록 컨트롤의 문자열 수를 검색합니다. ( CVSListBoxBase::GetCount을 재정의합니다.) |
| CVSListBox::GetItemData | 편집 가능한 목록 컨트롤 항목과 연결된 애플리케이션별 32비트 값을 검색합니다. ( CVSListBoxBase::GetItemData을 재정의합니다.) |
| CVSListBox::GetItemText | 편집 가능한 목록 컨트롤 항목의 텍스트를 검색합니다. ( CVSListBoxBase::GetItemText을 재정의합니다.) |
| CVSListBox::GetSelItem | 편집 가능한 목록 컨트롤에서 현재 선택한 항목의 인덱스(0부터 시작하는 인덱스)를 검색합니다. ( CVSListBoxBase::GetSelItem을 재정의합니다.) |
CVSListBox::PreTranslateMessage |
TranslateMessage 및 DispatchMessage Windows 함수로 디스패치되기 전에 창 메시지를 변환합니다. 자세한 내용 및 메서드 구문 은 CWnd::P reTranslateMessage를 참조하세요. ( CVSListBoxBase::PreTranslateMessage을 재정의합니다.) |
| CVSListBox::RemoveItem | 편집 가능한 목록 컨트롤에서 항목을 제거합니다. ( CVSListBoxBase::RemoveItem을 재정의합니다.) |
| CVSListBox::SelectItem | 편집 가능한 목록 컨트롤 문자열을 선택합니다. ( CVSListBoxBase::SelectItem을 재정의합니다.) |
| CVSListBox::SetItemData | 애플리케이션별 32비트 값을 편집 가능한 목록 컨트롤 항목과 연결합니다. ( CVSListBoxBase::SetItemData을 재정의합니다.) |
보호된 메서드
| 속성 | 설명 |
|---|---|
| CVSListBox::GetListHwnd | 현재 포함된 목록 보기 컨트롤에 대한 핸들을 반환합니다. |
설명
이 클래스는 CVSListBox 사용자가 목록 컨트롤의 항목을 만들거나, 수정하거나, 삭제하거나, 다시 정렬할 수 있도록 하는 편집 단추 집합을 제공합니다.
다음은 편집 가능한 목록 컨트롤의 그림입니다. "Item2"라는 두 번째 목록 항목이 편집용으로 선택됩니다.
리소스 편집기를 사용하여 편집 가능한 목록 컨트롤 을 추가하는 경우 편집기의 도구 상자 창에서 미리 정의된 편집 가능한 목록 컨트롤을 제공하지 않습니다. 대신 Group Box 컨트롤과 같은 정적 컨트롤을 추가합니다. 프레임워크는 정적 컨트롤을 자리 표시자로 사용하여 편집 가능한 목록 컨트롤의 크기와 위치를 지정합니다.
대화 상자 템플릿에서 편집 가능한 목록 컨트롤을 사용하려면 대화 상자 클래스에서 변수를 CVSListBox 선언합니다. 변수와 컨트롤 간의 데이터 교환을 지원하려면 대화 상자의 메서드에서 DoDataExchange 매크로 항목을 정의 DDX_Control 합니다. 기본적으로 편집 가능한 목록 컨트롤은 편집 단추 없이 만들어집니다. 상속된 CVSListBoxBase::SetStandardButtons 메서드를 사용하여 편집 단추를 사용하도록 설정합니다.
자세한 내용은 샘플 디렉터리, 샘플, New Controls Page3.cpp 및 Page3.h 파일을 참조하세요.
상속 계층 구조
CVSListBoxBase
요구 사항
헤더: afxvslistbox.h
CVSListBox::AddItem
목록 컨트롤에 문자열을 추가합니다.
virtual int AddItem(
const CString& strIext,
DWORD_PTR dwData=0,
int iIndex=-1);
매개 변수
strIext
[in] 문자열에 대한 참조입니다.
dwData
[in] 문자열과 연결된 애플리케이션별 32비트 값입니다. 기본값은 0입니다.
iIndex
[in] 문자열을 보유할 위치의 인덱스(0부터 시작하는 인덱스)입니다. iIndex 매개 변수가 -1이면 문자열이 목록의 끝에 추가됩니다. 기본값은 -1입니다.
Return Value
목록 컨트롤에서 문자열 위치의 인덱스(0부터 시작하는 인덱스)입니다.
설명
CVSListBox::GetItemData 메서드를 사용하여 dwData 매개 변수로 지정된 값을 검색합니다. 이 값은 애플리케이션별 정수 또는 다른 데이터에 대한 포인터일 수 있습니다.
CVSListBox::CVSListBox
CVSListBox 개체를 생성합니다.
CVSListBox();
Return Value
설명
CVSListBox::EditItem
목록 컨트롤 항목의 텍스트에 대한 편집 작업을 시작합니다.
virtual BOOL EditItem(int iIndex);
매개 변수
iIndex
[in] 목록 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
편집 작업이 성공적으로 시작되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
사용자는 항목의 레이블을 두 번 클릭하거나 항목에 포커스가 있을 때 F2 또는 스페이스바 키를 눌러 편집 작업을 시작합니다.
CVSListBox::GetCount
편집 가능한 목록 컨트롤의 문자열 수를 검색합니다.
virtual int GetCount() const;
Return Value
목록 컨트롤의 항목 수입니다.
설명
인덱스가 0부터 시작하므로 개수가 마지막 항목의 인덱스 값보다 1보다 큽니다.
CVSListBox::GetItemData
편집 가능한 목록 컨트롤 항목과 연결된 애플리케이션별 32비트 값을 검색합니다.
virtual DWORD_PTR GetItemData(int iIndex) const;
매개 변수
iIndex
[in] 편집 가능한 목록 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
지정된 항목과 연결된 32비트 값입니다.
설명
CVSListBox::SetItemData 또는 CVSListBox::AddItem 메서드를 사용하여 32비트 값을 목록 컨트롤 항목과 연결합니다. 이 값은 애플리케이션별 정수 또는 다른 데이터에 대한 포인터일 수 있습니다.
CVSListBox::GetItemText
편집 가능한 목록 컨트롤 항목의 텍스트를 검색합니다.
virtual CString GetItemText(int iIndex) const;
매개 변수
iIndex
[in] 편집 가능한 목록 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
지정된 항목의 텍스트가 들어 있는 CString 개체입니다.
설명
CVSListBox::GetListHwnd
현재 포함된 목록 보기 컨트롤에 대한 핸들을 반환합니다.
virtual HWND GetListHwnd() const;
Return Value
포함된 목록 보기 컨트롤에 대한 핸들입니다.
설명
이 메서드를 사용하여 클래스를 지원하는 포함된 목록 보기 컨트롤에 대한 핸들을 CVSListBox 검색합니다.
CVSListBox::GetSelItem
편집 가능한 목록 컨트롤에서 현재 선택한 항목의 인덱스(0부터 시작하는 인덱스)를 검색합니다.
virtual int GetSelItem() const;
Return Value
이 메서드가 성공하면 현재 선택한 항목의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.
설명
CVSListBox::RemoveItem
편집 가능한 목록 컨트롤에서 항목을 제거합니다.
virtual BOOL RemoveItem(int iIndex);
매개 변수
iIndex
[in] 편집 가능한 목록 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
지정된 항목이 제거되면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CVSListBox::SelectItem
편집 가능한 목록 컨트롤 문자열을 선택합니다.
virtual BOOL SelectItem(int iItem);
매개 변수
iItem
[in] 편집 가능한 목록 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
이 메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
이 메서드는 지정된 항목을 선택하고 필요한 경우 항목을 보기로 스크롤합니다.
CVSListBox::SetItemData
애플리케이션별 32비트 값을 편집 가능한 목록 컨트롤 항목과 연결합니다.
virtual void SetItemData(
int iIndex,
DWORD_PTR dwData);
매개 변수
iIndex
[in] 편집 가능한 목록 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.
dwData
[in] 32비트 값입니다. 이 값은 애플리케이션별 정수 또는 다른 데이터에 대한 포인터일 수 있습니다.