mirror of
https://github.com/AtomUI/AtomUI.git
synced 2026-10-22 00:46:48 +08:00
chinboy
322 lines
11 KiB
Markdown
322 lines
11 KiB
Markdown
# 现有反射扩展清单
|
||
|
||
> 本文档列出 AtomUI 项目中所有反射扩展类及其 Hook 的 Avalonia 内部成员。
|
||
> 升级 Avalonia 版本时，请逐一对照此清单验证兼容性。
|
||
> 最后更新：2026-04-11（基于 Avalonia v11.3.x）
|
||
|
||
---
|
||
|
||
## AtomUI.Core
|
||
|
||
### AnimatableReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Animations/AnimatableReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Animations` |
|
||
| 目标类型 | `Avalonia.Animation.Animatable` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `EnableTransitions` | Method | NonPublicMethods | `EnableTransitions()` |
|
||
| `DisableTransitions` | Method | NonPublicMethods | `DisableTransitions()` |
|
||
|
||
---
|
||
|
||
### DynamicResourceReflectionExtension
|
||
|
||
| 文件 | `src/AtomUI.Core/Data/DynamicResourceReflectionExtension.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Data` |
|
||
| 目标类型 | `Avalonia.Markup.Xaml.MarkupExtensions.DynamicResourceExtension` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `_anchor` | Field | NonPublicFields | `SetAnchor(object?)` |
|
||
|
||
---
|
||
|
||
### StyledElementReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Reflection/StyledElementReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Reflection` |
|
||
| 目标类型 | `Avalonia.Controls.StyledElement` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `LogicalChildren` | Property | NonPublicProperties | `GetLogicalChildrenList()`, `AddToLogicalChildren()`, `InsertToLogicalChildren()` |
|
||
| `TemplatedParent` | Property | NonPublicProperties | `SetTemplatedParent()`, `SetTemplatedParentRecursive()` |
|
||
|
||
---
|
||
|
||
### VisualReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Controls/VisualReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Controls` |
|
||
| 目标类型 | `Avalonia.Visual` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `SetVisualParent` | Method | NonPublicMethods | `SetVisualParent()`, `ClearVisualParentRecursive()` |
|
||
| `VisualChildren` | Property | NonPublicProperties | `GetVisualChildrenList()`, `IndexOfVisualChildren()`, `AddToVisualChildren()`, `InsertToVisualChildren()` |
|
||
|
||
---
|
||
|
||
### ILayoutRootReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Controls/ILayoutRootReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Controls` |
|
||
| 目标类型 | `Avalonia.Layout.ILayoutRoot` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `LayoutManager` | Property | NonPublicProperties | `GetLayoutManager()` |
|
||
|
||
---
|
||
|
||
### RawPointerEventTypeReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Controls/RawPointerEventTypeReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Controls` |
|
||
| 目标类型 | `Avalonia.Input.Raw.RawPointerEventArgs` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `InputHitTestResult` | Property | NonPublicProperties | `GetInputHitTestResult()` |
|
||
|
||
---
|
||
|
||
### ItemCollectionReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Controls/ItemCollectionReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Controls` |
|
||
| 目标类型 | `Avalonia.Controls.ItemCollection` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `SetItemsSource` | Method | NonPublicMethods | `SetItemsSource(IEnumerable?)` |
|
||
|
||
---
|
||
|
||
### ManagedPopupPositionerReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Utils/ManagedPopupPositionerReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Utils` |
|
||
| 目标类型 | `Avalonia.Controls.Primitives.PopupPositioning.ManagedPopupPositioner` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `_popup` | Field | NonPublicFields | `GetManagedPopupPositionerPopup()` |
|
||
|
||
---
|
||
|
||
### AvaloniaPropertyReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Utils/AvaloniaPropertyReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Utils` |
|
||
| 目标类型 | `Avalonia.AvaloniaProperty`（动态类型） |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `Notifying` | Property | NonPublicProperties | `InvokeNotifying(AvaloniaObject, bool)` |
|
||
|
||
> ⚠️ **注意**：此类未使用标准的 `Lazy<T>` + `[DynamicDependency]` 模式，因为目标类型是运行时动态确定的（`property.GetType()` 返回具体的泛型闭合类型）。这是一个特殊情况。
|
||
|
||
---
|
||
|
||
### TransformTrackingHelper
|
||
|
||
| 文件 | `src/AtomUI.Core/Input/TransformTrackingHelper.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Input` |
|
||
| 目标类型 | `Avalonia.Threading.DispatcherPriority` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法/使用方式 |
|
||
|---|---|---|---|
|
||
| `AfterRender` | Field (static) | NonPublicFields | 在 `EnqueueForUpdate()` 中获取调度优先级 |
|
||
|
||
> **注意**：此类不是标准的 `ReflectionExtensions` 扩展类，而是一个独立的辅助类，内部使用了反射来访问 `DispatcherPriority.AfterRender` 静态私有字段。
|
||
|
||
---
|
||
|
||
### TextParagraphPropertiesReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Core/Media/TextFormatting/TextParagraphPropertiesReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Media.TextFormatting` |
|
||
| 目标类型 | `Avalonia.Media.TextFormatting.TextParagraphProperties` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `LineSpacing` | Property | NonPublicProperties | `GetLineSpacing()`, `SetLineSpacing(double)` |
|
||
|
||
---
|
||
|
||
## AtomUI.Desktop.Controls
|
||
|
||
### TextBlockReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/TextBlock/TextBlockReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls` |
|
||
| 目标类型 | `Avalonia.Controls.TextBlock` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `GetMaxSizeFromConstraint` | Method | NonPublicMethods | `GetMaxSizeFromConstraint()` |
|
||
| `HasComplexContent` | Property | NonPublicProperties | `GetHasComplexContent()` |
|
||
|
||
---
|
||
|
||
### ScrollContentPresenterReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/TabControl/ScrollContentPresenterReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls` |
|
||
| 目标类型 | `Avalonia.Controls.Presenters.ScrollContentPresenter` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `SnapOffset` | Method | NonPublicMethods | `SnapOffset(Vector, Vector, bool)` |
|
||
|
||
---
|
||
|
||
### SelectingItemsControlReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Primitives/SelectingItemsControlReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls.Primitives` |
|
||
| 目标类型 | `Avalonia.Controls.Primitives.SelectingItemsControl` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `MarkContainerSelected` | Method | NonPublicMethods | `MarkContainerSelected(Control, bool)` |
|
||
| `InitializeSelectionModel` | Method | NonPublicMethods | `InitializeSelectionModel(ISelectionModel)` |
|
||
| `_selection` | Field | NonPublicFields | `SetSelection(ISelectionModel?)`, `GetSelection()` |
|
||
|
||
---
|
||
|
||
### SelectionModelReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Primitives/SelectionModelReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls.Primitives` |
|
||
| 目标类型 | `Avalonia.Controls.Selection.SelectionModel<>` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `SetInitSelectedItems` | Method | NonPublicMethods | `SetInitSelectedItems<T>(IList)` |
|
||
| `SetSource` | Method | NonPublicMethods | `SetSource<T>(IEnumerable?)` |
|
||
|
||
> **注意**：泛型目标类型，使用 `ConcurrentDictionary<Type, MethodInfo>` 缓存。
|
||
|
||
---
|
||
|
||
### MenuReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Menu/MenuReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls` |
|
||
| 目标类型 | `Avalonia.Controls.ContextMenu` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `_popup` | Field | NonPublicFields | `SetPopup(Popup)` |
|
||
| 动态方法名 | Method | NonPublicMethods | `CreateEventHandler<T>(string)`, `CreateEventHandler(string)` |
|
||
|
||
---
|
||
|
||
### ComboBoxReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/ComboBox/ComboBoxReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls` |
|
||
| 目标类型 | `Avalonia.Controls.ComboBox` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `_popup` | Field | NonPublicFields | `SetPopup(Popup?)` |
|
||
|
||
---
|
||
|
||
### WindowBaseReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Window/WindowBaseReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls` |
|
||
| 目标类型 | `Avalonia.Controls.WindowBase` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `FreezeVisibilityChangeHandling` | Method | NonPublicMethods | `FreezeVisibilityChangeHandling()` (private) |
|
||
| `EnsureInitialized` | Method | NonPublicMethods | `EnsureInitialized()` (private) |
|
||
| `_hasExecutedInitialLayoutPass` | Field | NonPublicFields | `HasExecutedInitialLayoutPass()`, `SetHasExecutedInitialLayoutPass()` (private) |
|
||
| `StartRendering` | Method | NonPublicMethods | `StartRendering()` (private) |
|
||
| `OnOpened` | Method | NonPublicMethods | `OnOpened(EventArgs)` (private) |
|
||
|
||
> **注意**：此类展示了入口方法 `ShowWithoutActive()` 为 `public`，内部子步骤为 `private` 的组合模式。
|
||
|
||
---
|
||
|
||
### PopupReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Popup/PopupReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls` |
|
||
| 目标类型 | `AtomUI.Desktop.Controls.Popup` / `Avalonia.Controls.Primitives.Popup` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `SetPopupParent` | Method | NonPublicMethods | `SetPopupParent(Control?)` |
|
||
| `UpdateHostPosition` | Method | NonPublicMethods | `UpdateHostPosition(IPopupHost, Control)` |
|
||
| `Closing` | Event | NonPublicEvents | `AddClosingEventHandler()`, `RemoveClosingEventHandler()` |
|
||
| `_ignoreIsOpenChanged` | Field | NonPublicFields | `SetIgnoreIsOpenChanged(bool)`, `GetIgnoreIsOpenChanged()` |
|
||
|
||
---
|
||
|
||
### TextBoxReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Input/Utils/TextBoxReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls.Utils` |
|
||
| 目标类型 | `Avalonia.Controls.TextBox` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `_scrollViewer` | Field | NonPublicFields | `GetScrollViewer()`, `SetScrollViewer()` |
|
||
| `_presenter` | Field | NonPublicFields | `GetTextPresenter()` |
|
||
| `ScrollViewer_ScrollChanged` | Method | NonPublicMethods | `HandleScrollChanged()` |
|
||
| `GetVerticalSpaceBetweenScrollViewerAndPresenter` | Method | NonPublicMethods | `GetVerticalSpaceBetweenScrollViewerAndPresenter()` |
|
||
| `SnapshotUndoRedo` | Method | NonPublicMethods | `SnapshotUndoRedo()` |
|
||
| `HandleTextInput` | Method | NonPublicMethods | `HandleTextInput(string?)` |
|
||
|
||
---
|
||
|
||
### TextLayoutReflectionExtensions
|
||
|
||
| 文件 | `src/AtomUI.Desktop.Controls/Input/Utils/TextLayoutReflectionExtensions.cs` |
|
||
|---|---|
|
||
| 命名空间 | `AtomUI.Desktop.Controls.Utils` |
|
||
| 目标类型 | `Avalonia.Media.TextFormatting.TextLayout` |
|
||
|
||
| Hook 成员 | 类型 | 成员类型 | 扩展方法 |
|
||
|---|---|---|---|
|
||
| `CreateTextParagraphProperties` | Method (static) | NonPublicMethods | `CreateTextParagraphProperties(...)` |
|
||
|
||
---
|
||
|
||
## 统计摘要
|
||
|
||
| 项目 | 扩展类数量 | Hook 成员总数 |
|
||
|---|---|---|
|
||
| AtomUI.Core | 10 | 17 |
|
||
| AtomUI.Desktop.Controls | 9 | 24 |
|
||
| **合计** | **19** | **41** |
|
||
|