다음을 통해 공유


ListView 컨트롤

각 항목 옆에 아이콘이 있는 값의 단일 열을 표시하는 ListView 컨트롤입니다. 이를 통해 사용자는 미리 결정된 목록에서 속성에 대한 단일 문자열 또는 정수 값을 선택할 수 있습니다. 가능한 값은 ListView 테이블에서 읽습니다. 컨트롤 테이블의 속성 열에 속성 이름을 입력하여 컨트롤을 정수 또는 문자열 값과 연결할 수 있습니다.

Control 테이블의 텍스트 필드 내용은 ListView 컨트롤에 의해 표시되지 않습니다. 대신 이 필드는 컨트롤에서 표시할 텍스트 스타일을 지정하고 화면 검토 유틸리티에서 사용하는 컨트롤에 대한 설명을 포함합니다. 텍스트 문자열의 글꼴 및 글꼴 스타일을 설정하려면 표시된 문자의 문자열 앞에 {\style} 또는 {&style}을 접두사로 묶습니다. 여기서 style은 TextStyle 테이블의 TextStyle 열에 나열된 식별자입니다. 둘 중 어느 것도 없지만 DefaultUIFont 속성이 유효한 텍스트 스타일로 정의된 경우 앞의 글꼴이 사용됩니다. 다음 정보는 화면 검토 유틸리티에서 컨트롤에 대한 설명으로 읽습니다. 접근성을 참조하세요.

컨트롤 특성

이 컨트롤에서 다음 특성을 사용할 수 있습니다. 이벤트를 사용하여 특성값을 변경하려면 EventMapping 테이블의 ControlEvent에 컨트롤을 구독하고 특성 열에 특성의 식별자를 나열합니다. 이벤트 열에 ControlEvent의 식별자를 입력합니다.

