ITrackShellMenu::SetObscured method (shdeprecated.h)

Coordinates obscured items on a toolbar with items in a menu.


HRESULT SetObscured(
  [in] HWND     hwndTB,
  [in] IUnknown *punkBand,
  [in] DWORD    dwSMSetFlags


[in] hwndTB

Type: HWND

A handle to a toolbar control whose buttons have command IDs that correspond to menu IDs in the tracked menu.

[in] punkBand

Type: IUnknown*

If this parameter points to a COM object that supports the IShellMenu interface, menu items that correspond to visible toolbar buttons are filtered out of the menu so that they do not appear in both places.

If this parameter is NULL or points to a COM object that does not support the IShellMenu interface, then the obscured buttons in the toolbar are added to the shell menu in the position specified in dwSMSetFlags.

[in] dwSMSetFlags


One of the following values.

SMSET_TOP (0x10000000)

New menu items are added at the top of the menu.

SMSET_BOTTOM (0x20000000)

New menu items are added at the bottom of the menu.


Reserved; do not use.

Return value


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


Obscured buttons are those buttons that cannot be displayed due to toolbar size limitations. Commonly, to see them you must press the chevron at the end of the toolbar.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shdeprecated.h
DLL Shell32.dll