ITaskbarList::ActivateTab
Interfaces

ITaskbarList::ActivateTab


HRESULT ActivateTab(
    HWND hwnd
);

Activates an item on the taskbar. The window is not actually activated; the window's item on the taskbar is merely displayed as active.

hwnd
Handle to the window on the taskbar to be displayed as active.

Version 4.71

ITaskbarList::AddTab

HRESULT AddTab(
    HWND hwnd
);

Adds an item to the taskbar.

hwnd
Handle to the window to be added to the taskbar.

Any type of window can be added to the taskbar, but it is recommended that the window at least have the WS_CAPTION style.

Any window added with this method must be removed with the DeleteTab method when the added window is destroyed.

Version 4.71

ITaskbarList::DeleteTab

HRESULT DeleteTab(
    HWND hwnd
);

Deletes an item from the taskbar.

hwnd
Handle to the window to be deleted from the taskbar.

Version 4.71

ITaskbarList::HrInit

HRESULT HrInit(void);

Initializes the taskbar list object. This method must be called before any other ITaskbarList methods can be called.

Version 4.71

ITaskbarList::SetActiveAlt

HRESULT SetActiveAlt(
    HWND hwnd
);

Marks a taskbar item as active but does not visually activate it.

hwnd
Handle to the window to be marked as active.

SetActiveAlt marks the item associated with hwnd as the currently active item for the window's process without changing the pressed state of any item. Any user action that would activate a different tab in that process will activate the tab associated with hwnd instead. The active state of the window's item is not guaranteed to be preserved when the process associated with hwnd is not active. To ensure that a given tab is always active, call SetActiveAlt whenever any of your windows are activated. Calling SetActiveAlt with a NULL hwnd clears this state.

Version 4.71

IURLSearchHook

The IURLSearchHook interface is used by the browser to translate the address of an unknown URL protocol. When attempting to browse to a URL address that does not contain a protocol, the browser will first attempt to determine the correct protocol from the address. If this is not successful, the browser will create URL Search Hook objects and call each object's Translate method until the address is translated or all of the hooks have been queried.

URL Search Hooks are registered by adding a key that contains the object's CLSID string under the following key in the registry:


HKEY_LOCAL_MACHINE\
   Software\
   Microsoft\
   Internet Explorer\
   UrlSearchHooks

When to Implement

Implement this interface if your application defines a custom URL protocol and if address translation for this protocol is required.

When to Use

You do not normally use this interface; it is called by the browser.

IURLSearchHook Method Description
Translate Called by the browser when the browser cannot determine the protocol of a URL address.

Note This interface is only supported in shell versions 4.71 and later.

IURLSearchHook::Translate

HRESULT Translate(
    LPWSTR lpwszSearchURL, 
    DWORD cchBufferSize 
   );		

Called by the browser when the browser cannot determine the protocol of a URL address.

lpwszSearchURL
Address of a wide character buffer that, on entry, contains the URL address for which the browser is trying to determine the protocol. On exit, this buffer contains the modified URL address if the method was successful. See the return value for more information.
cchBufferSize
Size, in characters, of the buffer at lpwszSearchURL.

Version 4.71

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.