CWnd::DlgDirList

아티클
06/10/2015

파일 또는 디렉터리 목록에 목록 상자를 채웁니다.

int DlgDirList( 
   LPTSTR lpPathSpec, 
   int nIDListBox, 
   int nIDStaticPath, 
   UINT nFileType  
);

매개 변수

lpPathSpec
경로 또는 파일 이름을 포함 하는 null로 끝나는 문자열을 가리킵니다. DlgDirList수정 사항이 포함 될 수 있을 정도로 충분히 있어야 하는이 문자열을 수정 합니다. 자세한 내용은 다음 "설명" 단원을 참조 하십시오.
nIDListBox
목록 상자의 식별자를 지정합니다. 경우 nIDListBox 0 DlgDirList 목록 상자가 있고 하나 작성 하려고 시도 하지 않습니다 가정 합니다.
nIDStaticPath
현재 드라이브와 디렉터리를 표시 하는 데 정적 텍스트 컨트롤의 식별자를 지정 합니다. 경우 nIDStaticPath 0 DlgDirList 가 이러한 텍스트 컨트롤 이라고 가정 합니다.
nFileType
표시 되는 파일의 특성을 지정 합니다. 그 다음 값 조합이 될 수 있습니다.
- DDL_READWRITE 읽기 / 쓰기 데이터 파일에 추가 속성이 없습니다.
- DDL_READONLY 파일을 읽기 전용입니다.
- DDL_HIDDEN 파일은 숨겨져 있습니다.
- DDL_SYSTEM 파일 시스템.
- DDL_DIRECTORY 디렉터리.
- DDL_ARCHIVE 아카이브.
- DDL_POSTMSGS LB_DIR 플래그. 경우는 LB_DIR 플래그가 설정 되어, Windows 환경에서 생성 된 메시지 DlgDirList 응용 프로그램의 큐. 그렇지 않으면 대화 상자 프로시저에 직접 보냅니다.
- DDL_DRIVES 드라이브. 경우는 DDL_DRIVES 플래그가 설정 되어 있는 DDL_EXCLUSIVE 플래그를 자동으로 설정 됩니다. 따라서 드라이브와 파일을 포함 하는 디렉터리 목록을 만들려면 호출 해야 DlgDirList 두 번: 한 번에 DDL_DRIVES 플래그 집합을 한 번 목록의 나머지 부분에 대 한 플래그를.
- DDL_EXCLUSIVE 단독 비트. 배타적 비트 설정 되어 있으면 지정한 형식의 파일만 나열 됩니다. 그렇지 않으면 일반 파일 및 지정 된 형식의 파일 나열 되어 있습니다.

반환 값

함수가 성공 하면 0이 아닌. 그렇지 않으면 0입니다.

설명

DlgDirList보내는 LB_RESETCONTENT 및 LB_DIR 메시지 목록 상자에. 지정 된 목록 상자를 채우는 nIDListBox 에서 지정한 경로 일치 하는 모든 파일의 이름이 lpPathSpec.

lpPathSpec 매개 변수는 없습니다.

[drive:] [ [\u]directory[\idirectory]... \u] [filename]

이 예제에서 drive 드라이브 문자, directory 올바른 디렉터리 이름이 고 파일 이름 적어도 하나의 와일드 카드 있어야 올바른 파일 이름이 있습니다. 물음표 와일드 카드는 (?), 어떤 문자와 별표 일치 (*), 임의 개수의 문자와 일치 하는 것을 의미 합니다.

길이가 0 인 문자열을 지정 하면 lpPathSpec, 또는 디렉터리 이름을 지정 된 파일 사양이 없는 경우 문자열에 변경 됩니다 "*. *"입니다.

경우 lpPathSpec 드라이브 및/또는 디렉터리 이름 목록 상자를 입력 하기 전에 현재 드라이브와 디렉터리에 지정 된 드라이브 및 디렉터리에 변경 됩니다. 텍스트 컨트롤 식별 nIDStaticPath 도 새 드라이브 및/또는 디렉터리 이름으로 업데이트 됩니다.

목록 상자를 입력 한 후 lpPathSpec 드라이브 및/또는 디렉터리의 경로 부분을 제거 하 여 업데이트 됩니다.

예제

// If pDialog points to a CDialog object with a list box 
// with the identifier IDC_DIRLIST, this call will populate 
// the box with only the non-hidden subdirectories in the root 
// directory of the C:\ drive.
TCHAR path[MAX_PATH];
_tcscpy_s(path, MAX_PATH, _T("C:\\"));

pDialog->DlgDirList(path, IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);