init
This commit is contained in:
37
docs/ai/Common/DTS.Common/obj/x86/Debug.md
Normal file
37
docs/ai/Common/DTS.Common/obj/x86/Debug.md
Normal file
@@ -0,0 +1,37 @@
|
||||
---
|
||||
source_files:
|
||||
- Common/DTS.Common/obj/x86/Debug/GeneratedInternalTypeHelper.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/GeneratedInternalTypeHelper.g.i.cs
|
||||
generated_at: "2026-04-17T16:37:50.439380+00:00"
|
||||
model: "zai-org/GLM-5-FP8"
|
||||
schema_version: 1
|
||||
sha256: "b7cd54942c3bd36f"
|
||||
---
|
||||
|
||||
# Documentation: GeneratedInternalTypeHelper
|
||||
|
||||
## 1. Purpose
|
||||
|
||||
This module contains auto-generated helper classes produced by the WPF build pipeline (PresentationBuildTasks) during XAML compilation. The `GeneratedInternalTypeHelper` class provides reflection-based utility methods that enable the WPF XAML parser to instantiate types, access properties, create delegates, and attach event handlers at runtime for types that may not be directly accessible. This is infrastructure code generated automatically as part of the XAML markup compilation process and is not intended for direct developer consumption.
|
||||
|
||||
## 2. Public Interface
|
||||
|
||||
**Class:** `GeneratedInternalTypeHelper` (sealed)
|
||||
- **Namespace:** `XamlGeneratedNamespace`
|
||||
- **Base Class:** `System.Windows.Markup.InternalTypeHelper`
|
||||
- **Attributes:**
|
||||
- `System.Diagnostics.DebuggerNonUserCodeAttribute`
|
||||
- `System.CodeDom.Compiler.GeneratedCodeAttribute("PresentationBuildTasks", "4.0.0.0")`
|
||||
- `System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)`
|
||||
|
||||
**Methods:**
|
||||
|
||||
| Method | Signature | Description |
|
||||
|--------|-----------|-------------|
|
||||
| `CreateInstance` | `protected override object CreateInstance(System.Type type, System.Globalization.CultureInfo culture)` | Creates an instance of the specified type using `System.Activator.CreateInstance` with `Public \| NonPublic \| Instance \| CreateInstance` binding flags. |
|
||||
| `GetPropertyValue` | `protected override object GetPropertyValue(System.Reflection.PropertyInfo propertyInfo, object target, System.Globalization.CultureInfo culture)` | Retrieves the value of a property from the target object using reflection with `BindingFlags.Default`. |
|
||||
| `SetPropertyValue` | `protected override void SetPropertyValue(System.Reflection.PropertyInfo propertyInfo, object target, object value, System.Globalization.CultureInfo culture)` | Sets the value of a property on the target object using reflection with `BindingFlags.Default`. |
|
||||
| `CreateDelegate` | `protected override System.Delegate CreateDelegate(System.Type delegateType, object target, string handler)` | Creates a delegate by invoking a non-public instance method `_CreateDelegate` on the target object via `InvokeMember`. |
|
||||
| `AddEventHandler` | `protected override void AddEventHandler(System.Reflection.EventInfo eventInfo, object target, System.Delegate handler)` | Attaches an event handler to the specified event on the target object using `EventInfo.AddEventHandler`. |
|
||||
|
||||
## 3.
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
source_files:
|
||||
- Common/DTS.Common/obj/x86/Debug/BusyIndicatorManager/xBusyIndicator.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/BusyIndicatorManager/xBusyIndicator.g.cs
|
||||
generated_at: "2026-04-17T16:06:29.964296+00:00"
|
||||
model: "zai-org/GLM-5-FP8"
|
||||
schema_version: 1
|
||||
sha256: "277de59d12cd489a"
|
||||
---
|
||||
|
||||
# BusyIndicatorManager
|
||||
|
||||
### Purpose
|
||||
This module contains auto-generated WPF code-behind for the `xBusyIndicator` control, which extends the Xceed Wpf Toolkit's `BusyIndicator`. It serves as the compiled representation of the XAML file `BusyIndicatorManager/xBusyIndicator.xaml`, enabling the WPF runtime to load and connect the XAML-defined UI elements. This is build infrastructure output, not hand-authored code.
|
||||
|
||||
### Public Interface
|
||||
- **`xBusyIndicator`** (class) - Partial class extending `Xceed.Wpf.Toolkit.BusyIndicator` and implementing `System.Windows.Markup.IComponentConnector`.
|
||||
- `void InitializeComponent()` - Loads the XAML component from `/DTS.Common;component/busyindicatormanager/xbusyindicator.xaml`. Guards against multiple initialization via `_contentLoaded` flag.
|
||||
- `void IComponentConnector.Connect(int connectionId, object target)` - Explicit interface implementation for XAML element connection. Sets `_contentLoaded = true` but performs no other connection logic in this generated version.
|
||||
|
||||
### Invariants
|
||||
- `_contentLoaded` field must remain `false` until `InitializeComponent()` is called.
|
||||
- `InitializeComponent()` must be called before the control is displayed (standard WPF pattern).
|
||||
- The XAML resource at the relative URI must exist in the assembly for `LoadComponent` to succeed.
|
||||
|
||||
### Dependencies
|
||||
- **Depends on:** `Xceed.Wpf.Toolkit.BusyIndicator` (third-party control library), `System.Windows` (WPF framework), `System.Windows.Markup.IComponentConnector`.
|
||||
- **Depended on by:** Cannot be determined from generated code alone; likely used by views requiring a busy/loading indicator overlay.
|
||||
|
||||
### Gotchas
|
||||
- This is auto-generated code from `PresentationBuildTasks`. Manual edits will be overwritten on rebuild.
|
||||
- The `Connect` method appears to have no named element connections (connectionId is unused), suggesting the XAML may have no named elements requiring code-behind access, or this is an intermediate build artifact.
|
||||
- The `.g.cs` and `.g.i.cs` files are duplicate outputs (identical content) - this is normal for WPF build process but indicates intermediate build artifacts rather than final source.
|
||||
|
||||
---
|
||||
34
docs/ai/Common/DTS.Common/obj/x86/Debug/Constant.md
Normal file
34
docs/ai/Common/DTS.Common/obj/x86/Debug/Constant.md
Normal file
@@ -0,0 +1,34 @@
|
||||
---
|
||||
source_files:
|
||||
- Common/DTS.Common/obj/x86/Debug/Constant/XamlConstants.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Constant/XamlConstants.g.i.cs
|
||||
generated_at: "2026-04-17T16:06:29.966598+00:00"
|
||||
model: "zai-org/GLM-5-FP8"
|
||||
schema_version: 1
|
||||
sha256: "7a7d1b0bdbc47736"
|
||||
---
|
||||
|
||||
# Constant
|
||||
|
||||
### Purpose
|
||||
This module contains auto-generated WPF code-behind for `XamlConstants`, a `ResourceDictionary` implementation. It represents compiled XAML resources defined in `Constant/XamlConstants.xaml`, providing centralized access to XAML-level constants (styles, templates, brushes, etc.) across the application. This is build infrastructure output.
|
||||
|
||||
### Public Interface
|
||||
- **`XamlConstants`** (class) - Partial class extending `System.Windows.ResourceDictionary` and implementing `System.Windows.Markup.IComponentConnector`.
|
||||
- `void InitializeComponent()` - Loads the XAML resource dictionary from `/DTS.Common;component/constant/xamlconstants.xaml`. Guards against multiple initialization.
|
||||
- `void IComponentConnector.Connect(int connectionId, object target)` - Explicit interface implementation. Sets `_contentLoaded = true` with no additional connection logic.
|
||||
|
||||
### Invariants
|
||||
- Must be loaded as a `ResourceDictionary` in WPF resource merging scenarios.
|
||||
- The XAML file at the specified relative URI must be embedded in the `DTS.Common` assembly.
|
||||
|
||||
### Dependencies
|
||||
- **Depends on:** `System.Windows.ResourceDictionary`, `System.Windows.Markup.IComponentConnector`, `Microsoft.Windows.Controls`.
|
||||
- **Depended on by:** Cannot be determined from generated code alone; likely merged into application or window resources for global constant access.
|
||||
|
||||
### Gotchas
|
||||
- This is auto-generated code. Do not edit manually.
|
||||
- The presence of `Microsoft.Windows.Controls` using directive suggests the XAML may reference controls from that namespace, but actual resource contents are not visible in generated code.
|
||||
- Both `.g.cs` and `.g.i.cs` files are identical, indicating intermediate build artifacts.
|
||||
|
||||
---
|
||||
154
docs/ai/Common/DTS.Common/obj/x86/Debug/Controls.md
Normal file
154
docs/ai/Common/DTS.Common/obj/x86/Debug/Controls.md
Normal file
@@ -0,0 +1,154 @@
|
||||
---
|
||||
source_files:
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/RoundedBox.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/RoundedBox.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/TestIDView.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/TestIDView.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/TestIDControl.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/TestIDControl.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/CommonStatusRibbon.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/CommonStatusRibbon.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/TestIDTestBox.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/TestIDTestBox.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/LookupPopup.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/LookupPopup.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/checkbox.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/checkbox.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Controls/GridViewColumnHeaderSearchable.g.cs
|
||||
generated_at: "2026-04-17T15:26:23.476067+00:00"
|
||||
model: "zai-org/GLM-5-FP8"
|
||||
schema_version: 1
|
||||
sha256: "a1206f2f96436583"
|
||||
---
|
||||
|
||||
# Documentation: DTS.Common.Controls (Auto-Generated WPF Components)
|
||||
|
||||
## 1. Purpose
|
||||
|
||||
This module contains auto-generated partial classes produced by the WPF build process (PresentationBuildTasks) from XAML files in the `DTS.Common` assembly. These generated files provide the code-behind infrastructure for loading XAML resources at runtime via `Application.LoadComponent`. The controls defined here are UI components in the `DTS.Common.Controls` namespace, including custom user controls, a popup dialog, and a resource dictionary for checkbox styling. **Note:** These are intermediate build outputs located in `obj/x86/Debug/Controls/`, not source files; the actual implementation logic resides in companion `.xaml` files and corresponding hand-written partial class files not provided here.
|
||||
|
||||
---
|
||||
|
||||
## 2. Public Interface
|
||||
|
||||
### Classes
|
||||
|
||||
#### `RoundedBox`
|
||||
- **Inherits:** `System.Windows.Controls.UserControl`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/roundedbox.xaml`. Guards against multiple initialization via `_contentLoaded` flag.
|
||||
|
||||
#### `TestIDView`
|
||||
- **Inherits:** `System.Windows.Controls.UserControl`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/testidview.xaml`.
|
||||
|
||||
#### `TestIdControl`
|
||||
- **Inherits:** `System.Windows.Controls.UserControl`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Internal Fields:**
|
||||
- `TestIdInfo` (`DTS.Common.Controls.TestIdControl`) — Self-referencing field bound at XAML line 6.
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/testidcontrol.xaml`.
|
||||
|
||||
#### `CommonStatusRibbon`
|
||||
- **Inherits:** `System.Windows.Controls.UserControl`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Internal Fields:**
|
||||
- `commonStatusRibbon` (`DTS.Common.Controls.CommonStatusRibbon`) — Self-referencing field bound at XAML line 6.
|
||||
- `lblAggregateStatusText` (`System.Windows.Controls.TextBlock`) — Bound at XAML line 80.
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/commonstatusribbon.xaml`.
|
||||
|
||||
#### `TestIDTextBox`
|
||||
- **Inherits:** `System.Windows.Controls.UserControl`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Internal Fields:**
|
||||
- `TestIdTextBoxControl` (`DTS.Common.Controls.TestIDTextBox`) — Self-referencing field bound at XAML line 10.
|
||||
- `tbTestId` (`System.Windows.Controls.TextBox`) — Bound at XAML line 14.
|
||||
- **Event Handlers (referenced but not defined in generated code):**
|
||||
- `tbTestId_PreviewTextInput` — Wired to `PreviewTextInput` event on `tbTestId`.
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/testidtestbox.xaml`.
|
||||
|
||||
#### `LookupPopup`
|
||||
- **Inherits:** `System.Windows.Controls.Primitives.Popup` (not UserControl)
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Internal Fields:**
|
||||
- `lookupPopup` (`DTS.Common.Controls.LookupPopup`) — Self-referencing field bound at XAML line 12.
|
||||
- `possibleChannels` (`System.Windows.Controls.DataGrid`) — Bound at XAML line 42.
|
||||
- **Event Handlers (referenced but not defined in generated code):**
|
||||
- `LookupPopup_OnOpenedClosed` — Wired to both `Opened` and `Closed` events.
|
||||
- `PossibleChannels_OnMouseDoubleClick` — Wired to `MouseDoubleClick` on `possibleChannels`.
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/lookuppopup.xaml`.
|
||||
|
||||
#### `checkbox`
|
||||
- **Inherits:** `System.Windows.ResourceDictionary`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`, `System.Windows.Markup.IStyleConnector`
|
||||
- **Event Handlers (referenced but not defined in generated code):**
|
||||
- `ToolTipEventHandler` — Wired to `ToolTipOpeningEvent` in two styles (connectionId 1 at line 84, connectionId 2 at line 95).
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/checkbox.xaml`.
|
||||
|
||||
#### `GridViewColumnHeaderSearchable`
|
||||
- **Inherits:** `System.Windows.Controls.UserControl`
|
||||
- **Implements:** `System.Windows.Markup.IComponentConnector`
|
||||
- **Internal Fields:**
|
||||
- `dtsGridViewColumnHeader` (`DTS.Common.Controls.GridViewColumnHeaderSearchable`) — Self-referencing field bound at XAML line 8.
|
||||
- `mainGrid` (`System.Windows.Controls.Grid`) — Bound at XAML line 19.
|
||||
- `TogglePopupButton` (`System.Windows.Controls.Primitives.ToggleButton`) — Bound at XAML line 28.
|
||||
- `BtnArrow` (`System.Windows.Shapes.Path`) — Bound at XAML line 30.
|
||||
- `ToggledPopup` (`System.Windows.Controls.Primitives.Popup`) — Bound at XAML line 33.
|
||||
- **Event Handlers (referenced but not defined in generated code):**
|
||||
- `PreviewLeftButtonUp` — Wired to `PreviewMouseLeftButtonDown` on `dtsGridViewColumnHeader`.
|
||||
- `HeaderSearchTerm_KeyDown` — Wired to `KeyUp` on an unnamed TextBox at line 41.
|
||||
- **Public Methods:**
|
||||
- `void InitializeComponent()` — Loads the XAML resource from `/DTS.Common;component/controls/gridviewcolumnheadersearchable.xaml`.
|
||||
|
||||
---
|
||||
|
||||
## 3. Invariants
|
||||
|
||||
1. **Single Initialization Guarantee:** `InitializeComponent()` uses the `_contentLoaded` boolean flag to ensure XAML resource loading occurs exactly once per instance. Subsequent calls return early without re-loading.
|
||||
|
||||
2. **Partial Class Contract:** All classes are declared `partial` and must have corresponding hand-written code-behind files (not provided) that complete the implementation, including event handlers referenced in `Connect()` methods.
|
||||
|
||||
3. **Resource URI Format:** All XAML resources follow the pack URI format `/DTS.Common;component/controls/{filename}.xaml` with `UriKind.Relative`.
|
||||
|
||||
4. **Thread Affinity:** As WPF controls, all instances must be created and accessed on the UI thread (implied by inheritance from `DispatcherObject` via `DependencyObject`).
|
||||
|
||||
5. **IComponentConnector Contract:** The explicit interface implementation `Connect(int connectionId, object target)` is marked `void` and is used by the WPF parser to wire up named elements and events during XAML parsing.
|
||||
|
||||
---
|
||||
|
||||
## 4. Dependencies
|
||||
|
||||
### External Dependencies (from imports)
|
||||
- `System.Windows.*` namespaces (WPF core): `System.Windows`, `System.Windows.Controls`, `System.Windows.Controls.Primitives`, `System.Windows.Data`, `System.Windows.Documents`, `System.Windows.Input`, `System.Windows.Markup`, `System.Windows.Media`, `System.Windows.Shapes`, `System.Windows.Navigation`, `System.Windows.Automation`, `System.Windows.Ink`, `System.Windows.Media.Animation`, `System.Windows.Media.Effects`, `System.Windows.Media.Imaging`, `System.Windows.Media.Media3D`, `System.Windows.Media.TextFormatting`, `System.Windows.Shell`
|
||||
- `Microsoft.Windows.Controls` — Indicates dependency on a custom or extended WPF control library (possibly WPF Toolkit or custom assembly).
|
||||
- `DTS.Common.Strings` — Referenced in `LookupPopup`, indicating a string resource or localization dependency.
|
||||
|
||||
### Internal Dependencies
|
||||
- `DTS.Common.Controls` — Self-referential; controls reference each other within the same namespace.
|
||||
|
||||
### Consumers
|
||||
- Unknown from provided source alone. These controls are likely consumed by other assemblies/projects referencing `DTS.Common`.
|
||||
|
||||
---
|
||||
|
||||
## 5. Gotchas
|
||||
|
||||
1. **Auto-Generated Files:** These files are located in `obj/x86/Debug/Controls/` and are regenerated on each build. **Do not edit these files directly.** Changes will be lost. The actual source is the corresponding `.xaml` and `.xaml.cs` files in `Controls/`.
|
||||
|
||||
2. **Missing Implementation:** Event handlers such as `tbTestId_PreviewTextInput`, `LookupPopup_OnOpenedClosed`, `PossibleChannels_OnMouseDoubleClick`, `ToolTipEventHandler`, `PreviewLeftButtonUp`, and `HeaderSearchTerm_KeyDown` are referenced but not defined in these generated files. They must exist in the hand-written partial class files.
|
||||
|
||||
3. **Self-Referencing Fields:** Several controls (`TestIdControl`, `CommonStatusRibbon`, `TestIDTextBox`, `LookupPopup`, `GridViewColumnHeaderSearchable`) have internal fields referencing their own type. This pattern suggests the XAML contains a named element matching the control type (possibly a root element with `x:Name`). The purpose is unclear from generated code alone.
|
||||
|
||||
4. **Naming Inconsistency:** The file `TestIDTestBox.g.cs` defines class `TestIDTextBox` (note: "TextBox" vs "TestBox" in filename). The XAML resource path is `testidtestbox.xaml`. This discrepancy may cause confusion.
|
||||
|
||||
5. **Event Naming Mismatch:** In `GridViewColumnHeaderSearchable`, the event handler `PreviewLeftButtonUp` is wired to the `PreviewMouseLeftButtonDown` event. The handler name suggests "Up" while the event is "Down" — this may be intentional or a bug in the hand-written code.
|
||||
|
||||
6. **Debug Build Configuration:** These files are from an x86 Debug build. Release builds or different platform targets may produce different generated code.
|
||||
93
docs/ai/Common/DTS.Common/obj/x86/Debug/Dialogs.md
Normal file
93
docs/ai/Common/DTS.Common/obj/x86/Debug/Dialogs.md
Normal file
@@ -0,0 +1,93 @@
|
||||
---
|
||||
source_files:
|
||||
- Common/DTS.Common/obj/x86/Debug/Dialogs/NotificationWindow.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Dialogs/NotificationWindow.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Dialogs/ConfirmationWindow.g.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Dialogs/ConfirmationWindow.g.i.cs
|
||||
generated_at: "2026-04-17T15:37:50.866970+00:00"
|
||||
model: "zai-org/GLM-5-FP8"
|
||||
schema_version: 1
|
||||
sha256: "36f77dfe5ce8c20c"
|
||||
---
|
||||
|
||||
# Documentation: DTS.Common.Dialogs
|
||||
|
||||
## 1. Purpose
|
||||
|
||||
This module provides WPF dialog window components for user interaction within the DTS.Common library. It contains auto-generated partial classes for `NotificationWindow` and `ConfirmationWindow`, which serve as standard UI dialogs for displaying notifications and confirmation prompts respectively. These classes are generated by the WPF build process from XAML definitions and implement `IComponentConnector` to support XAML element naming and event binding.
|
||||
|
||||
---
|
||||
|
||||
## 2. Public Interface
|
||||
|
||||
### NotificationWindow
|
||||
|
||||
**Class:** `DTS.Common.Dialogs.NotificationWindow`
|
||||
**Inheritance:** `System.Windows.Window`, `System.Windows.Markup.IComponentConnector`
|
||||
|
||||
| Member | Signature | Description |
|
||||
|--------|-----------|-------------|
|
||||
| `InitializeComponent()` | `public void InitializeComponent()` | Loads the XAML component from `/DTS.Common;component/dialogs/notificationwindow.xaml`. Idempotent—returns early if already called. |
|
||||
| `Connect(int, object)` | `void IComponentConnector.Connect(int connectionId, object target)` | Internal method that wires named XAML elements to their code-behind fields and attaches event handlers. Not intended for direct use. |
|
||||
|
||||
**Internal Fields (XAML-named elements):**
|
||||
- `notificationWindow` — Self-reference to the window instance (line 7 of XAML)
|
||||
- `LayoutRoot` — `System.Windows.Controls.Grid` container (line 45 of XAML)
|
||||
- `OKButton` — `System.Windows.Controls.Button` for dismissal (line 63 of XAML)
|
||||
|
||||
**Event Handler (referenced):**
|
||||
- `CoppyToClibord_Click` — `System.Windows.RoutedEventHandler` attached to an unnamed button's `Click` event (line 62 of XAML). **Note:** Implementation resides in the non-generated code-behind file (not provided).
|
||||
|
||||
---
|
||||
|
||||
### ConfirmationWindow
|
||||
|
||||
**Class:** `DTS.Common.Dialogs.ConfirmationWindow`
|
||||
**Inheritance:** `System.Windows.Window`, `System.Windows.Markup.IComponentConnector`
|
||||
|
||||
| Member | Signature | Description |
|
||||
|--------|-----------|-------------|
|
||||
| `InitializeComponent()` | `public void InitializeComponent()` | Loads the XAML component from `/DTS.Common;component/dialogs/confirmationwindow.xaml`. Idempotent—returns early if already called. |
|
||||
| `Connect(int, object)` | `void IComponentConnector.Connect(int connectionId, object target)` | Internal method that wires named XAML elements to their code-behind fields. Not intended for direct use. |
|
||||
|
||||
**Internal Fields (XAML-named elements):**
|
||||
- `confirmationWindow` — Self-reference to the window instance (line 6 of XAML)
|
||||
- `LayoutRoot` — `System.Windows.Controls.Grid` container (line 27 of XAML)
|
||||
- `OKButton` — `System.Windows.Controls.Button` for confirmation (line 45 of XAML)
|
||||
- `CancelButton` — `System.Windows.Controls.Button` for cancellation (line 53 of XAML)
|
||||
|
||||
---
|
||||
|
||||
## 3. Invariants
|
||||
|
||||
- **Single Initialization:** `InitializeComponent()` must only be called once per instance. Subsequent calls return immediately without reloading the XAML.
|
||||
- **Partial Class Requirement:** Both `NotificationWindow` and `ConfirmationWindow` are `partial` classes. The actual business logic, event handler implementations, and additional members must be defined in companion code-behind files (e.g., `NotificationWindow.xaml.cs`).
|
||||
- **XAML Resource Availability:** The XAML resources at `/DTS.Common;component/dialogs/notificationwindow.xaml` and `/DTS.Common;component/dialogs/confirmationwindow.xaml` must be embedded in the assembly for `Application.LoadComponent` to succeed.
|
||||
- **Connection IDs:** The `Connect` method uses hardcoded `connectionId` values (1–4). These must remain synchronized with the XAML compilation output.
|
||||
|
||||
---
|
||||
|
||||
## 4. Dependencies
|
||||
|
||||
**This module depends on:**
|
||||
- `System.Windows` (WPF core)
|
||||
- `System.Windows.Controls`
|
||||
- `System.Windows.Markup` (`IComponentConnector`)
|
||||
- `Microsoft.Xaml.Behaviors` (behavior libraries referenced in imports)
|
||||
- `Microsoft.Windows.Controls` (extended controls)
|
||||
- `PresentationBuildTasks` (code generation, runtime version 4.0.30319.42000)
|
||||
|
||||
**Consumers:**
|
||||
- Unknown from source alone. These dialogs are likely consumed by other modules within the DTS system that require user notification or confirmation.
|
||||
|
||||
---
|
||||
|
||||
## 5. Gotchas
|
||||
|
||||
1. **Typo in Event Handler Name:** The event handler `CoppyToClibord_Click` contains spelling errors ("Coppy" instead of "Copy", "Clibord" instead of "Clipboard"). This typo exists in the XAML and propagates to the generated code. The actual implementation method in the code-behind must match this exact spelling.
|
||||
|
||||
2. **Auto-Generated Files:** The provided source files (`.g.cs` and `.g.i.cs`) are auto-generated and should not be manually edited. Any changes will be overwritten on recompilation. Modifications must be made in the corresponding `.xaml` and `.xaml.cs` files.
|
||||
|
||||
3. **Missing Code-Behind:** The actual implementations of `CoppyToClibord_Click` and any additional logic are not present in these generated files. The behavior of these dialogs cannot be fully understood without the companion `.xaml.cs` files.
|
||||
|
||||
4. **Duplicate Files:** Both `.g.cs` and `.g.i.cs` variants are provided for each window. These are functionally identical in content; the `.g.i.cs` variant is used for IntelliSense during design-time, while `.g.cs` is used at compile-time.
|
||||
48
docs/ai/Common/DTS.Common/obj/x86/Debug/Resources.md
Normal file
48
docs/ai/Common/DTS.Common/obj/x86/Debug/Resources.md
Normal file
@@ -0,0 +1,48 @@
|
||||
---
|
||||
source_files:
|
||||
- Common/DTS.Common/obj/x86/Debug/Resources/MainTabControlResource.g.i.cs
|
||||
- Common/DTS.Common/obj/x86/Debug/Resources/MainTabControlResource.g.cs
|
||||
generated_at: "2026-04-17T15:40:58.277128+00:00"
|
||||
model: "zai-org/GLM-5-FP8"
|
||||
schema_version: 1
|
||||
sha256: "7d2e742f998813e1"
|
||||
---
|
||||
|
||||
# Documentation: MainTabControlResource (Generated)
|
||||
|
||||
## 1. Purpose
|
||||
|
||||
This module contains auto-generated code-behind for `MainTabControlResource.xaml`, a WPF `ResourceDictionary` that defines styles and resources for a main tab control UI component. The generated class facilitates XAML parsing, component loading, and event wire-up at runtime. It exists as part of the WPF build pipeline (PresentationBuildTasks) and bridges the XAML markup to the runtime object model. This resource is part of the `DTS.Common` assembly and provides centralized tab control styling for the application.
|
||||
|
||||
---
|
||||
|
||||
## 2. Public Interface
|
||||
|
||||
### Class: `MainTabControlResource`
|
||||
**Signature:** `public partial class MainTabControlResource : System.Windows.ResourceDictionary, System.Windows.Markup.IComponentConnector, System.Windows.Markup.IStyleConnector`
|
||||
|
||||
A partial class representing the code-behind for the `MainTabControlResource.xaml` resource dictionary. Implements standard WPF markup interfaces for component initialization and style event connection.
|
||||
|
||||
#### Methods
|
||||
|
||||
| Method | Signature | Description |
|
||||
|--------|-----------|-------------|
|
||||
| `InitializeComponent` | `public void InitializeComponent()` | Loads the XAML resource from the assembly at path `/DTS.Common;component/resources/maintabcontrolresource.xaml`. Idempotent—subsequent calls return immediately if already loaded. |
|
||||
| `IComponentConnector.Connect` | `void IComponentConnector.Connect(int connectionId, object target)` | Explicit interface implementation. Sets `_contentLoaded = true`. Used by the XAML parser for named element connection. |
|
||||
| `IStyleConnector.Connect` | `void IStyleConnector.Connect(int connectionId, object target)` | Explicit interface implementation. Handles event setter wiring for styles. Currently handles `connectionId == 1` by attaching a `ToolTipEventHandler` to the `ToolTipOpeningEvent` on a `Style` target. |
|
||||
|
||||
#### Fields
|
||||
|
||||
| Field | Type | Description |
|
||||
|-------|------|-------------|
|
||||
| `_contentLoaded` | `private bool` | Tracks whether `InitializeComponent()` has been called. Prevents duplicate loading. |
|
||||
|
||||
---
|
||||
|
||||
## 3. Invariants
|
||||
|
||||
- **Idempotent Initialization**: `InitializeComponent()` may be called multiple times safely; only the first call performs the load operation.
|
||||
- **Fixed Resource URI**: The resource locator is always `/DTS.Common;component/resources/maintabcontrolresource.xaml` with `UriKind.Relative`.
|
||||
- **Checksum Verification**: The file includes a pragma checksum (`433BC842528F2BF08865BDC9F7F4E3C6EAF63C0287392B36C24724AF9D799FA2`) for the source XAML file to ensure integrity.
|
||||
- **Partial Class Requirement**: The `MainTabControlResource` class is `partial`, requiring a companion code-behind file that defines the `ToolTipEventHandler` method referenced in `IStyleConnector.Connect`.
|
||||
- **Connection ID 1 Contract**: The `IStyleConnector.Connect`
|
||||
75
docs/ai/Common/DTS.Common/obj/x86/Debug/Themes.md
Normal file
75
docs/ai/Common/DTS.Common/obj/x86/Debug/Themes.md
Normal file
@@ -0,0 +1,75 @@
|
||||
---
|
||||
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.
|
||||
Reference in New Issue
Block a user