Copyright © 2006-2018 MultiMedia Soft

Spectrum.Create method

Previous pageReturn to chapter overviewNext page

Remarks

 

Creates an instance of the Spectrum class: once created, the Spectrum will stay active until the termination of the container application: being a graphical object, the Spectrum 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 Spectrum.SetHwnd method. For development environments like WPF, where controls don't expose a HWND, the usage of the Sprectrum.CreateNew method should be preferred.

 

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

 

For further details about using the embedded Spectrum refer to the Spectrum class section.

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

 

 

Syntax

 

[Visual Basic]

Public Function Create (

hWndTarget as IntPtr

) as enumErrorCodes


 

[C#]

public enumErrorCodes Create (

IntPtr hWndTarget

);


 

[C++]

public: enumErrorCodes Create (

IntPtr hWndTarget

);


 

 

Parameter

Description

 

 

hWndTarget

Handle of the window whose surface will be used in order to render the Spectrum graphics.

If this parameter is set to NULL or 0, no graphical representation will be performed but you will have the opportunity to be notified about spectrum values change through the CallbackVuMeterValueChange delegate, allowing to render also your custom spectrum graphics after calling the Spectrum.GetTable method.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.