|Chapter 2: C# .NET WinForm Walk-Through VS2015
ProEssentials WinForm interfaces are used when creating stand-alone client-side EXEs to be distributed and ran on an end-users machine.
Thank you for reading this and above FAQ section as it will speed your development and maximize your implementation's overall quality. Knowing our demo and demo project will be your best source of info.
See .NET Overview, for additional info.
The following information demonstrates how to create your first .NET ProEssentials implementation using the C# language. It discusses using the WinForm .NET interfaces to add interactive charting content to your EXEs. Other examples are provided within the product/evaluation.
1) Start Visual Studio.NET and create a new project targeting a [Windows Application] using C# as your language. Accept the name of [WindowsFormsApplication1].
2) Under the Project menu, select "Project Properties". From the Build tab, adjust the Platform Target setting to x86. This is necessary as the following ProEssentials assembly links to a native 32 bit DLL. This setting will allow the resulting exe to run on both 32 and 64 bit systems and provide the easiest deployment. For native 64 bit, see our ReadMe.txt files in the ProEssentials9/DotNetAnyCpu or ProEssentials9/DotNet64 directories where ProEssentials is installed.
If you have already installed the ProEssentials WinForm interfaces, skip to step 4.
|Customize Toolbox... Dialog
||Adding ProEssentials to Visual Studio.NET...
3) Installing WinForm interfaces into Visual Studio.NET
- Under the Tools menu, select [Choose Toolbox Items...],
If not selected, left click the [.NET Framework Components] tab,
Left click the [Browse...] button and find the file "Gigasoft.ProEssentials.dll" found in the DotNet32 subdirectory where you installed ProEssentials. By default, this should be located at "C:\ProEssentials9\DotNet32\"
Select the file "Gigasoft.ProEssentials.dll" and close the [Open File] dialog,
The [Choose Toolbox Items] dialog should now show 5 highlighted controls: Pe3do, Pego, Pepco, Pepso, and Pesgo.
Close the dialog and the 5 new ProEssentials components will be near the bottom of the toolbox.
||Adding ProEssentials to a Form...
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.
||Adjusting design time settings...
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.
6) Double click Form1's Title/Caption Bar to open the code view for "Form1.cs" with default Form1_Load event initialized.
The cursor will be within the Form1_Load code section, enter the following code into this section.
You can copy and paste, but hand-typing a few lines of this code will help familiarize yourself with the Gigasoft.ProEssentials namespace.
Note: adding the following using declaration at the top of "Form1.cs" will shorten enumeration syntax.
pego1.PeString.MainTitle = "Hello World";
pego1.PeString.SubTitle = "";
pego1.PeData.Subsets = 2;
pego1.PeData.Points = 6;
pego1.PeData.Y[0, 0] = 10; pego1.PeData.Y[0, 1] = 30;
pego1.PeData.Y[0, 2] = 20; pego1.PeData.Y[0, 3] = 40;
pego1.PeData.Y[0, 4] = 30; pego1.PeData.Y[0, 5] = 50;
pego1.PeData.Y[1, 0] = 15; pego1.PeData.Y[1, 1] = 63;
pego1.PeData.Y[1, 2] = 74; pego1.PeData.Y[1, 3] = 54;
pego1.PeData.Y[1, 4] = 25; pego1.PeData.Y[1, 5] = 34;
pego1.PeString.PointLabels = "Jan";
pego1.PeString.PointLabels = "Feb";
pego1.PeString.PointLabels = "Mar";
pego1.PeString.PointLabels = "Apr";
pego1.PeString.PointLabels = "May";
pego1.PeString.PointLabels = "June";
pego1.PeString.SubsetLabels = "For .Net Framework";
pego1.PeString.SubsetLabels = "or MFC, ActiveX, VCL";
pego1.PeString.YAxisLabel = "Simple Quality Rendering";
pego1.PeColor.SubsetColors = System.Drawing.Color.FromArgb(60, 0, 180, 0);
pego1.PeColor.SubsetColors = System.Drawing.Color.FromArgb(180, 0, 0, 130);
pego1.PeColor.BitmapGradientMode = false;
pego1.PeColor.QuickStyle = Gigasoft.ProEssentials.Enums.QuickStyle.LightShadow;
pego1.PeTable.Show = Gigasoft.ProEssentials.Enums.GraphPlusTable.Both;
pego1.PeData.Precision = Gigasoft.ProEssentials.Enums.DataPrecision.NoDecimals;
pego1.PeFont.Label.Bold = true;
pego1.PePlot.Method = Gigasoft.ProEssentials.Enums.GraphPlottingMethod.Bar;
pego1.PePlot.Option.GradientBars = 8;
pego1.PePlot.Option.BarGlassEffect = true;
pego1.PeLegend.Location = Gigasoft.ProEssentials.Enums.LegendLocation.Left;
pego1.PePlot.DataShadows = Gigasoft.ProEssentials.Enums.DataShadows.ThreeDimensional;
pego1.PeFont.FontSize = Gigasoft.ProEssentials.Enums.FontSize.Large; pego1.PeConfigure.RenderEngine = Gigasoft.ProEssentials.Enums.RenderEngine.Direct2D;
pego1.PeConfigure.AntiAliasGraphics = true;
pego1.PeConfigure.AntiAliasText = true;
pego1.PeUserInterface.HotSpot.Data = true;
pego1.Refresh(); // call standard .NET Refresh method to force paint
Your project code should look like...
||Adding a DataHotSpot event...
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.
Add the following code to the pego1_PeDataHotSpot event.
System.Windows.Forms.MessageBox.Show("Point " + e.PointIndex.ToString() +
" with a value of " + pego1.PeData.Y[e.SubsetIndex, e.PointIndex].ToString());
8) Save and run the project. Your project will show an image as follows. Move the mouse over a bar and click to trigger the DataHotSpot event.
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 v9 / 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.