This macro removes an image from a tab controls image list. You can use this macro or send the TCM_REMOVEIMAGE message explicitly.

void TabCtrl_RemoveImage( 
HWND hwnd, 
int iImage );


  • hwnd
    Handle to the tab control.
  • iImage
    Index of the image to remove.

Return Values



The tab control updates each tabs image index, so each tab remains associated with the same image as before. If a tab is using the image being removed, the tab will be set to have no image.


Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also


 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.