특성 식별자 16진수 비트 설명
IndirectPropertyName 컨트롤과 연결된 간접 속성의 이름입니다. 간접 특성 비트가 설정되면 컨트롤이 이 이름을 가진 속성의 값을 표시하거나 변경합니다. 간접 특성 비트가 설정된 경우 이 이름은 컨트롤 테이블의 속성 열에 나열된 속성의 값이기도 합니다.
위치 대화 상자에서 컨트롤의 위치입니다. 컨트롤의 왼쪽 모서리에 있는 컨트롤의 너비, 높이 및 좌표를 Control 테이블의 너비, 높이, X 및 Y 열에 입력합니다. 길이 및 거리에 설치 관리자 단위를 사용합니다.
PropertyName   이 컨트롤과 연결된 속성의 이름입니다. 간접 특성 비트가 설정되지 않은 경우 컨트롤은 이 이름을 가진 속성의 값을 표시하거나 변경합니다. 이 특성은 컨트롤 테이블의 속성 열에 지정됩니다.
PropertyValue 이 컨트롤에 의해 표시되거나 변경된 속성의 현재 값입니다. 간접 특성 비트가 설정되지 않은 경우 PropertyName 값입니다. Indirect 특성 비트가 설정된 경우 IndirectPropertyName 값입니다. 특성이 변경되면 컨트롤에 새 값이 반영됩니다.
Text 화면 읽기 프로그램에서 텍스트를 표시하려면 Control 테이블의 텍스트 열에 텍스트를 입력합니다. 접근성을 참조하세요.
Visible 0x00000000 0x00000001
숨겨진 컨트롤입니다. 표시되는 컨트롤입니다.
컨트롤 테이블의 속성 열 비트 단어에 이 비트를 포함하면 컨트롤을 만들 때 컨트롤이 표시되거나 숨겨집니다.
ControlCondition 테이블 사용하여 컨트롤을 숨기거나 표시할 수도 있습니다.
Enabled 0x00000000 0x00000002
사용 안 함 상태의 컨트롤입니다. 사용 상태의 컨트롤입니다.
컨트롤을 만들 때 컨트롤을 사용하도록 설정하려면 컨트롤의 특성 열에 있는 비트 단어에 이 비트를 포함합니다.
ControlCondition 테이블 사용하여 컨트롤을 사용하거나 사용하지 않도록 설정할 수도 있습니다.
오목 0x00000000 0x00000004
기본 비주얼 스타일을 표시합니다. 움푹 들어간 3D 모양으로 컨트롤을 표시합니다.
컨트롤 테이블의 특성 열에 비트 단어에 해당 비트를 포함합니다.
간접 0x00000000 0x00000008
컨트롤은 컨트롤 테이블의 속성 열에 속성값을 표시하거나 변경합니다. 컨트롤은 컨트롤 테이블의 속성 열에 식별자가 나열된 속성의 값을 표시하거나 변경합니다.
이 컨트롤과 연결된 속성이 간접적으로 참조되는지 여부를 확인합니다.
정수 0x00000000 0x00000010
컨트롤과 연결된 속성은 문자열 값입니다. 컨트롤과 연결된 속성은 정수 값입니다.
컨트롤을 만들 때 이 특성을 설정하려면 컨트롤 테이블의 특성 열의 비트 단어에 이 비트를 포함합니다.
RTLRO 0x00000000 0x00000020
컨트롤의 텍스트는 왼쪽에서 오른쪽 읽기 순서로 표시됩니다. 컨트롤의 텍스트는 오른쪽에서 왼쪽으로 읽기 순서로 표시됩니다.
RightAligned 0x00000000 0x00000040
컨트롤의 텍스트가 왼쪽에 맞춰집니다. 컨트롤의 텍스트가 오른쪽에 맞춰집니다.
LeftScroll 0x00000000 0x00000080
스크롤 막대는 컨트롤의 오른쪽에 있습니다. 스크롤 막대는 컨트롤의 왼쪽에 있습니다.
BiDi 0x000000E0 RTLRO, RightAlignedLeftScroll 특성의 조합에 대해 이 값을 설정합니다.
정렬 0x00000000 0x00010000
알파벳순으로 항목이 표시됩니다. ListView 테이블에 지정된 순서대로 항목이 표시됩니다.
ListView 테이블의 순서 열에 지정된 순서대로 항목을 표시하려면 특성 열의 비트 단어에 이 비트를 포함합니다.
FixedSize 0x00000000 0x00100000
컨트롤에 맞게 아이콘 이미지를 늘립니다. 컨트롤의 아이콘 이미지를 자르거나 가운데에 표시합니다.
컨트롤 테이블의 특성 열 비트 단어에 이러한 비트를 포함합니다.
IconSize 0x00000000 0x00200000
0x00400000
0x00600000
첫 번째 이미지를 로드합니다. 처음 16x16 이미지를 로드합니다.
처음 32x32 이미지를 로드합니다.
처음 48x48 이미지를 로드합니다.
아이콘 파일에는 동일한 아이콘의 다양한 크기 이미지가 포함될 수 있습니다. 컨트롤 테이블의 특성 열에 적절한 비트 단어의 값을 포함합니다.
이러한 비트가 설정되지 않은 경우 설치 관리자는 FixedSize 특성을 무시하고 이미지가 컨트롤 사각형에 맞게 늘어납니다. IconSize 비트와 FixedSize 비트가 모두 설정되면 컨트롤보다 작은 이미지가 가운데에 배치되고 이미지는 맞춰져서 축소된 컨트롤보다 큽니다.

 

설명

이 컨트롤은 CreateWindowEx 함수를 사용하여 WC_LISTVIEW 클래스에서 만들 수 있습니다. LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERWS_TABSTOP 스타일이 있습니다. 정렬된 스타일 비트가 없는 경우 컨트롤에는 LVS_SORTASCENDING 스타일도 있습니다.

화면 읽기 프로그램과의 호환성을 위해 ListView 컨트롤을 첫 번째 활성 컨트롤로 사용하여 대화 상자를 작성할 때 편집 필드에 속하는 텍스트 필드를 대화 상자 테이블의 첫 번째 활성 컨트롤로 만들어야 합니다. 정적 텍스트는 포커스를 맞출 수 없으므로 대화 상자를 만들면 처음에 의도한 대로 편집 필드에 포커스가 생기지만 이렇게 하면 화면 읽기 프로그램이 올바른 정보를 표시할 수 있습니다.