DlgDirSelectExW 함수(winuser.h)

아티클
11/20/2024

단일 선택 목록 상자에서 현재 선택 영역을 검색합니다. 목록 상자가 DlgDirList 함수에 의해 채워졌으며 선택 영역이 드라이브 문자, 파일 이름 또는 디렉터리 이름이라고 가정합니다.

통사론

BOOL DlgDirSelectExW(
  [in]  HWND   hwndDlg,
  [out] LPWSTR lpString,
  [in]  int    chCount,
  [in]  int    idListBox
);

매개 변수

[in] hwndDlg

형식: HWND

목록 상자가 포함된 대화 상자에 대한 핸들입니다.

[out] lpString

형식: LPTSTR

선택한 경로를 수신하는 버퍼에 대한 포인터입니다.

[in] chCount

형식: int

lpString가리키는 버퍼의 TCHAR길이입니다.

[in] idListBox

형식: int

대화 상자의 목록 상자 식별자입니다.

반환 값

형식: BOOL

현재 선택 영역이 디렉터리 이름인 경우 반환 값은 0이 아닌 값입니다.

현재 선택 영역이 디렉터리 이름이 아니면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

DlgDirSelectEx 함수는 선택 영역을 lpString 매개 변수가 가리키는 버퍼에 복사합니다. 현재 선택 영역이 디렉터리 이름 또는 드라이브 문자인 경우 DlgDirSelectEx 이름 또는 문자를 새 경로에 삽입할 준비가 되도록 바깥쪽 대괄호(및 드라이브 문자의 경우 하이픈)를 제거합니다. 선택 항목이 없으면 lpString 변경되지 . 문자열이 버퍼보다 길거나 긴 경우 버퍼에는 종료 null 문자가 있는 잘린 문자열이 포함됩니다.

DlgDirSelectExLB_GETCURSEL 및 LB_GETTEXT 메시지를 목록 상자로 보냅니다. 이 함수는 목록 상자에서 둘 이상의 파일 이름을 반환할 수 없습니다. 목록 상자는 다중 선택 목록 상자가 아니어야 합니다. 이 경우 이 함수는 0 값을 반환하지 않으며 lpString 변경되지 않은 상태로 유지됩니다.

Windows 95 이상: DlgDirSelectExW Microsoft Layer for Unicode에서 지원됩니다. 이를 사용하려면 Windows Me/98/95 SystemsMicrosoft Layer for Unicode에 설명된 대로 특정 파일을 애플리케이션에 추가해야 합니다.

예제

예를 들어 단일 선택 목록 상자디렉터리 목록 만들기를 참조하세요.

메모

winuser.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DlgDirSelectEx를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll