# qbj196/start architecture

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

- Interactive diagram: https://gitdiagram.com/qbj196/start
- Repository: https://github.com/qbj196/start

## Overview

Start is a Windows 8/8.1 Explorer desk-band DLL that provides a classic Start button and menu, can enter the desktop instead of the Start screen, and offers controls for related shell behavior. The main path is Explorer hosting the COM desk band, which creates the Start UI and its popup pane; clicks and shell messages open the menu or invoke shell actions. The pane also enumerates and displays shell items and persists selected settings. The map uses the supplied excerpts and README; unsampled implementation details are not inferred.

Main entry points: [`Start.cpp`](https://github.com/qbj196/start/blob/master/Start.cpp) (Start button and hooks), [`Pane.cpp`](https://github.com/qbj196/start/blob/master/Pane.cpp) (Classic menu pane), [`DllMain.cpp`](https://github.com/qbj196/start/blob/master/DllMain.cpp) (DLL entry and registration), [`DeskBand.cpp`](https://github.com/qbj196/start/blob/master/DeskBand.cpp) (Desk band)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_com["COM Integration"]
  node_dll["DLL entry and registration<br/>[DllMain.cpp]"]
  node_factory["COM class factory<br/>[ClassFactory.cpp]"]
  node_band["Desk band<br/>[DeskBand.cpp]"]
end

subgraph group_ui["Start UI"]
  node_start["Start button and hooks<br/>[Start.cpp]"]
end

subgraph group_menu["Menu Features"]
  node_pane["Classic menu pane<br/>[Pane.cpp]"]
  node_shellitems["Shell item listing<br/>[Pane.cpp]"]
  node_settings["Menu settings<br/>[Pane.cpp]"]
end

subgraph group_shell["Windows Shell"]
  node_taskbar["Taskbar and desktop"]
  node_registry[("Windows registry")]
  node_shellapi["Windows shell APIs"]
end

node_user(("User"))
node_explorer["Explorer"]

node_user -->|"selects toolbar"| node_explorer
node_explorer -->|"loads COM server"| node_dll
node_dll -->|"returns factory"| node_factory
node_factory -->|"creates band"| node_band
node_band -->|"creates UI"| node_start
node_band -->|"shows or closes"| node_start
node_start -->|"creates and closes"| node_pane
node_user -->|"clicks button"| node_start
node_start -->|"opens menu"| node_pane
node_user -->|"selects menu item"| node_pane
node_pane -->|"draws item list"| node_shellitems
node_shellitems -->|"enumerates shell items"| node_shellapi
node_pane -->|"toggles options"| node_settings
node_settings -->|"persists preferences"| node_registry
node_start -->|"hooks shell windows"| node_taskbar
node_start -->|"requests desktop"| node_taskbar
node_pane -->|"launches shell actions"| node_shellapi
node_dll -->|"registers COM server"| node_registry
node_dll -->|"registers desk-band category"| node_shellapi

click node_dll "https://github.com/qbj196/start/blob/master/DllMain.cpp"
click node_factory "https://github.com/qbj196/start/blob/master/ClassFactory.cpp"
click node_band "https://github.com/qbj196/start/blob/master/DeskBand.cpp"
click node_start "https://github.com/qbj196/start/blob/master/Start.cpp"
click node_pane "https://github.com/qbj196/start/blob/master/Pane.cpp"
click node_shellitems "https://github.com/qbj196/start/blob/master/Pane.cpp"
click node_settings "https://github.com/qbj196/start/blob/master/Pane.cpp"

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_dll,node_factory,node_band,node_user toneBlue
class node_start toneAmber
class node_pane,node_shellitems,node_settings toneMint
class node_taskbar,node_registry,node_shellapi toneRose
class node_explorer toneIndigo
```

## Components

### COM Integration

- [DLL entry and registration](https://github.com/qbj196/start/blob/master/DllMain.cpp): `DllMain.cpp`
- [COM class factory](https://github.com/qbj196/start/blob/master/ClassFactory.cpp): `ClassFactory.cpp`
- [Desk band](https://github.com/qbj196/start/blob/master/DeskBand.cpp): `DeskBand.cpp`

### Start UI

- [Start button and hooks](https://github.com/qbj196/start/blob/master/Start.cpp): `Start.cpp`

### Menu Features

- [Classic menu pane](https://github.com/qbj196/start/blob/master/Pane.cpp): `Pane.cpp`
- [Shell item listing](https://github.com/qbj196/start/blob/master/Pane.cpp): `Pane.cpp`
- [Menu settings](https://github.com/qbj196/start/blob/master/Pane.cpp): `Pane.cpp`

### Windows Shell

- **Taskbar and desktop**
- **Windows registry**
- **Windows shell APIs**

### Other components

- **User**
- **Explorer**

## Connections

- User → Explorer: selects toolbar (evidence: `ReadMe.txt`)
- Explorer → DLL entry and registration: loads COM server (evidence: `ReadMe.txt`)
- DLL entry and registration → COM class factory: returns factory (evidence: `DllMain.cpp`)
- COM class factory → Desk band: creates band (evidence: `ClassFactory.cpp`)
- Desk band → Start button and hooks: creates UI (evidence: `DeskBand.cpp`)
- Desk band → Start button and hooks: shows or closes (evidence: `DeskBand.cpp`)
- Start button and hooks → Classic menu pane: creates and closes (evidence: `Start.cpp`)
- User → Start button and hooks: clicks button (evidence: `Start.cpp`)
- Start button and hooks → Classic menu pane: opens menu (evidence: `Start.cpp`)
- User → Classic menu pane: selects menu item (evidence: `Pane.cpp`)
- Classic menu pane → Shell item listing: draws item list (evidence: `Pane.cpp`)
- Shell item listing → Windows shell APIs: enumerates shell items (evidence: `Pane.cpp`)
- Classic menu pane → Menu settings: toggles options (evidence: `Pane.cpp`)
- Menu settings → Windows registry: persists preferences (evidence: `Pane.cpp`)
- Start button and hooks → Taskbar and desktop: hooks shell windows (evidence: `Start.cpp`)
- Start button and hooks → Taskbar and desktop: requests desktop (evidence: `Start.cpp`)
- Classic menu pane → Windows shell APIs: launches shell actions (evidence: `Pane.cpp`)
- DLL entry and registration → Windows registry: registers COM server (evidence: `DllMain.cpp`)
- DLL entry and registration → Windows shell APIs: registers desk-band category (evidence: `DllMain.cpp`)
