This method displays a dialog box that lets the user select from the options supported by a file filter.
At a Glance
Header file: | Replfilt.h |
Windows CE versions: | 2.0 and later |
Syntax
STDMETHODIMP ICeFileFilter::FilterOptions(HWND hwndParent);
Parameters
hwndParent
Handle to the parent window for the filtering options dialog box.
Return Values
NOERROR indicates success. If an error occurs, the appropriate HRESULT value is returned.
Remarks
A file filter that includes user selectable conversion options should implement an ICeFileFilter::FilterOptions method. Windows CE Services calls the filter’s ICeFileFilter::FilterOptions method when the user selects a supported conversion type from the conversion selection dialog box and presses the Options button, which is not supported for Windows CE version 1.0. FilterOptions should display a dialog box that lets the user select from the conversion options supported by the file filter.
A file filter only needs to support the ICeFileFilter::FilterOptions method if the HasOptions named value exists in the \HKEY_CLASSES_ROOT\CLSID\<CLSID>\PegasusFilter key. For more information about file filter registry entries and extension keys, see Transferring Files.