75 lines
4.5 KiB
Markdown
75 lines
4.5 KiB
Markdown
|
---
|
|||
|
|
source_files:
|
|||
|
|
- Common/DTS.Common/obj/x86/Debug/Themes/CommonStyles.g.i.cs
|
|||
|
|
- Common/DTS.Common/obj/x86/Debug/Themes/CommonStyles.g.cs
|
|||
|
|
generated_at: "2026-04-17T15:41:10.196599+00:00"
|
|||
|
|
model: "zai-org/GLM-5-FP8"
|
|||
|
|
schema_version: 1
|
|||
|
|
sha256: "423da40d53f139d7"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Documentation: CommonStyles (Auto-Generated)
|
|||
|
|
|
|||
|
|
## 1. Purpose
|
|||
|
|
|
|||
|
|
This module contains the auto-generated code-behind for `CommonStyles.xaml`, a WPF `ResourceDictionary` that defines centralized visual styles for the DTS.Common assembly. The generated class facilitates XAML parsing and connects event handlers—specifically `ToolTipOpeningEvent` handlers—to various styles defined in the XAML. This is build output from `PresentationBuildTasks` and should not be manually edited.
|
|||
|
|
|
|||
|
|
## 2. Public Interface
|
|||
|
|
|
|||
|
|
### Class: `DTS.Common.CommonStyles`
|
|||
|
|
|
|||
|
|
A `partial` class extending `System.Windows.ResourceDictionary` that implements `System.Windows.Markup.IComponentConnector` and `System.Windows.Markup.IStyleConnector`.
|
|||
|
|
|
|||
|
|
#### `public void InitializeComponent()`
|
|||
|
|
|
|||
|
|
Initializes the resource dictionary by loading the XAML component. Idempotent—subsequent calls return immediately if already loaded. Loads the resource at URI `/DTS.Common;component/themes/commonstyles.xaml` via `System.Windows.Application.LoadComponent()`.
|
|||
|
|
|
|||
|
|
#### `void IComponentConnector.Connect(int connectionId, object target)`
|
|||
|
|
|
|||
|
|
Explicit interface implementation. Sets `_contentLoaded = true`. No other behavior observed in the generated code.
|
|||
|
|
|
|||
|
|
#### `void IStyleConnector.Connect(int connectionId, object target)`
|
|||
|
|
|
|||
|
|
Explicit interface implementation. Connects `System.Windows.EventSetter` instances to styles based on `connectionId`. Creates `EventSetter` objects with:
|
|||
|
|
- **Event**: `System.Windows.FrameworkElement.ToolTipOpeningEvent`
|
|||
|
|
- **Handler**: A new `System.Windows.Controls.ToolTipEventHandler` wrapping `this.ToolTipEventHandler`
|
|||
|
|
|
|||
|
|
The handler is attached to 12 distinct styles (connection IDs 1–12), corresponding to XAML lines 39, 54, 703, 727, 771, 941, 996, 1050, 1659, 1826, 1912, and 1929 in `CommonStyles.xaml`.
|
|||
|
|
|
|||
|
|
#### `private bool _contentLoaded`
|
|||
|
|
|
|||
|
|
Tracks whether `InitializeComponent()` has been called.
|
|||
|
|
|
|||
|
|
## 3. Invariants
|
|||
|
|
|
|||
|
|
- **Idempotent Initialization**: `InitializeComponent()` may be called multiple times safely; it will only execute once.
|
|||
|
|
- **Fixed Resource URI**: The XAML resource location is hardcoded as `/DTS.Common;component/themes/commonstyles.xaml` with `UriKind.Relative`.
|
|||
|
|
- **Partial Class Contract**: The `ToolTipEventHandler` method referenced in `IStyleConnector.Connect()` must be defined in the non-generated portion of this partial class (not shown in provided source).
|
|||
|
|
- **Connection ID Range**: Valid `connectionId` values for `IStyleConnector.Connect` are 1–12 inclusive.
|
|||
|
|
|
|||
|
|
## 4. Dependencies
|
|||
|
|
|
|||
|
|
### This Module Depends On:
|
|||
|
|
- `System.Windows.ResourceDictionary`
|
|||
|
|
- `System.Windows.Markup.IComponentConnector`
|
|||
|
|
- `System.Windows.Markup.IStyleConnector`
|
|||
|
|
- `System.Windows.Application`
|
|||
|
|
- `System.Windows.EventSetter`
|
|||
|
|
- `System.Windows.FrameworkElement`
|
|||
|
|
- `System.Windows.Controls.ToolTipEventHandler`
|
|||
|
|
- `Microsoft.Windows.Controls` (imported but usage not visible in generated code)
|
|||
|
|
- Extensive WPF namespaces: `System.Windows.Controls`, `System.Windows.Media`, `System.Windows.Shapes`, etc.
|
|||
|
|
|
|||
|
|
### Build-Time Dependencies:
|
|||
|
|
- `PresentationBuildTasks` version 4.0.0.0 (code generator)
|
|||
|
|
|
|||
|
|
### What Depends On This:
|
|||
|
|
- **Unclear from source alone**. The `CommonStyles.xaml` resource dictionary is presumably merged into application-level or window-level resources, but consumers are not visible in this generated file.
|
|||
|
|
|
|||
|
|
## 5. Gotchas
|
|||
|
|
|
|||
|
|
- **Auto-Generated Code**: Both provided files are build outputs (`.g.i.cs` and `.g.cs`). Manual changes will be overwritten on rebuild. The actual implementation logic resides in `CommonStyles.xaml` and any accompanying hand-written code-behind.
|
|||
|
|
- **Missing Partial Class Definition**: The `ToolTipEventHandler` method is referenced but not defined in the provided source. It must exist in the non-generated partial class file (likely `CommonStyles.xaml.cs`).
|
|||
|
|
- **Duplicate Files**: The two provided files (`CommonStyles.g.i.cs` and `CommonStyles.g.cs`) are functionally identical. This duplication may result from different build configurations or intermediate output paths.
|
|||
|
|
- **XAML Not Provided**: The actual style definitions, target types, and visual templates are in `CommonStyles.xaml`, which is not included. The generated code only reveals that 12 styles subscribe to `ToolTipOpeningEvent`.
|
|||
|
|
- **Checksum Verification**: The pragma checksum directive references the original XAML file for integrity verification during builds.
|