# kavosian-microsoft/graphical_calculator architecture

> Architecture diagram of the GitHub repository kavosian-microsoft/graphical_calculator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kavosian-microsoft/graphical_calculator
- Repository: https://github.com/kavosian-microsoft/graphical_calculator

## Overview

This is a small C# WinForms graphical calculator. The user enters numbers through calculator controls or keyboard handling; the calculator form tracks operands and the selected operation, performs arithmetic, and updates its display. The application entry point launches the form, which also has a native NumLock helper. The form excerpt is partial, so details of control layout and event wiring are not mapped.

Main entry points: [`Visual_Calculator/Visual_Calculator/Form1.cs`](https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Form1.cs) (Calculator form), [`Visual_Calculator/Visual_Calculator/Program.cs`](https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Program.cs) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Calculator app"]
  node_entry["App entry<br/>[Program.cs]"]
  node_calculator["Calculator form<br/>[Form1.cs]"]
end

subgraph group_platform["Windows integration"]
  node_native["NumLock helper<br/>[Form1.cs]"]
end

node_user(("User"))
node_windows["Windows API"]

node_entry -->|"launches"| node_calculator
node_user -->|"enters values"| node_calculator
node_calculator -->|"simulates key"| node_native
node_native -->|"calls keybd_event"| node_windows

click node_entry "https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Program.cs"
click node_calculator "https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Form1.cs"
click node_native "https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Form1.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_calculator,node_user toneBlue
class node_native toneAmber
class node_windows toneMint
```

## Components

### Calculator app

- [App entry](https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Program.cs): `Visual_Calculator/Visual_Calculator/Program.cs`
- [Calculator form](https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Form1.cs): `Visual_Calculator/Visual_Calculator/Form1.cs`

### Windows integration

- [NumLock helper](https://github.com/kavosian-microsoft/graphical_calculator/blob/master/Visual_Calculator/Visual_Calculator/Form1.cs): `Visual_Calculator/Visual_Calculator/Form1.cs`

### Other components

- **User**
- **Windows API**

## Connections

- App entry → Calculator form: launches (evidence: `Visual_Calculator/Visual_Calculator/Program.cs`)
- User → Calculator form: enters values (evidence: `README.md`)
- Calculator form → NumLock helper: simulates key (evidence: `Visual_Calculator/Visual_Calculator/Form1.cs`)
- NumLock helper → Windows API: calls keybd_event (evidence: `Visual_Calculator/Visual_Calculator/Form1.cs`)
