Adding the component to a Winforms project
This component, requiring the availability of version 2.0 (or higher) of the .NET framework, is tested against Visual Studio versions starting from version 2005.
During the installation procedure, the setup program checks which versions of Visual Studio are currently installed inside the system in order to allow integrating the component with the corresponding toolbox of the IDE; each supported Visual Studio version has an associated checkbox (all unchecked by default) which allows determining if the component will be automatically added to the toolbox:
Versions of Visual Studio supported by the component but not installed inside the system are rendered as grayed and disabled.
When versions 2005 and/or 2008 are chosen the installation procedure creates a tab named "MultiMedia Soft" inside the toolbox of the corresponding IDE; inside this tab the installed component will be visible as seen on the screenshot below:
When versions 2010 and/or higher are chosen the installation procedure creates two tabs inside the toolbox of the corresponding IDE, one for the component built against version 2.0 of the .NET framework (named "MultiMedia Soft for .NET FW 2") and one for the component built against version 4 of the .NET framework (named "MultiMedia Soft for .NET FW 4") as seen on the screenshot below:
Components available inside the tab named "MultiMedia Soft for .NET FW 2" are intended for usage with container applications targeted for .NET framework 2.0, 3.0 or 3.5 while components available inside the tab named "MultiMedia Soft for .NET FW 4" are intended for usage with container applications targeted for .NET framework 4 or higher.
In case you should have chosen to avoid the automatic installation of the component inside the toolbox, you could proceed with a manual installation using the procedure described below:
|•||Open the project you are working on|
|•||If not already visible, open the Toolbox of Visual Studio.NET|
|•||Right click the mouse button over the Toolbox surface.|
|•||Select the "Choose Items..." menu item; this will open the "Choose Toolbox items" dialog box.|
|•||Select the ".NET Framework components" tab|
|•||Between the installed components find components named "AudioDJStudio" as displayed below|
|•||As you can see there are two versions of the component: the one with assembly name "AudioDjStudioF4" is intended for usage with container applications targeted for .NET framework 4 or higher while the one with assembly name "AudioDjStudio" is intended for usage with container applications targeted for .NET framework 2.0, 3.0 or 3.5 so you may decide which of the two version best fits your needs.|
|•||Pressing the "OK" button will bring you again to your project working area and the icon below will appear inside your toolbox|
|•||Just in case you should have decided to add both versions of the component to the toolbox, they would appear with the same name: in order to distinguish between the one targeted for version 2 and the one targeted for version 4 of the .NET framework, just position the mouse over the icon so a tool tip containing the version of the component will appear; "Version 22.214.171.124" is the one targeted for version 4 of the .NET framework while "Version 126.96.36.199" is the one targeted for version 2 of the .NET framework.|
|•||Now you can select the component's icon inside the toolbox and drag it into the container form under editing; the following icon will appear on the form (note that this icon will be invisible at runtime) and one reference to the component will be automatically added to the "References" section of the Project|
|•||Note that you can add more than one instance of the component.|
|•||You can now start developing your code around the component as described inside the How to use the component in your projects section|
IMPORTANT NOTE ABOUT THE TARGETED .NET FRAMEWORK INSIDE VISUAL STUDIO 2010
When a new application is created from scratch through the Visual Studio 2010 wizard, by default the targeted .NET framework is set to ".NET framework 4 Client Profile": this version of the .NET framework is a subset of the .NET framework 4 and one of its main limitations is the fact that you cannot reference an assembly that is not in the ".NET Framework 4 Client Profile" so, in order to be able compiling the application referencing one of our components, assuming that the project name is "MyApp", you will have to perform following steps: