Skip to content

Skip_Button_Mode - TabDialog

Governs the way tab button navigation is done with the keyboard and mouse (when pointer_only_state is True)

Type: Property
Access: Read/Write
Data Type: Integer
Parameters: None

Syntax

Property Integer Skip_Button_Mode
Access Type Syntax
Read Access: Get Skip_Button_Mode to IntegerVariable
Write Access: Set Skip_Button_Mode to IntegerVariable/Value

Description

When Pointer_Only_State is True, Skip_Button_Mode property governs the way tab button navigation is done with the keyboard and mouse.

In its default state of SBM_SMART, the navigation follows standard Windows behavior, which while easy to use, is actually difficult to explain. When moving from an object on the tab page to its tab button, the tab button will take the focus. When moving from an object on the tab page to a tab button on a different page, the new page will be displayed and the first focusable object in the page will receive the focus. When moving from a tab button to another tab button, the new page will be displayed and the tab button will take the focus. This sounds complicated, but feels intuitive to users, and it is a standard behavior.

When set to SBM_NEVER, the tab button will never be skipped (it always takes the focus).

When set to SBM_ALWAYS, the tab button will always be skipped (it never takes the focus).

Default is SBM_SMART.