COM Objects > SpectrumEnh object > Methods > SpectrumEnh.CreateNew method

Remarks

Creates an instance of the enhanced spectrum analyzer for the given player on a specific position of the client area of the given parent window. The parent window can be changed at a later time through the SpectrumEnh.SetHwnd method.

Once created, by default the enhanced spectrum analyzer is still not visible: you must make a call to the SpectrumEnh.Show method in order to display it.

Note that you can have a different enhanced spectrum analyzer for each of the allocated players.

For further details about using the Enhanced Spectrum Analyzer refer to the SpectrumEnh section.

For details about using the Enhanced Spectrum Analyzer refer to the How to use the Enhanced Spectrum Analyzer tutorial.

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

Syntax

[Visual Basic]

control.SpectrumEnh.CreateNew (

nPlayer as Integer,

hWndTarget as OLE_HANDLE,

nLeft as Long,

nTop as Long,

nWidth as Long,

nHeight as Long

) as enumErrorCodes

[C++]

short control.SpectrumEnh.CreateNew (

short nPlayer,

OLE_HANDLE hWndTarget,

long nLeft,

long nTop,

long nWidth,

long nHeight

);

Parameter	Description

nPlayer	Number representing the zero-based index of the player that will use the spectrum analyzer.
hWndTarget	Handle of the parent window that will contain the enhanced spectrum analyzer. This parameter cannot be set to NULL or 0.
nLeft	Left position of the window, expressed in parent's client coordinates (pixels)
nTop	Top position of the window, expressed in parent's client coordinates (pixels)
nWidth	Width of the window, expressed in pixels
nHeight	Height of the window, expressed in pixels

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