Document keyboard rearrange support via CanReorderItems

[citelao]

Enabling CanReorderItems, beyond just enabling mouse- and touch-based drag-and-drop reorder of ListView elements, also enables keyboard rearrange support for these items.

Specifically, it enables users to rearrange items with the Alt+Shift+arrow keys hotkey, which is a common rearrange hotkey for Shell components like Start tiles.

We should document this behavior:

• Document that CanReorderItems enables keyboard rearrange support.
• On the drag and drop overview, document that Drag and Drop is not keyboard accessible in most cases, and users should have another way to perform the action.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: e57ae263-5f40-7ebb-a38e-10b826ef1577
• Version Independent ID: aa49ee6c-013e-c639-4bbc-1e1620c0bf1b
• Content: ListViewBase.CanReorderItems Property (Windows.UI.Xaml.Controls) - Windows UWP applications
• Content Source: winrt-api-build/xml/Windows.UI.Xaml.Controls/ListViewBase.xml
• Product: uwp
• Technology: winui
• GitHub Login: @jwmsft
• Microsoft Alias: jimwalk

[citelao]

It is also not clear to me how these hotkeys work. Do they end up firing drag and drop events, or do they simply rearrange the ObservableCollection?

[citelao]

After testing, the hotkeys seem to act like the latter option (simply rearrange the ObservableCollection). They fire two CollectionChanged on the ItemsSource (an add and remove).

This is different from drag-and-drop, which fires the DragStarted event, then similar CollectionChanged events, then DragCompleted events.

This is important to clarify, since I can imagine devs implementing business logic on the DragCompleted event (since it's simpler), and this would not support the hotkey rearrange case.