Copyright © 2001-2018 MultiMedia Soft

Waveform.BitmapViewVerticalLineAdd method

Previous pageReturn to chapter overviewNext page

Remarks

 

Adds a new vertical line that will be displayed when rendering the waveform's graphics through the Waveform.BitmapViewDrawToHdc method. This line can be removed at any time by using the Waveform.BitmapViewVerticalLineRemove method.

 

For further details about generating a waveform bitmap of the loaded sound, before starting its playback, refer to the How to obtain the sound's waveform tutorial.

 

 

Syntax

 

[Visual Basic]

control.Waveform.BitmapViewVerticalLineAdd (

nUniqueId as Integer,

nPosition as Long,

color as OLE_COLOR,

nMode as enumWaveformLineModes,

nWidth as Integer

) as enumErrorCodes


 

[C++]

short control.Waveform.BitmapViewVerticalLineAdd (

short nUniqueId,

long nPosition,

OLE_COLOR color,

short nMode,

short nWidth

);


 

 

 

Parameter

Description

 

 

nUniqueId

Unique identification number assigned to this new line.

nPosition

Initial position expressed in milliseconds

color

Color of the line

nMode

Line mode used for rendering the line.

Supported values are the following:

Mnemonic constant

Numeric value

Meaning

LINE_MODE_DOTTED

0

Dotted line (applied only if the nWidth parameter below is set to 1)

LINE_MODE_DASHED

1

Dashed line (applied only if the nWidth parameter below is set to 1)

LINE_MODE_SOLID

2

Solid line

nWidth

Width of the line expressed in pixels. In case the parameter should be set to a value higher than 1, the nMode parameter above would be automatically set to LINE_MODE_SOLID.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred, check the LastError property value in order to get the error code

enumErrorCodes.ERR_NOERROR (0)

The method call was successful