Show a compact trend
Plot a small sequence without turning it into a full chart.
A sparkline communicates direction and shape. It needs surrounding context: what is measured and in what order. Preserve the ordering of samples, and test short or empty sequences before using live data.
Step 1Prepare a safe practice project#
Extract the archive into a new writable folder, separate from your own application. Open Sparkline.mcproj in McBasic™. Keep every declared source, layout, resource and migration file together.
To reconstruct it yourself, create a DesktopApp project and add the files declared below. In the complete project, follow these steps as a guided rebuild: replace each named source file once and Check after all its procedures are present.
Exact project configuration
{
"schemaVersion": 1,
"projectId": "73c0de3e-4e0a-4ea0-bd71-2d35b0b7d3b0",
"name": "SparklineSample",
"kind": "DesktopApp",
"language": {
"dialect": "McBasic1",
"requireExplicit": true,
"compare": "Binary",
"defaultArrayBase": 0
},
"application": {
"bundleIdentifier": "com.mcbasic.samples.sparkline",
"version": "0.1.0",
"buildNumber": "1",
"startupFormId": "form-main",
"shutdownMode": "OnStartupFormClosed"
},
"forms": [
{
"id": "form-main",
"typeName": "frmMain",
"layout": "Forms/frmMain.form.json",
"code": "Forms/frmMain.bas"
}
],
"modules": [],
"classes": [],
"tests": [],
"references": [],
"resources": [],
"targets": [
"osx-arm64"
],
"capabilities": []
}Step 2Build the Form and set its properties#
frmMain
Select the Form first and set its properties. Add containers before their children. These are initial Designer values, not statements to paste into a procedure.
| Form property | Value |
|---|---|
Caption | "Sparkline — McBasic" |
Width | 560 |
Height | 300 |
MinWidth | 440 |
MinHeight | 240 |
sparklineSales · exact Inspector values
| Property | Value |
|---|---|
Left | 48 |
Top | 60 |
Width | 450 |
Height | 128 |
Values | "12,18,16,25,22,31,28,40" |
Minimum | 0 |
Maximum | 50 |
Caption | "Weekly activity" |
ShowPoints | True |
TabIndex | 0 |
Visible | True |
Enabled | True |
| Anchor edges | Left, Top, Right |
lblHelp · exact Inspector values
| Property | Value |
|---|---|
Left | 48 |
Top | 212 |
Width | 450 |
Height | 40 |
Caption | "Sparkline is a McBasic-owned chart composed from Avalonia primitives." |
TabIndex | 1 |
Visible | True |
Enabled | True |
| Anchor edges | Left, Top, Right |
Step 3Connect the events explicitly#
frmMain
| Object | Event | Procedure | Parameters |
|---|---|---|---|
sparklineSales | Change | sparklineSales_Change | Change() |
| Form | Load | Form_Load | () |
Step 4Enter the complete behavior#
Open the named source file. Enter declarations first, then every procedure. Expand a procedure for its full body, or copy the complete file. Helpers are required: do not stop after entering the first Click handler.
Forms/frmMain.bas
Enter these declarations at file scope, before the procedures.
Option ExplicitPrivate Sub Form_Load()
Initialize state before enabling dependent actions. Keep the shared declarations and startup dependencies with this procedure.
Private Sub Form_Load()
sparklineSales.Minimum = 0
sparklineSales.Maximum = 50
sparklineSales.Values = "12,18,16,25,22,31,28,40"
sparklineSales.Caption = "Weekly activity"
sparklineSales.ShowPoints = True
lblHelp.Caption = "Sparkline is a McBasic-owned chart composed from Avalonia primitives."
End SubPrivate Sub sparklineSales_Change()
Read the current value or selection and update its dependent interface. The binding above determines which object calls this handler.
Private Sub sparklineSales_Change()
lblHelp.Caption = "Weekly activity updated."
End SubCopy the complete Forms/frmMain.bas file
Replace the file once; do not append duplicate procedures.
Option Explicit
Private Sub Form_Load()
sparklineSales.Minimum = 0
sparklineSales.Maximum = 50
sparklineSales.Values = "12,18,16,25,22,31,28,40"
sparklineSales.Caption = "Weekly activity"
sparklineSales.ShowPoints = True
lblHelp.Caption = "Sparkline is a McBasic-owned chart composed from Avalonia primitives."
End Sub
Private Sub sparklineSales_Change()
lblHelp.Caption = "Weekly activity updated."
End SubStep 5Keep resources and storage reproducible#
No external resource or migration files are declared. Any inline migration, seed data or local JSON is present in the code above. Runtime application data and private preferences are not included in the archive.
Step 6Check, run and test the result#
Save all files and run Check. Resolve diagnostics before Run. Developer CLI users can work from the extracted folder:
mcbasic check Sparkline.mcproj
mcbasic run Sparkline.mcprojAcceptance checklist
- Run with the authored series and inspect its trend.
- Change the sequence and compare the result.
- Test a short series through the documented Values property.
Step 7Make one change and repeat the tests#
Pair the sparkline with a label describing the most recent measurement.
Save a working Git checkpoint first. Change one behavior, Check again and repeat the acceptance checklist. Compare with the downloaded solution if a regression appears.
20f4bfed6b · Build manifest