IShellBrowser::GetControlWindow
[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.
See Also