DirectoryList Control
DirectoryList 컨트롤은 PathEdit 컨트롤에 현재 표시되는 경로의 일부를 표시합니다. DirectoryList 컨트롤은 DirectoryCombo 컨트롤에 의해 현재 표시되는 디렉터리 아래에 폴더를 표시합니다.
PathEdit, DirectoryCombo, DirectoryList 컨트롤은 동일한 문자열 값 속성과 연결됩니다. 해당 속성은 사용자가 선택한 경로입니다. 컨트롤 테이블의 속성 열에 속성 이름을 입력합니다. 이 속성에는 볼륨 하나 이상과 하위 수준 하나를 포함하는 초기 값이 있어야 합니다. 속성 테이블의 값 열에서 속성의 초기 값을 지정합니다.
이 컨트롤은 PathEdit 및 DirectoryList 컨트롤과 함께 찾아보기 대화 상자에서 사용됩니다.
DirectoryList 컨트롤은 다음 ControlEvents를 게시합니다.
| ControlEvent | 설명 |
|---|---|
| DirectoryListNew | 새 폴더를 만들고 편집할 이름 필드를 선택합니다. |
| IgnoreChange | 현재 디렉터리의 폴더를 강조 표시하지만 열리지 않습니다. |
| DirectoryListUp | 현재 디렉터리의 부모를 선택합니다. |
| DirectoryListOpen | 디렉터리를 선택하고 강조 표시합니다. |
컨트롤 테이블의 텍스트 필드 내용은 DirectoryList 컨트롤에 의해 표시되지 않습니다. 대신 이 필드는 컨트롤에서 표시할 텍스트 스타일을 지정하고 화면 검토 유틸리티에서 사용하는 컨트롤에 대한 설명을 포함합니다. 텍스트 문자열의 글꼴 및 글꼴 스타일을 설정하려면 표시된 문자의 문자열 앞에 {\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 모양으로 컨트롤을 표시합니다. Control 테이블의 Attributes 열 비트 단어에 이러한 비트를 포함합니다. |
| 간접 | 0x00000000 0x00000008 |
컨트롤은 컨트롤 테이블의 속성 열에 속성값을 표시하거나 변경합니다. 컨트롤은 컨트롤 테이블의 속성 열에 식별자가 나열된 속성의 값을 표시하거나 변경합니다. 이 컨트롤과 연결된 속성이 간접적으로 참조되는지 여부를 확인합니다. |
| RTLRO | 0x00000000 0x00000020 |
컨트롤의 텍스트는 왼쪽에서 오른쪽 읽기 순서로 표시됩니다. 컨트롤의 텍스트는 오른쪽에서 왼쪽으로 읽기 순서로 표시됩니다. |
| RightAligned | 0x00000000 0x00000040 |
컨트롤의 텍스트가 왼쪽에 맞춰집니다. 컨트롤의 텍스트가 오른쪽에 맞춰집니다. |
| LeftScroll | 0x00000000 0x00000080 |
스크롤 막대는 컨트롤의 오른쪽에 있습니다. 스크롤 막대는 컨트롤의 왼쪽에 있습니다. |
| BiDi Control | 0x000000E0 | RTLRO, RightAligned 및 LeftScroll 특성의 조합에 대해 이 값을 설정합니다. |
설명
이 컨트롤은 CreateWindowEx 함수를 사용하여 WC_LISTVIEW 클래스에서 만들 수 있습니다. LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP, WS_TABSTOP 스타일이 있습니다.
이 컨트롤을 사용하면 사용자가 현재 선택 영역의 하위 폴더를 선택할 수 있습니다. 추가 단추를 사용하면 사용자가 현재 선택 영역에서 새 폴더를 선택하거나 경로에서 한 단계 더 올라갈 수도 있습니다. 사용자가 새 폴더가 이미 있는 폴더에서 새 폴더 만들기 단추를 선택하면 두 번째 새 폴더가 만들어지지 않고 기존 새 폴더의 이름이 편집용으로 선택됩니다.