10 KiB
source_files, generated_at, model, schema_version, sha256
| source_files | generated_at | model | schema_version | sha256 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
2026-04-17T15:26:23.476067+00:00 | zai-org/GLM-5-FP8 | 1 | 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_contentLoadedflag.
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 toPreviewTextInputevent ontbTestId.
- 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 bothOpenedandClosedevents.PossibleChannels_OnMouseDoubleClick— Wired toMouseDoubleClickonpossibleChannels.
- 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 toToolTipOpeningEventin 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 toPreviewMouseLeftButtonDownondtsGridViewColumnHeader.HeaderSearchTerm_KeyDown— Wired toKeyUpon an unnamed TextBox at line 41.
- Public Methods:
void InitializeComponent()— Loads the XAML resource from/DTS.Common;component/controls/gridviewcolumnheadersearchable.xaml.
3. Invariants
-
Single Initialization Guarantee:
InitializeComponent()uses the_contentLoadedboolean flag to ensure XAML resource loading occurs exactly once per instance. Subsequent calls return early without re-loading. -
Partial Class Contract: All classes are declared
partialand must have corresponding hand-written code-behind files (not provided) that complete the implementation, including event handlers referenced inConnect()methods. -
Resource URI Format: All XAML resources follow the pack URI format
/DTS.Common;component/controls/{filename}.xamlwithUriKind.Relative. -
Thread Affinity: As WPF controls, all instances must be created and accessed on the UI thread (implied by inheritance from
DispatcherObjectviaDependencyObject). -
IComponentConnector Contract: The explicit interface implementation
Connect(int connectionId, object target)is markedvoidand 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.ShellMicrosoft.Windows.Controls— Indicates dependency on a custom or extended WPF control library (possibly WPF Toolkit or custom assembly).DTS.Common.Strings— Referenced inLookupPopup, 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
-
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.xamland.xaml.csfiles inControls/. -
Missing Implementation: Event handlers such as
tbTestId_PreviewTextInput,LookupPopup_OnOpenedClosed,PossibleChannels_OnMouseDoubleClick,ToolTipEventHandler,PreviewLeftButtonUp, andHeaderSearchTerm_KeyDownare referenced but not defined in these generated files. They must exist in the hand-written partial class files. -
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 withx:Name). The purpose is unclear from generated code alone. -
Naming Inconsistency: The file
TestIDTestBox.g.csdefines classTestIDTextBox(note: "TextBox" vs "TestBox" in filename). The XAML resource path istestidtestbox.xaml. This discrepancy may cause confusion. -
Event Naming Mismatch: In
GridViewColumnHeaderSearchable, the event handlerPreviewLeftButtonUpis wired to thePreviewMouseLeftButtonDownevent. The handler name suggests "Up" while the event is "Down" — this may be intentional or a bug in the hand-written code. -
Debug Build Configuration: These files are from an x86 Debug build. Release builds or different platform targets may produce different generated code.