LB_DIR 메시지
목록 상자에 표시된 목록에 이름을 추가합니다. 메시지는 지정된 문자열 및 파일 특성 집합과 일치하는 디렉터리 및 파일의 이름을 추가합니다. LB_DIR은 매핑된 드라이브 문자를 목록 상자에 추가할 수도 있습니다.
매개 변수
-
wParam
-
목록 상자에 추가할 파일 또는 디렉터리의 특성입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
값 의미 - DDL_ARCHIVE
보관된 파일을 포함합니다. - DDL_DIRECTORY
하위 디렉터리를 포함합니다. 하위 디렉터리 이름은 대괄호([ ])로 묶습니다. - DDL_DRIVES
매핑된 모든 드라이브가 목록에 추가됩니다. 드라이브는 [-x-] 형식으로 나열되며 여기서 x는 드라이브 문자입니다. - DDL_EXCLUSIVE
지정된 특성이 있는 파일만 포함합니다. 기본적으로 DDL_READWRITE가 지정되지 않은 경우에도 읽기/쓰기 파일이 나열됩니다. - DDL_HIDDEN
숨겨진 파일을 포함합니다. - DDL_READONLY
읽기 전용 파일을 포함합니다. - DDL_READWRITE
추가 특성이 없는 읽기/쓰기 파일을 포함합니다. 이 값은 기본 설정입니다. - DDL_SYSTEM
시스템 파일을 포함합니다. -
lParam
-
절대 경로, 상대 경로 또는 파일 이름을 지정하는 null 종료 문자열에 대한 포인터입니다. 절대 경로는 드라이브 문자(예: d:) 또는 UNC 이름(예: \\ machinename\ sharename)으로 시작할 수 있습니다.
문자열이 wParam 매개 변수로 지정된 특성이 있는 파일 이름이나 디렉터리를 지정하는 경우 파일 이름이나 디렉터리가 목록에 추가됩니다. 파일 이름 또는 디렉터리 이름에 와일드카드 문자(? 또는 *)가 포함된 경우 와일드카드 식과 일치하고 wParam 매개 변수로 지정된 특성이 있는 모든 파일 또는 디렉터리가 목록에 추가됩니다.
반환 값
메시지가 성공하면 반환 값은 목록에 추가된 마지막 이름의 인덱스(0부터 시작)입니다.
오류가 발생하면 반환 값은 LB_ERR입니다. 새 문자열을 저장할 공간이 충분하지 않은 경우 반환 값은 LB_ERRSPACE입니다.
설명
LB_INITSTORAGE 메시지는 항목 수가 많은(100개 이상) 목록 상자의 초기화 속도를 높이는 데 도움이 됩니다. 후속 LB_DIR 메시지가 가능한 가장 짧은 시간이 걸리도록 지정된 양의 메모리를 예약합니다. wParam 및 lParam 매개 변수에 대한 예상 비용을 사용할 수 있습니다. 과대 평가하는 경우 추가 메모리가 할당됩니다. 과소 평가하는 경우 요청된 금액을 초과하는 항목에 대해 일반 할당이 사용됩니다.
wParam이 DDL_DIRECTORY 플래그를 포함하고 lParam이 C:\TEMP\*와 같은 첫 번째 수준 디렉터리의 모든 하위 디렉터리를 지정하는 경우 목록 상자에는 항상 루트 디렉터리에 대한 ".." 항목이 포함됩니다. 이는 루트 디렉터리에 숨겨진 특성이나 시스템 특성이 있고 DDL_HIDDEN 및 DDL_SYSTEM 플래그가 지정되지 않은 경우에도 마찬가지입니다. NTFS 볼륨의 루트 디렉터리에는 숨겨진 시스템 특성이 있습니다.
긴 파일 이름이 있는 경우 목록에 표시됩니다.
ANSI 애플리케이션의 경우 시스템은 CP_ACP를 사용하여 목록 상자의 텍스트를 유니코드로 변환합니다. 이로 인해 문제가 발생할 수 있습니다. 예를 들어, 일본어 Windows의 유니코드가 아닌 목록 상자에 있는 악센트 부호가 있는 로마 문자는 깨져서 표시됩니다. 이 문제를 해결하려면 애플리케이션을 유니코드로 컴파일하거나 소유자가 그린 목록 상자를 사용해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|