COM Objects > WaveformAnalyzer object > Methods > WaveformAnalyzer.GraphicItemHorizontalLineAdd method

Remarks

Adds a new horizontal line that will be displayed over the waveform's graphics.

On the screenshot below you can see a set of horizontal lines displayed over the waveform, each with its own set of properties, positions and buddy text:

This line can be manually moved on the screen in one of the following ways:

•	horizontally through code using the WaveformAnalyzer.GraphicItemHorzPositionSet method

•	vertically through code using the WaveformAnalyzer.GraphicItemVertPositionSet method or through the WaveformAnalyzer.GraphicItemHorizontalLineParamsSet method.

•	horizontally and vertically through the mouse, causing a sequence of WaveAnalyzerHorzLineMoveBegin, WaveAnalyzerHorzLineMoving and WaveAnalyzerHorzLineMoveEnd events to be generated.

During playback of the loaded sound, the WaveAnalyzerHorzLineReached event is generated when playback position reaches the start position of the horizontal line and the WaveAnalyzerHorzLineLeaved event is generated when playback position leaves the end position of the horizontal line.

This method fails if no sound is currently loaded into the editor.

The horizontal line is automatically destroyed, as all of the other existing graphic items, when the loaded sound is discarded from memory through the CloseSound method.

A horizontal line can be removed through the WaveformAnalyzer.GraphicItemRemove method and hidden or shown through the WaveformAnalyzer.GraphicItemShow method.

For details about graphic items management on the waveform analyzer refer to the How to add graphic items to the Waveform analyzer section.

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.GraphicItemHorizontalLineAdd (

strFriendlyName as String,

strDescription as String,

nStartPosInMs as Long,

nEndPosInMs as Long,

settings as Long

) as Integer

[C++]

short control.WaveformAnalyzer.GraphicItemHorizontalLineAdd (

LPCTSTR strFriendlyName,

LPCTSTR strDescription,

long nStartPosInMs,

long nEndPosInMs,

void *settings

);

Parameter	Description

strFriendlyName	Friendly name of the line. This friendly name can be modified or retrieved at a later time through the WaveformAnalyzer.GraphicItemNameGet and WaveformAnalyzer.GraphicItemNameSet methods.
strDescription	Description of the line. This description can be modified or retrieved at a later time through the WaveformAnalyzer.GraphicItemDescriptionGet and WaveformAnalyzer.GraphicItemDescriptionSet methods.
nStartPosInMs	Start position expressed in milliseconds. This position can be modified or retrieved at a later time through the WaveformAnalyzer.GraphicItemHorzPositionGet and WaveformAnalyzer.GraphicItemHorzPositionSet methods.
nEndPosInMs	End position expressed in milliseconds. This position can be modified or retrieved at a later time through the WaveformAnalyzer.GraphicItemHorzPositionGet and WaveformAnalyzer.GraphicItemHorzPositionSet methods.
settings	Address of a structure of type WANALYZER_HORIZONTAL_LINE that contains the settings for the new line. These settings can be modified or retrieved at a later time through the WaveformAnalyzer.GraphicItemHorizontalLineParamsSet and WaveformAnalyzer.GraphicItemHorizontalLineParamsGet methods. By setting this value to 0 the graphic item will be rendered with default setting.

Return value

Value	Meaning

0	An error occurred (see the LastError property for further error details)
Value > 0	Unique identification number assigned to this new line.