NavigateCaptions Property

Description

Specifies whether item captions will receive focus in the grid when items are navigated using the Tab key.

Property Type

Read-write property

Syntax (Visual Basic)

Public Property NavigateCaptions() As Boolean

Remarks

NavigateItems must be True for NavigateCaptions to have any effect. NavigateCaptions is True by default when NavigateItems is enabled.

Set NavigateCaptions to TRUE to enable item caption and item value navigation using the Tab key.

When NavigateCaptions is TRUE, focus will move in the following order when the Tab key is pressed:

Item Caption
Item Value
Item InPlaceButton (if present)
Next Item Caption

When NavigateCaptions is FALSE and NavigateItems is True, focus will move in the following order when the Tab key is pressed:

Item Value
Item InPlaceButton (if present)
Next Item Value

Note: Even when False, the caption will get highlighted/selected, but only the item value will receive focus.

NavigateCaptions is True by default when NavigateItems is enabled.

Example

This sample illustrates how to use the Tab key to navigate items in the property grid without giving the item captions focus.

'Focus will now pass to the next item in the property grid when the tab key is pressed  
'and the value of an item has focus (if an in-place button is not present).  

wndPropertyGrid.NavigateCaptions = False  
wndPropertyGrid.NavigateItems = True