ICommDlgBrowser::OnStateChange

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

OnStateChange is called after a certain state has changed in the IShellView, as identified by the parameter passed in.

HRESULT OnStateChange(

ULONG uChange	Specifies the change in state
);

Parameters
uChange

Specifies the change in the selection state. This parameter can be one of the following values:

Value	Meaning
CDBOSC_SETFOCUS	The focus has been set to the view.
CDBOSC_KILLFOCUS	The focus has been lost from the view.
CDBOSC_SELCHANGE	The selection has changed.
CDBOSC_RENAME	An item has been renamed.

Return Values
OnStateChange does not return a value.

Remarks
OnStateChange is used to let the common file dialogs track the state of the view and change its UI as needed.

Notes to Callers
When items in the view are selected, or when the view loses the focus, it needs to call this member to notify the common dialog that either the view state or selection state is changing.