Adds a new wave range that will be displayed over the waveform's graphics.
Inside the screenshot below you can see 2 examples of wave ranges, each with its own set of colors. Please note that "wave ranges" are a different concept respect to "waveform selection": you can only have one single "waveform selection", whose positioning can be managed through code or through mouse movement, but you can have multiple "wave ranges" managed through code without any mouse management for changing the positioning.
This wave range can be manually moved on the screen through code using the GraphicItemHorzPositionSet method.
During playback of the loaded sound, the WaveAnalyzerWaveRangeReached event is generated when playback position reaches the start position of the wave range and the WaveAnalyzerWaveRangeLeaved event is generated when playback position leaves the end position of the wave range.
This method fails if no sound is currently loaded into the editor
The wave range is automatically destroyed, as all of the other existing graphic items, when the loaded sound is discarded from memory through the FreeMemory method.
For details about graphic items management on the waveform analyzer refer to the How to add graphic items to the Waveform analyzer section.