ITaskbarList  Interface

IID_ITaskbarList

{56FDF342-FD6D-11d0-958A-006097C9A090}

The ITaskbarList interface is used to control the taskbar. It allows you to dynamically add items to the taskbar, remove items from the taskbar, and activate items on the taskbar.

Remarks

You do not implement ITaskbarList; it is implemented by the Shell.

Use ITaskbarList to add items to the taskbar, remove items from the taskbar, and activate items on the taskbar.

See Modifying Contents of the Taskbar for more information about using this interface.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ITaskbarList Methods

Description

HrInit

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

AddTab

Adds an item to the taskbar.

DeleteTab

Deletes an item from the taskbar.

ActivateTab

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

SetActiveAlt

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

HrInit

FUNCTION ITaskbarList_HrInit ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING ITaskbarList_HrInit (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

AddTab

FUNCTION ITaskbarList_AddTab ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL hwnd AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING ITaskbarList_AddTab (pthis, hwnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

DeleteTab

FUNCTION ITaskbarList_DeleteTab ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL hwnd AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[5] USING ITaskbarList_DeleteTab (pthis, hwnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

DeleteTab

FUNCTION ITaskbarList_ActivateTab ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL hwnd AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[6] USING ITaskbarList_ActivateTab (pthis, hwnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

SetActiveAlt

FUNCTION ITaskbarList_SetActiveAlt ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL hwnd AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[7] USING ITaskbarList_SetActiveAlt (pthis, hwnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION