Funktionreferenz


_GUICtrlTab_SetCurFocus

Beschreibung anzeigen in

Setzt den Fokus auf den festgelegten Tab

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

Parameter

$hWnd Control-ID / Handle des Controls
$iIndex 0-basierender Itemindex

Rückgabewert

Keine.

Bemerkungen

Falls ein Tab-Control den Stil $TCS_BUTTONS besitzt (Button Modus) ist der Tab mit dem Fokus vielleicht ein anderer als der ausgewählte Tab.
Wenn zum Beispiel ein Tab ausgewählt wird, so kann der Benutzer die Pfeiltasten drücken um den Fokus auf einen anderen Tab zu setzen, ohne das der ausgewählte Tab geändert wird.
Im Button Modus setzt $TCM_SETCURFOCUS den Eingabefokus zu dem Button, welche mit dem festgelegten Tab verbunden ist. Dabei wird aber der ausgewählte Tab nicht geändert.

Falls ein Tab-Control den Stil $TCS_BUTTONS nicht besitzt, wird der ausgewählte Tab samt dem Tab mit dem Fokus geändert.

- - - - - - - - Erklärung der Controls - - - - - - - -

Verwandte Funktionen

_GUICtrlTab_GetCurFocus

Beispiel

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

Example()

Func Example()
    ; Erstellt eine GUI
    GUICreate("Tab: Setzt und ermittelt den aktuellen Fokus (v" & @AutoItVersion & ")", 500, 300)
    Local $idTab = GUICtrlCreateTab(2, 2, 396, 296)
    GUISetState(@SW_SHOW)

    ; Fügt Tabs hinzu
    _GUICtrlTab_InsertItem($idTab, 0, "Tab 0")
    _GUICtrlTab_InsertItem($idTab, 1, "Tab 1")
    _GUICtrlTab_InsertItem($idTab, 2, "Tab 2")

    ; Ermittelt/Setzt den aktuellen Fokus, ermittelt den Text des Tab-Items
    _GUICtrlTab_SetCurFocus($idTab, 1)
    MsgBox($MB_SYSTEMMODAL, "Information", "Aktueller Fokus: " & _GUICtrlTab_GetCurFocus($idTab))

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>Example