COM Objects > VUMeter object > Methods

Remarks

Creates the VU-Meter object: once created, the VU-Meter will stay active until the termination of the container application: being a graphical object, the VU-Meter needs to be associated to an existing window that will be used as a surface for the graphic rendering: this window can be changed at a later time through the VUMeter.SetHwnd method.

Once created, by default the VU-Meter is still not visible: you must make a call to the VUMeter.Show method in order to display it.

Note that you can have a different VU-Meter for each of the allocated players-

For further details about using the embedded VU-Meter refer to the VUMeter object section.

For details about using Visual Feedbacks refer to the How to use the embedded Visual Feedbacks section.

Syntax

[Visual Basic]

control.VUMeter.Create (

nPlayer as Integer,

hWndTarget as OLE_HANDLE

) as enumErrorCodes

[C++]

short control.VUMeter.Create (

short nPlayer,

OLE_HANDLE hWndTarget

);

Parameter	Description

nPlayer	Number representing the zero-based index of the player that will use the VU-Meter
hWndTarget	Handle of the window whose surface will be used in order to render the VU-Meter graphics: if you want to implement your own VU-Meter graphics, catching the VUMeterValueChange event, you can set this parameter to 0.

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