Remarks
Changes the portion of waveform currently selected through the tracker. The current selection, if any, can be retrieved calling the WaveformAnalyzer.GetSelection method.
After a call to this method the control will fire the WaveAnalyzerSelectionChange event.
For details about the use of the Waveform Analyzer refer to the How to use the Waveform Analyzer section.
For further details about methods of the Waveform Analyzer refer to the WaveformAnalyzer object section.
Syntax
[Visual Basic]
control.WaveformAnalyzer.SetSelection (
bSelectionAvailable as enumBoolean,
nBeginPosInMs as Long,
nEndPosInMs as Long
) as enumErrorCodes
|
|
[C++]
short control.WaveformAnalyzer.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)
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful
|
|