• Note: As the VS2022 IDE is 64 bit, we recommend our pure 64 bit assemblies be added for design-time and general development purposes. If you choose our AnyCpu flavor, the first time our AnyCpu assembly is added to the Toolbar and a chart is placed on a form, VS2022 should be running with Admin privileges. Subsequent use will not require privileges.
• 1. With the Designer window having focus, Click the [Toolbox] vertical tab,
• 2. Right Click the area below the [General] tab,
• 3. Select [Add Tab],
• 4. Enter [Gigasoft] for the tab's name,
• 5. Right Click the area below new [Gigasoft] tab,
• 6. Select [Choose Items...],
• 7. If not selected, left click the [.NET Framework Components] tab,
• 8. Left click the [Browse...] button and find the file "Gigasoft.ProEssentials.dll" found in our \DotNet48\x64 folder where you installed ProEssentials. By default, this should be located at "C:\ProEssentials10\DotNet48\x64 and \AnyCpu\",
• 9. Select the file "Gigasoft.ProEssentials.dll" and close the [Open File] dialog,
• 10. The [Choose Toolbox Items] dialog should now show 5 highlighted controls: Pe3do, Pego, Pepco, Pepso, and Pesgo.
• 11. Close dialog and 5 ProEssentials components will show within the Gigasoft tab as shown in the bottom right image.
• Note. Attemping to add our assembly (DotNet48\x86) to the VS2022 toolbox will result in an error as the VS2022 designer is 64 bit.
• Note. When deploying your finished project and prefer to support AnyCpu, x64, x86, close the Designer window, in Solution Explorer remove Reference and replace with any of our other References. The project will now support compiling as needed that matches the Reference added. To again add our charts to a form via the Designer, change Reference to our DotNet48\x64 or AnyCpu assemblies.
•  

 VS2019 Instructions

• Note. The first time our AnyCpu assembly is added to the Toolbar, VS2019 should be running with Admin privileges. Subsequent use will not require privileges. You may optionally install our assembly within the ProEssentials10\DotNet48\x86 subfolder which does not require first time Admin privileges, however adjust the Project Build setting Platform/CPU Target to x86.
• 1. With the Designer window having focus, Click the [Toolbox] vertical tab,
• 2. Right Click the area below the [General] tab,
• 3. Select [Add Tab],
• 4. Enter [Gigasoft] for the tab's name,
• 5. Right Click the area below new [Gigasoft] tab,
• 6. Select [Choose Items...],
• 7. If not selected, left click the [.NET Framework Components] tab,
• 8. Left click the [Browse...] button and find the file "Gigasoft.ProEssentials.dll" found in our \DotNet48\AnyCpu folder where you installed ProEssentials. By default, this should be located at "C:\ProEssentials10\DotNet48\AnyCpu",
• 9. Select the file "Gigasoft.ProEssentials.dll" and close the [Open File] dialog,
• 10. The [Choose Toolbox Items] dialog should now show 5 highlighted controls: Pe3do, Pego, Pepco, Pepso, and Pesgo.
• 11. Close dialog and 5 ProEssentials components will show within the Gigasoft tab as shown in the bottom right image.
• Note. Attemping to add our x64 assembly located in \DotNet48\x64 to VS2019 and earlier toolbox will result in an error as the VS2019 designer is 32 bit.
• Note. When deploying your finished project and prefer to change the target to AnyCpu, x64 or x86, close the Designer window, in Solution Explorer remove our Reference and replace with any of our other References. The project will now support compiling as needed to match the Reference added. To again add our charts to a form via the Designer, change Reference to our AnyCpu or DotNet48\x86 assemblies.
•  

4) Double click the [Pego] tool within the toolbox. This places an instance of the Pego component within "Form1.cs". Left click bottom-right corner of control and drag down-right to fill up client area of Form1. The adjacent image shows what you see.

This represents the default state of a ProEssentials Graph. The default state has one subset with four data points. In the course of constructing your own charts, you'll set the properties PeData.Subsets and PeData.Points which define the quantity of data your chart will hold. You'll then pass data via the PeData.Y[subset, point] two dimensional property array. The following section shows example code of passing data.

ProEssentials uses the terms Subsets and Points but you can think of these as Rows and Columns. Passing data is as simple as filling each Subset with Points worth of data.

5) Note, when setting color and font size attributes, we recommend setting the parent Form's versions as ProEssentials will use the parent form's settings to help facilitate a uniform look among sibling controls.

If new to C#, the (Name) property is probably the most fundamental property as its name is reflected in all code. For example,  pego1.PeData.Subsets = 1; is a line of code, and it shows how the (Name) property (pego1) starts the line.

7) The code above enabled the DataHotSpot event, so we should place some appropriate code in the DataHotSpot event.

Left click the pego control within Form1 to give it the focus.

From the main menu select [View] and [Properties Window]

Within the [Properties Window], click the event icon.

Within the available events, double-click PeDataHotSpot

This opens the code view of "Form1.cs" with cursor within the pego1_PeDataHotSpot event handler.

This completes this walkthrough.

Please read the remaining sections within Chapter 2 and review the demo code and documentation that's installed with the eval/product.

Once installed, the demo program can be accessed via shortcut...

Start / All Programs / ProEssentials v10 / PEDemo

Note that our main demo is replicated in C#.NET, VB.NET, Visual C++ MFC projects all accessible from the start menu. These are great for modifying an existing demo to test potential modifications before implementing within your applications.