AtomUI/docs/Core/Reflection/ExistingExtensions.md

现有反射扩展清单

本文档列出 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