SelectTreeNode

Description

Selects or deselects a TreeView node in a TreeView DataWindow.

Applies to

DataWindow type

Method applies to

PowerBuilder

DataWindow control


Syntax

PowerBuilder

Integer dw_control.SelectTreeNode(long row, long groupLevel, boolean bSelect)

Argument

Description

dw_control

A reference to a TreeView-style DataWindow control

row

The number of the row that belongs to the group

groupLevel

The TreeView level of the group

bSelect

Indicates whether the TreeView node is selected or not


Return value

Returns 1 if the SelectTreeNode operation succeeds and one of the following negative values if it fails:

-1 -- DataWindow is null

-5 -- One or more of the parameters are invalid

-16 -- DataWindow is not a TreeView DataWindow

Usage

A TreeView DataWindow has several TreeView nodes that can be selected or deselected. You can use the SelectTreeNode method to select or deselect a TreeView node in a TreeView DataWindow that has a particular TreeView level.

The SelectTreeNode method triggers the TreeNodeSelecting and TreeNodeSelected events with a row argument of -1.

Examples

The following example selects the node specified by the text box values:

long row
long level
row=long(sle_row.text)
level=long(sle_level.text)
dw_1.SelectTreeNode(row,level,true)