SelectionArea Property, SftTree Object


	SftTree.SelectionArea Property	Softel vdm, Inc.

Defines the area where selection changes occur.

Deprecated - Provided for compatibility with earlier versions only - Use Items.SelectionArea instead

Syntax

Get
	VB.NET	Area = object.SelectionArea As SftTreeSelectionAreaConstants
	VB	Area = object.SelectionArea As SftTreeSelectionAreaConstants
	C#.NET	SftTreeSelectionAreaConstants Area = object.SelectionArea;
	VC++	enum SftTreeSelectionAreaConstants Area = object->SelectionArea; enum SftTreeSelectionAreaConstants Area = object->GetSelectionArea();
	C	HRESULT object->get_SelectionArea(enum SftTreeSelectionAreaConstants* Area);
	Delphi	Area := object.SelectionArea : TOleEnum;
Put
	VB.NET	object.SelectionArea = Area As SftTreeSelectionAreaConstants
	VB	object.SelectionArea = Area As SftTreeSelectionAreaConstants
	C#.NET	SftTreeSelectionAreaConstants object.SelectionArea = Area;
	VC++	enum SftTreeSelectionAreaConstants object->SelectionArea = Area; void object->PutSelectionArea(enum SftTreeSelectionAreaConstants Area);
	C	HRESULT object->put_SelectionArea(enum SftTreeSelectionAreaConstants Area);
	Delphi	object.SelectionArea := Area : TOleEnum;

object

A SftTree object.

Area

Defines the area where selection changes occur.

Area	Value	Description
selSftTreeAll	0	Clicking anywhere on an item (all cells, tree lines, row header, etc.) will change the selection.
selSftTreeCells	1	Clicking on any cell of an item will change the selection.
selSftTreeCell1	2	Clicking on the cell in the first column will change the selection.
selSftTreeCellText1	3	Clicking on the cell text in the first column will change the selection.
selSftTreeCellsRow	4	Clicking on the row header or any cell of an item will change the selection.
selSftTreeCell1Row	5	Clicking on the row header or the cell in the first column will change the selection.
selSftTreeCellText1Row	6	Clicking on the row header or the cell text in the first column will change the selection.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use Items.SelectionArea instead

The SelectionArea property defines the area where selection changes occur.

The SelectionChange event occurs every time a selection change takes place.

By using the SelectionArea property, the application can specify which areas of an item can cause a selection change when clicked. If the defined area is clicked, the selection changes (Items.Selection). If an area of the item outside the defined area is clicked, only the current item (Items.Current) is changed.

When using a limited area, such as selSftTreeCellText1, which only changes selections when the cell text is clicked, it is preferable to visually indicate this using the selection style selectSftTreeCell1 (see Items.SelectStyle).

In a multiple selection tree control, the CONTROL key (in combination with directional keys) can be used to move the caret location without moving the current selection, unless the style selSftTreeAll is used, in which case the CONTROL key is ignored.