NuGet による WinForms .NET 8.0 チャート

ProEssentials WinForms interfaces are used when creating stand-alone Desktop or Embedded EXEs to be distributed royalty-free and ran on an end-users machine. This VS2022 - VS2019 C# Charting NuGet NET80 Walk-through includes instructions for Visual Studio VS2022 and VS2019.

AI 駆動の開発

ProEssentials には pe_query.py を備えた AI コードアシスタントシステムが含まれます。AI ツールに完全な API へのオンデマンド アクセスを提供し — 幻覚プロパティパスを防ぐ正解データ検証付きです。

Claude、Gemini、GitHub Copilot、Cursor、ChatGPT で動作します。

AI コードアシスタントはじめに

デモをご覧ください...

• v11 のデモをまだご覧になっていませんか?
• ダウンロードはこちら: WinForms C# チャートデモ + WPF デモ + 100%ネイティブ MFC デモ。
• 体験だけが知識になります: サイズ変更、形状、右クリック、エクスポート、ズーム（特に日付と Log スケール)、パン、回転。

The WinForm interfaces support adapting to changes in the parent form's font and background color. They are designed so that the grid number text size (grid numbers are the grid line labels such as 70, 80, 90 along y axis) matches that of the other standard controls such as TextBox, Radio Button, and Labels. As long as you don't explicitly change the font and background color for the chart, you will be able to change the form's font size and backcolor and all other controls on the form will adapt to match. Note that the default form text size of 8 points is fairly small. You may want to increase it to 9 or 10 points depending on your needs. This feature results in a clean looking user interface where the charting control appears to be a true sibling of the other standard controls.

You will have to write a little code (see below) to develop your graphing solutions. In the end, you'll prefer our .NET (property, method, event) interface. 99% of your code will set simple properties.

1) Start Visual Studio.NET and create a new project targeting [C#] [Windows] [Desktop] and [Windows Forms App]. Accept the default name of [WinFormsApp]. Note, Do not select Windows Forms App [.NET Framework]. Select .Net 80 for this tutorial. We optionally have assemblies for .Net 4.8 Framework but that is a different Walkthough.

2)When the new project opens, you will be presented the design view of "Form1.cs".

3) Installing WinForms charts into Visual Studio.NET via Nuget Package. Note our evaluation setup program will install a local nuget source [ Gigasoft11 (Local) ] as an easier location to find our nuget packages. If you installed our product or eval, then use the [Package Source] drop-down list box (the green 1. below) and select Gigasoft11 (Local).

Pro Tip: To add an assembly to a modern VS2022 project, we recommend opening and editing the project file directly to add or adjust the Reference and HintPath manually. This approach simplifies the process and eliminates the tedious task of managing NuGet packages. Once you start adding assemblies manually, you’ll likely find it avoids much of the confusion often associated with the NuGet method.

VS2022 VS2019 Instructions

• 1. Within the Solution Explorer window, Right Click [Dependencies] and select [Manage NuGet Packages...],

• 2. Within the NuGet Package Manager window,
  • 1. check source is Gigasoft11 (Local) if you've run our setup, nuget,
  • 2. select Browse and optionally enter "Gigasoft" in the search box if on Nuget.org,
  • 3. select ProEssentials.Chart.Net80.Winforms, optionally ProEssentials.Chart.Net80.x64.Winforms is recommended for VS2022.
  • 4. select Install

• 3. Accept installing the package,
• 4. Build the project, save it, then close the solution and reopen it. The ProEssentials components will now show within the ProEssentials tab within your toolbox as seen in this image.



PRO TIP - the Toolbox does not refresh until the solution is reloaded: after installing the package, build the project, save it, then close the solution and reopen it. The .NET designers populate the Toolbox only on solution load, so the five ProEssentials components will not appear until you do. This trips up almost everyone the first time.

4) Select the [Pego] tool within the toolbox and then draw a rectangle within your Window. This places an instance of the Pego component within "Form1.cs".

The adjacent image shows what you should 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.

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.

To enable the chart to match the size of it's container, let us change the chart's Dock setting.

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], scroll and locate the Layout section and then the Dock item.

Modify the Dock setting by clicking the center section or 'Fill' mode.

5)We recommend setting the parent Form's versions of back color, font, etc properties as ProEssentials will use the parent form's settings to help facilitate a uniform look among sibling controls.

We also recommend coding your property settings as this creates a record for you and others as to what settings are being used. And you might be able to re-use this code in other areas for other charts.

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 usingdeclaration at the top of "Form1.cs" will shorten enumeration syntax.
using Gigasoft.ProEssentials.Enums;

Your project code should look similar to...

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.

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 / ProEssentials v11 / PeDemo

Note that our main charting demo is replicated in WinUI, WPF and Winform C#.NET,  VB.NET, VC++ MFC, Delphi, Builder all accessible from where you installed ProEssentials.   These are great for modifying an existing demo to test potential modifications before implementing within your applications.

Thank you for researching. Please contact our engineers if you have a question.