ICeFileFilter::FilterOptions
This method displays a dialog box that lets the user select from the options supported by a file filter.
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.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.0 and later | Replfilt.h |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.