ButtonsAcceptFocus Property

Applies To: ToolControl

Description

This is a Boolean property that determines how the Tab key and other cursor movement keys are handled by a ToolControl object.

If ButtonsAcceptFocus is 0 (the default), when the user presses Tab or Shift+Tab to switch the input focus from another object to the ToolControl, the first ToolButton in the ToolControl receives the input focus and is highlighted. Pressing Tab or Shift+Tab again causes the input focus to move to another control. The cursor movement keys have no effect.

If ButtonsAcceptFocus is 1, when the user presses Tab or Shift+Tab to switch the input focus from another object to the ToolControl, the first or last ToolButton in the ToolControl receives the input focus and is highlighted. Note that the behaviour of Shift+Tab in this case is different. Pressing Tab or Shift+Tab again causes the input focus to move to another control, although if there is no other control to accept the input focus, it moves to the first or last ToolButton as appropriate. Pressing the cursor movement keys causes the input focus to move from one ToolButton to the next.