Methods > Operations > SetSelection method

Remarks

Changes the portion of waveform currently selected through the tracker. The current selection, if any, can be retrieved calling the GetSelection method.

After a call to this method the control will fire the WaveAnalyzerSelectionChange event.

Syntax

[Visual Basic]

control.SetSelection (

bSelectionAvailable as enumBoolean,

nBeginPosInMs as Long,

nEndPosInMs as Long

) as enumWanErrorCodes

[C++]

short control.SetSelection (

long bSelectionAvailable,

long nBeginPosInMs,

long nEndPosInMs

);

Parameter

Description

bSelectionAvailable

Flag for selection availability.

Supported values are the following:

Value	Meaning
BOOL_FALSE	Remove the current selection, if any. In this case values passed through nBeginPosInMs and nEndPosInMs parameters are ignored.
BOOL_TRUE	Perform a new selection using values stored inside nBeginPosInMs and nEndPosInMs parameters

nBeginPosInMs

The selection's start position, expressed in milliseconds

nEndPosInMs

The selection's end position, expressed in milliseconds

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumWanErrorCodes.ERR_WAN_NOERROR (0)	The method call was successful