DlgDirList

DlgDirList 함수는 지정 된 경로 또는 파일 이름에 일치 하는 모든 파일의 이름으로 지정 된 목록 상자를 채웁니다.

DlgDirList ( int HWND  hDlg, / / 목록 상자 대화 상자에 대 한 핸들LPTSTRlpPathSpec, / / 경로 또는 파일 이름 문자열에 대 한 포인터intnIDListBox, / / 목록 상자의 식별자intnIDStaticPath, / / 정적 컨트롤의 식별자UINTuFileType / / 표시할 특성 파일);
 

매개 변수

hDlg
목록 상자가 포함 된 대화 상자에 대 한 핸들.
lpPathSpec
경로 또는 파일 이름을 포함 하는 null로 끝나는 문자열 포인터입니다. DlgDirList 수정 포함 하도록 충분히 되어야 한다이 문자열을 수정 합니다. 이 매개 변수에 대 한 자세한 내용은 주의 섹션을 참조 하십시오.
nIDListBox
목록 상자의 식별자를 지정합니다. 이 매개 변수가 0 이면 DlgDirList 가정 목록 상자 없음 존재 하나를 작성 하려고 시도 하지 않습니다.
nIDStaticPath
현재 드라이브와 디렉터리를 표시 하는 데 사용 되는 정적 컨트롤의 식별자를 지정 합니다. 이 매개 변수가 0 인 경우 DlgDirList 같은 컨트롤이 있는지 가정.
uFileType
표시할 파일의 특성을 지정 합니다. 이 매개 변수는 다음 값 중 하나 이상 이어야 합니다.:
설명
DDL_ARCHIVE 보관 된 파일 포함.
DDL_DIRECTORY 하위 디렉터리를 포함합니다. 하위 디렉터리 이름은 대괄호 ()에 포함 되는지.
DDL_DRIVES 드라이브를 포함 합니다. 드라이브에에서 나와 양식 [-x-], 여기서 x 는 드라이브 문자.
DDL_EXCLUSIVE 지정 된 특성이 있는 파일만 포함 됩니다. 기본적으로 읽기 / 쓰기 파일 DDL_READWRITE을 지정 하지 않은 경우에 나열 됩니다.
DDL_HIDDEN 숨겨진된 파일을 포함.
DDL_READONLY 읽기 전용 파일을 포함.
DDL_READWRITE 없는 추가 특성을 읽기 / 쓰기 파일을 포함.
DDL_SYSTEM 시스템 파일을 포함.
DDL_POSTMSGS 응용 프로그램의 메시지 큐에 메시지를 게시 하는 방법 기본적으로 DlgDirList 대화 상자 프로시저에 직접 메시지를 보냅니다.

반환 값

함수가 성공 하면 반환 값은 0이 아닌.

함수가 실패 하면 반환 값은 0입니다. 예를 들어, lpPathSpec 로 지정 된 문자열이 유효한 경로가 없는 경우 함수가 실패 합니다. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

LpPathSpec 매개 변수의 길이가 0 인 문자열을 지정 하거나 문자열을 변경할 수 없는 파일 이름으로 디렉터리 이름만 지정 하는 경우 *. *

LpPathSpec 매개 변수는 다음과 같은 형태:

[드라이브:] [[\u]디렉토리[\i디렉터리] \u] [filename]

이 예제에서는 드라이브 는 드라이브 문자, 디렉터리 는 올바른 디렉터리 이름 및 filename 은 적어도 하나의 와일드 카드를 포함 해야 합니다 유효한 파일 이름 (? 또는 *).

LpPathSpec 드라이브 또는 디렉터리 이름 또는 둘 다를 포함 하는 경우 현재 드라이브와 디렉터리는 지정 된 드라이브 및 디렉터리에 전에 변경 목록 상자가 채워집니다. NIDStaticPath 매개 변수에 의해 식별 된 정적 컨트롤은 또한 새 드라이브 또는 디렉터리 이름 업데이트.

목록 상자를 채운 후 DlgDirList 드라이브 또는 디렉터리 부분 경로와 파일 이름을 둘 다를 제거 하 여 lpPathSpec 을 업데이트합니다.

DlgDirList 목록 상자에 LB_RESETCONTENT 및 LB_DIR 메시지를 보냅니다.

QuickInfo

nbsp;?Windows &NT: 버전 3.1 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:지원 되지 않습니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

목록 상자 개요, 목록 상자 기능, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

 

Index