86 lines
6.0 KiB
Markdown
86 lines
6.0 KiB
Markdown
|
---
|
||
|
|
source_files:
|
||
|
|
- Common/DTS.Common/Themes/CommonStyles.xaml.cs
|
||
|
|
- Common/DTS.Common/Themes/BrushesAndColors.cs
|
||
|
|
generated_at: "2026-04-17T15:41:27.517145+00:00"
|
||
|
|
model: "zai-org/GLM-5-FP8"
|
||
|
|
schema_version: 1
|
||
|
|
sha256: "531940e84f244acd"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Documentation: DTS.Common.Themes
|
||
|
|
|
||
|
|
## 1. Purpose
|
||
|
|
|
||
|
|
This module provides centralized access to WPF visual styling resources for the DTS application. `CommonStyles.xaml.cs` serves as code-behind for a XAML resource dictionary, enabling tool tip event handling with event aggregation support. `BrushesAndColors.cs` acts as a static cache layer for brushes and colors defined in application resources, improving lookup performance by caching `SolidColorBrush` and `Brush` instances after first access. This module exists to standardize UI styling across the application and provide a type-safe, performant way to access theme resources.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. Public Interface
|
||
|
|
|
||
|
|
### CommonStyles (partial class)
|
||
|
|
|
||
|
|
| Member | Signature | Description |
|
||
|
|
|--------|-----------|-------------|
|
||
|
|
| `ToolTipEventHandler` | `public void ToolTipEventHandler(object sender, System.Windows.Controls.ToolTipEventArgs e)` | Handles tool tip events by marking them as handled and publishing a `HelpTextEvent` via the `IEventAggregator`. Wraps the sender and event args in a `HelpTextEventArg` payload. |
|
||
|
|
|
||
|
|
### BrushesAndColors (abstract class)
|
||
|
|
|
||
|
|
All members are static properties. Brushes are lazily initialized and frozen on first access.
|
||
|
|
|
||
|
|
#### Brush Properties (cached, lazy-loaded)
|
||
|
|
|
||
|
|
| Property | Type | Resource Key Looked Up |
|
||
|
|
|----------|------|------------------------|
|
||
|
|
| `Brush_ApplicationTileExport` | `SolidColorBrush` | `Brush_ApplicationTileExport` |
|
||
|
|
| `Brush__ApplicationTileCollectData` | `SolidColorBrush` | `Brush_ApplicationTileCollectData` (note: property name has double underscore) |
|
||
|
|
| `Brush_ApplicationStatus_Failed` | `SolidColorBrush` | `Brush_ApplicationStatus_Failed` |
|
||
|
|
| `Brush_ApplicationStatus_TSRAIRGo_Failed` | `SolidColorBrush` | `Brush_ApplicationStatus_TSRAIRGo_Failed` |
|
||
|
|
| `Brush_Dimmed_Text` | `SolidColorBrush` | `Brush_Dimmed_TextForeground` |
|
||
|
|
| `Brush_Application_Idle` | `SolidColorBrush` | `Brush_ApplicationStatus_Idle` |
|
||
|
|
| `Brush_ApplicationStatus_Complete` | `SolidColorBrush` | `Brush_ApplicationStatus_Complete` |
|
||
|
|
| `Brush_ApplicationStatus_TSRAIRGo_Complete` | `SolidColorBrush` | `Brush_ApplicationStatus_TSRAIRGo_Complete` |
|
||
|
|
| `Brush_ApplicationStatus_Idle` | `SolidColorBrush` | `Brush_ApplicationStatus_Idle` |
|
||
|
|
| `Brush_ApplicationStatus_Busy` | `SolidColorBrush` | `Brush_ApplicationStatus_Busy` |
|
||
|
|
| `Brush_ApplicationStatus_TSRAIRGo_Busy` | `SolidColorBrush` | `Brush_ApplicationStatus_TSRAIRGo_Busy` |
|
||
|
|
| `Brush_Run_SensorIdNotFound` | `SolidColorBrush` | `Brush_Run_SensorIdNotFound` |
|
||
|
|
| `Brush_Run_SensorIdOutOfPlace` | `SolidColorBrush` | `Brush_Run_SensorIdOutOfPlace` |
|
||
|
|
| `Brush_Table_AlternatingRowBackground` | `SolidColorBrush` | `Brush_Table_AlternatingRowBackground` |
|
||
|
|
| `Brush_Table_RowBackground` | `SolidColorBrush` | `Brush_Table_RowBackground` |
|
||
|
|
| `Brush_FlatControlPressedBackground` | `Brush` | `Brush_FlatControlPressedBackground` |
|
||
|
|
| `Brush_FlatControlPressedForeground` | `Brush` | `Brush_FlatControlPressedForeground` |
|
||
|
|
| `Brush_Transparent` | `Brush` | Creates new `SolidColorBrush(Colors.Transparent)` (not resource-based) |
|
||
|
|
| `Brush_NoError` | `Brush` | Loaded from `/DTS.Common;component/Themes/brushes.xaml` |
|
||
|
|
| `Brush_Error` | `SolidColorBrush` | Loaded from `/DTS.Common;component/Themes/brushes.xaml` |
|
||
|
|
| `Brush_Warning` | `SolidColorBrush` | Loaded from `/DTS.Common;component/Themes/brushes.xaml` |
|
||
|
|
| `Brush_Attention` | `SolidColorBrush` | Loaded from `/DTS.Common;component/Themes/brushes.xaml` |
|
||
|
|
| `Brush_FlatControlDisabledForeground` | `Brush` | `Brush_FlatControlDisabledForeground` |
|
||
|
|
| `Brush_ApplicationContentForeground` | `Brush` | `Brush_ApplicationContentForeground` |
|
||
|
|
| `Brush_FlatControlDisabledBackground` | `Brush` | `Brush_FlatControlDisabledBackground` |
|
||
|
|
| `Brush_ApplicationStatus_Waiting` | `SolidColorBrush` | `Brush_ApplicationStatus_Waiting` |
|
||
|
|
| `Brush_ApplicationStatus_Failed_ActionBackground` | `SolidColorBrush` | `Brush_ApplicationStatus_Failed_ActionBackground` |
|
||
|
|
| `Brush_ApplicationStatus_Complete_ActionBackground` | `SolidColorBrush` | `Brush_ApplicationStatus_Complete_ActionBackground` |
|
||
|
|
| `Brush_ApplicationStatus_Failed_SystemProcess` | `SolidColorBrush` | `Brush_ApplicationStauts_Failed_SystemProcess` (note: typo in resource key) |
|
||
|
|
| `Brush_ApplicationFooterBackground` | `SolidColorBrush` | `Brush_ApplicationFooterBackground` |
|
||
|
|
| `Brush_ApplicationLicensingFooterBackground` | `SolidColorBrush` | `Brush_ApplicationLicensingFooterBackground` |
|
||
|
|
| `Brush_Realtime_OSC_SELECTED` | `Brush` | `Brush_Realtime_OSC_SELECTED` |
|
||
|
|
| `Brush_Realtime_OSC_UNSELECTED` | `Brush` | `Brush_Realtime_OSC_UNSELECTED` |
|
||
|
|
| `Brush_Realtime_METER_SELECTED` | `Brush` | `Brush_Realtime_METER_SELECTED` |
|
||
|
|
| `Brush_Realtime_METER_UNSELECTED` | `Brush` | `Brush_Realtime_METER_UNSELECTED` |
|
||
|
|
| `Brush_SensorIdFound` | `SolidColorBrush` | `Brush_SensorIdFound` |
|
||
|
|
| `Brush_ArmSystemForeground` | `SolidColorBrush` | `Brush_ArmSystemForeground` |
|
||
|
|
| `Brush_ApplicationTilePrepare` | `SolidColorBrush` | `Brush_ApplicationTilePrepare` |
|
||
|
|
| `Brush_ApplicationTileSetup` | `SolidColorBrush` | `Brush_ApplicationTileSetup` |
|
||
|
|
| `BrushApplicationStatusPowerRed` | `SolidColorBrush` | `Brush_ApplicationStatusPowerRed` |
|
||
|
|
| `BrushApplicationStatusPowerYellow` | `SolidColorBrush` | `Brush_ApplicationStatusPowerYellow` |
|
||
|
|
| `BrushApplicationStatusPowerGreen` | `SolidColorBrush` | `Brush_ApplicationStatusPowerGreen` |
|
||
|
|
| `BrushFlatControlDarkForeground` | `SolidColorBrush` | `Brush_FlatControlDarkForeground` |
|
||
|
|
| `BrushButtonBorderForeground` | `SolidColorBrush` | `Brush_ButtonBorderForeground` |
|
||
|
|
| `BrushApplicationStatusPowerClear` | `SolidColorBrush` | `Brush_ApplicationStatusPowerClear` |
|
||
|
|
|
||
|
|
#### Color Properties (not cached, looked up each time)
|
||
|
|
|
||
|
|
| Property | Type | Resource Key |
|
||
|
|
|----------|------|--------------|
|
||
|
|
| `Color_ActionBackground` | `Color` | `Color_ActionBackground` |
|
||
|
|
| `Color_ApplicationTileCollect
|