IFileDialog::SetFileTypes 메서드(shobjidl_core.h)

  • 아티클

대화 상자에서 열거나 저장할 수 있는 파일 형식을 설정합니다.

구문

HRESULT SetFileTypes(
  [in] UINT                    cFileTypes,
  [in] const COMDLG_FILTERSPEC *rgFilterSpec
);

매개 변수

[in] cFileTypes

형식: UINT

rgFilterSpec에 지정된 배열의 요소 수입니다.

[in] rgFilterSpec

형식: const COMDLG_FILTERSPEC*

각각 파일 형식을 나타내는 COMDLG_FILTERSPEC 구조체 배열에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 다음을 포함하여 HRESULT 오류 코드를 반환합니다.

반환 코드 설명
E_UNEXPECTED

SetFileTypes가 이미 호출되었습니다.
E_UNEXPECTED
 FOS_PICKFOLDERS 플래그는 IFileDialog::SetOptions 메서드에서 설정되었습니다.
E_INVALIDARG
 rgFilterSpec 매개 변수는 NULL입니다.

설명

열기 대화 상자를 사용하는 경우 선언된 파일 형식이 뷰를 필터링하는 데 사용됩니다. 저장 대화 상자를 사용할 때 이러한 값은 파일 이름에 추가되는 파일 이름 확장명을 결정합니다.

이 메서드는 대화 상자가 표시되기 전에 호출해야 하며 각 대화 instance 대해 한 번만 호출할 수 있습니다. 공통 항목 대화 상자가 표시되면 파일 형식을 수정할 수 없습니다.

예제

다음 코드 예제에서는이 메서드의 컨텍스트에서 COMDLG_FILTERSPEC 구조의 배열을 사용 하는 방법을 보여 줍니다. 예제 배열은 세 가지 COMDLG_FILTERSPEC 구조로 구성됩니다. 첫 번째는 대화 필터에 대해 두 개의 패턴을 선언하고, 두 번째 패턴은 단일 패턴을 선언하고, 마지막에는 모든 형식의 파일이 표시됩니다. szJPG, szBMP 및 szAll 변수는 각 필터에 친숙한 이름을 제공하는 이전에 선언된 문자열로 간주됩니다.

COMDLG_FILTERSPEC rgSpec[] =
{ 
    { szJPG, L"*.jpg;*.jpeg" },
    { szBMP, L"*.bmp" },
    { szAll, L"*.*" },
};

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)