avalonia-input-interaction
Use when handling pointer events, keyboard input, gestures, focus, drag-and-drop, or hot keys in Avalonia 11.3/12.x. Covers PointerPressed/Released/Moved, KeyDown/KeyUp, TextInput, HotKeyManager, KeyGesture, focus management and Focus Traversal (12.0+), gesture events and recognizers, drag-and-drop (DragDrop.DoDragDropAsync, DataTransfer, DataFormat; 11.x DataObject), and Cursor types.
linuxdevel · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add linuxdevel/Avalonia-skills --skill avalonia-input-interaction技能说明
name: avalonia-input-interaction description: Use when handling pointer events, keyboard input, gestures, focus, drag-and-drop, or hot keys in Avalonia 11.3/12.x. Covers PointerPressed/Released/Moved, KeyDown/KeyUp, TextInput, HotKeyManager, KeyGesture, focus management and Focus Traversal (12.0+), gesture events and recognizers, drag-and-drop (DragDrop.DoDragDropAsync, DataTransfer, DataFormat; 11.x DataObject), and Cursor types.
Avalonia Input & Interaction
Version labels: see avalonia-versions. (12.0+) = 12.x only, (11.x) = 11.x only, unlabeled = all.
Overview
All input routes as routed events (bubbling by default, tunneling with "Preview" prefix). Pointer events are unified across mouse, touch, and stylus.
(12.0+) Touch/pen select and focus on pointer release, not press (mouse unchanged). ListBoxItem/TreeViewItem handle selection themselves. Access keys (_Save) match the symbol printed on the key (accents, digits); AccessText.AccessKey is string?.
Pointer Events
| Event | Fires when |
|---|---|
PointerPressed | Button/finger down |
PointerReleased | Button/finger up |
PointerMoved | Pointer moves over control |
PointerEntered | Pointer enters bounds |
PointerExited | Pointer leaves bounds |
PointerCaptureLost | Capture released |
Tapped | Quick tap/click |
DoubleTapped | Double tap/click |
RightTapped | Right-click / long press |
myControl.PointerPressed += (s, e) =>
{
var point = e.GetPosition(myControl);
var props = e.GetCurrentPoint(myControl).Properties;
if (props.IsLeftButtonPressed) { /* left click */ }
if (props.IsRightButtonPressed) { /* right click */ }
if (props.IsMiddleButtonPressed) { /* middle click */ }
};
Capture pointer (receive events outside bounds):
myControl.PointerPressed += (s, e) =>
{
e.Pointer.Capture(myControl);
};
myControl.PointerReleased += (s, e) =>
{
e.Pointer.Capture(null); // release
};
Check pointer type:
myControl.PointerPressed += (s, e) =>
{
if (e.Pointer.Type == PointerType.Touch) { /* touch */ }
if (e.Pointer.Type == PointerType.Pen) { /* stylus */ }
};
Keyboard Events
| Event | Fires when |
|---|---|
KeyDown | Key pressed (repeats while held) |
KeyUp | Key released |
TextInput | Text character produced |
myControl.KeyDown += (s, e) =>
{
if (e.Key == Key.Enter && e.KeyModifiers == KeyModifiers.Control)
{
e.Handled = true; // stop bubbling + prevent default
SubmitForm();
}
};
myTextBox.TextInput += (s, e) =>
{
if (!char.IsDigit(e.Text![0]))
e.Handled = true; // block non-digit input
};
KeyModifiers flags: None, Alt, Control, Shift, Meta (combinable with |)
// Ctrl+Shift+Z
if (e.Key == Key.Z && e.KeyModifiers == (KeyModifiers.Control | KeyModifiers.Shift))
Hot Keys
XAML registration:
<Button HotKey="Ctrl+S" Command="{Binding SaveCommand}" Content="Save"/>
<MenuItem HotKey="Ctrl+Z" Header="Undo" Command="{Binding UndoCommand}"/>
Code registration:
HotKeyManager.RegisterHotKey(myControl, new KeyGesture(Key.S, KeyModifiers.Control));
HotKeyManager.SetHotKey(myButton, new KeyGesture(Key.F5));
Unregister:
HotKeyManager.SetHotKey(myControl, null);
Focus
// Programmatic focus
myControl.Focus(NavigationMethod.Tab);
// Via FocusManager
var fm = TopLevel.GetTopLevel(this)?.FocusManager;
fm?.Focus(myControl, NavigationMethod.Tab);
var focused = fm?.GetFocusedElement();
XAML focus control:
<TextBox IsTabStop="False"/> <!-- exclude from tab order -->
<TextBox TabIndex="2"/> <!-- explicit tab order -->
There is no AutoFocus property; call Focus() after attach (e.g. in Loaded/OnAttachedToVisualTree) or use FocusManager.
(12.0+) Focus Traversal API — IFocusManager is public and manages all focus:
fm.TryMoveFocus(NavigationDirection.Next); // bool
var next = fm.FindNextElement(NavigationDirection.Next); // IInputElement? (options: FindNextElementOptions)
var first = fm.FindFirstFocusableElement();
var last = fm.FindLastFocusableElement();
(11.x) KeyboardNavigationHandler.GetNext — removed in 12.
(12.0+) Cancellable focus — GettingFocus / LosingFocus use FocusChangingEventArgs:
myBox.LosingFocus += (s, e) =>
{
if (!IsValid()) e.TryCancel(); // or e.TrySetNewFocusedElement(otherControl)
};
GotFocus / LostFocus use (12.0+) FocusChangedEventArgs (OldFocusedElement, NewFocusedElement, NavigationMethod, KeyModifiers); (11.x) GotFocusEventArgs.
Pseudoclasses for styling:
<Style Selector="TextBox:focus">
<Setter Property="BorderBrush" Value="Blue"/>
</Style>
<Style Selector="Button:focus-visible">
<Setter Property="BorderThickness" Value="2"/>
</Style>
Focus scope (contains Tab navigation):
<Panel FocusManager.IsFocusScope="True">
<!-- Tab cycles within this panel -->
</Panel>
Gestures
Tapped, RightTapped, DoubleTapped, Holding are events on InputElement. Touch gestures are raised by recognizers added to GestureRecognizers (e.g. PinchGestureRecognizer, ScrollGestureRecognizer, PullGestureRecognizer) and handled as routed events on the element:
<!-- (12.0+) events directly on InputElement -->
<Border Pinch="OnPinch" PinchEnded="OnPinchEnded">
<Border.GestureRecognizers>
<PinchGestureRecognizer/>
</Border.GestureRecognizers>
</Border>
<!-- (11.x) Gestures.Pinch="OnPinch" Gestures.PinchEnded="OnPinchEnded" -->
private void OnPinch(object? sender, PinchEventArgs e)
{
_scale *= e.Scale;
myBorder.RenderTransform = new ScaleTransform(_scale, _scale);
}
Event (on InputElement) | Args |
|---|---|
Pinch, PinchEnded | PinchEventArgs, PinchEndedEventArgs |
| `Pul |