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 [데스크톱 앱만 해당] |
헤더 |
|