Function Reference


_GUICtrlTab_RemoveImage

Removes an image from the control's image list

#include <GuiTab.au3>
_GUICtrlTab_RemoveImage ( $hWnd, $iIndex )

Parameters

$hWnd Control ID/Handle to the control
$iIndex 0-based index of the image to remove

Return Value

None.

Remarks

The tab control updates each tab's 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.

Example

#include <GUIConstantsEx.au3>
#include <GuiImageList.au3>
#include <GuiTab.au3>
#include <MsgBoxConstants.au3>
#include <WinAPIGdi.au3>

Example()

Func Example()
        Local $hGUI, $hImage, $idTab

        ; Create GUI
        $hGUI = GUICreate("Tab Control Remove Image", 400, 300)
        $idTab = GUICtrlCreateTab(2, 2, 396, 296)
        GUISetState(@SW_SHOW)

        ; Create images
        $hImage = _GUIImageList_Create()
        _GUIImageList_Add($hImage, _WinAPI_CreateSolidBitmap($hGUI, 0xFF0000, 16, 16))
        _GUIImageList_Add($hImage, _WinAPI_CreateSolidBitmap($hGUI, 0x00FF00, 16, 16))
        _GUIImageList_Add($hImage, _WinAPI_CreateSolidBitmap($hGUI, 0x0000FF, 16, 16))
        _GUICtrlTab_SetImageList($idTab, $hImage)

        ; Add tabs
        _GUICtrlTab_InsertItem($idTab, 0, "Tab 1", 0)
        _GUICtrlTab_InsertItem($idTab, 1, "Tab 2", 1)
        _GUICtrlTab_InsertItem($idTab, 2, "Tab 3", 2)

        ; Remove second image
        MsgBox($MB_SYSTEMMODAL, "Information", "Removing second image in list")
        _GUICtrlTab_RemoveImage($idTab, 1)

        ; Loop until the user exits.
        Do
        Until GUIGetMsg() = $GUI_EVENT_CLOSE
        GUIDelete()
EndFunc   ;==>Example