# Function Reference

# _GUICtrlTab_SetCurFocus

Sets the focus to a specified tab

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

## Parameters

$hWnd | Control ID/Handle to the control
$iIndex | 0-based item index

## Return Value

None.

## Remarks

If the tab control has the $TCS_BUTTONS style (button mode), the tab with the focus may be different from the selected tab.
For example, when a tab is selected, the user can press the arrow keys to set the focus to a different tab without changing the selected tab.
In button mode, $TCM_SETCURFOCUS sets the input focus to the button associated with the specified tab, but it does not change the selected tab.
If the tab control does not have the $TCS_BUTTONS style, changing the focus also changes the selected tab.

## Related

_GUICtrlTab_GetCurFocus

## Example

    #include "Extras\HelpFileInternals.au3"

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

    Example()

    Func Example()
        ; Create GUI
        Local $hGUI = GUICreate("Tab Get/Set Current Focus (v" & @AutoItVersion & ")", 450, 300, 100, 100)
        Local $idTab = GUICtrlCreateTab(2, 2, 446, 266)
        _MemoMsgBoxStatus() ; Status creation

        GUISetState(@SW_SHOW)

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

        ; Get/Set current focus
        _MemoMsgBox($MB_SYSTEMMODAL, "Information", "Set Current Focus: #1")
        _GUICtrlTab_SetCurFocus($idTab, 1)
        _MemoMsgBox($MB_SYSTEMMODAL, "Information", "Get Current Focus: #" & _GUICtrlTab_GetCurFocus($idTab))

        _MemoMsgBoxStatus("", -1, $hGUI) ; no more action, wait GUI for closing

    EndFunc   ;==>Example