IFileDialog::SetFileTypes method

Sets the file types that the dialog can open or save.

Syntax

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

Parameters

cFileTypes

Type: UINT

The number of elements in the array specified by rgFilterSpec.

rgFilterSpec

Type: const COMDLG_FILTERSPEC*

A pointer to an array of COMDLG_FILTERSPEC structures, each representing a file type.

Return value

Type: HRESULT

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:

Return code Description
E_UNEXPECTED

SetFileTypes has already been called.

E_UNEXPECTED
The FOS_PICKFOLDERS flag was set in the IFileDialog::SetOptions method.
E_INVALIDARG
The rgFilterSpec parameter is NULL.

Remarks

When using the Open dialog, the file types declared there are used to filter the view. When using the Save dialog, these values determine which file name extension is appended to the file name.

This method must be called before the dialog is shown and can only be called once for each dialog instance. File types cannot be modified once the Common Item dialog box is displayed.

Examples

The following code example demonstrates the use of the array of COMDLG_FILTERSPEC structures in the context of this method. The example array consists of three COMDLG_FILTERSPEC structures. The first declares two patterns for the dialog filter, the second declares a single pattern, and the last shows files of all types. The variables szJPG, szBMP, and szAll are assumed to be previously declared strings that provide a friendly name for each filter.

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

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)