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 "Extras\HelpFileInternals.au3"

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

Example()

Func Example()
    ; Erstellt eine GUI
    Local Local $hGUI = GUICreate("Tab: Setzt und ermittelt den aktuellen Fokus (v" & @AutoItVersion & ")", 500, 300, 100, 100)
    Local $idTab = GUICtrlCreateTab(2, 2, 446, 266)
    _MemoMsgBoxStatus() ; Status-Erstellung

    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
    _Memo_MemoMsgBox($MB_SYSTEMMODAL, "Information", "Setzt den aktuellen Fokus: #1")
    _GUICtrlTab_SetCurFocus($idTab, 1)
    _MemoMsgBox($MB_SYSTEMMODAL, "Information", "Ermittelt den aktuellen Fokus: " & _GUICtrlTab_GetCurFocus($idTab))

    _MemoMsgBoxStatus("", -1, $hGui) ; Keine weiteren Aktionen, es wird gewartet bis die GUI geschlossen wird.
EndFunc   ;==>Example