IShellBrowser::GetControlWindow

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]

GetControlWindow can be called by the shell view object to get the window handle of an Explorer control, either for a toolbar or for a status window.

HRESULT GetControlWindow(

UINT id,	// Identifier of an Explorer control
HWND *lphwnd	// Handle of the control's window
);

Parameters
id
Specifies the identifer for either a toolbar (FCW_TOOLBAR), for a status window (FCW_STATUS), or for a tree (FCW_TREE).

lphwnd
Pointer to the window handle of the Explorer control.

Return Values
Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks
GetControlWindow is used so views can directly manipulate the toolbar and status bar. FCW_TREE should be used only to sense whether the tree is present; that is, whether the folder is in Explorer mode or folder mode.

Notes to Callers
This is used to manipulate and test the state of these windows. Do not send messages directly to these controls; instead, use IShellBrowser::SendControlMsg. Be prepared for the returns of this call to be NULL. Future versions of the Explorer may not include a toolbar, status bar, or tree window.

Notes to Implementors
IShellBrowser::GetControlWindow returns the hwnds of these controls if they exist in your implementation.