IFileDialogEvents::OnTypeChange method (shobjidl_core.h)

Article
10/13/2021

Called when the dialog is opened to notify the application of the initial chosen filetype.

Syntax

HRESULT OnTypeChange(
  [in] IFileDialog *pfd
);

Parameters

[in] pfd

Type: IFileDialog*

A pointer to the interface that represents the dialog.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method is called when the dialog is opened to notify the application of the initially chosen filetype. If the application has code in IFileDialogEvents that responds to type changes, it can respond to the type. For example, it could hide certain controls. The application controls the initial file type and could do its own checks, so this method is provided as a convenience.

Requirements

Requirement	Value
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)