C# Class XPlatformMenus.UWP.Controls.NavMenuListView

A specialized ListView to represent the items in the navigation menu.

This class handles the following: 1. Sizes the panel that hosts the items so they fit in the hosting pane. Otherwise, the keyboard may appear cut off on one side b/c the Pane clips instead of affecting layout. 2. Provides a single selection experience where keyboard focus can move without changing selection. Both the 'Space' and 'Enter' keys will trigger selection. The up/down arrow keys can move keyboard focus without triggering selection. This is different than the default behavior when SelectionMode == Single. The default behavior for a ListView in single selection requires using the Ctrl + arrow key to move keyboard focus without triggering selection. Users won't expect this type of keyboarding model on the nav menu.

Inheritance: Windows.UI.Xaml.Controls.ListView

Mostrar archivo Open project: MvvmCross/MvvmCross-Samples

Public Methods

Method	Description
NavMenuListView ( ) : System
SetSelectedItem ( ListViewItem item ) : void	Mark the item as selected and ensures everything else is not. If the item is null then everything is unselected.

Protected Methods

Method	Description
OnApplyTemplate ( ) : void
OnKeyDown ( KeyRoutedEventArgs e ) : void	Custom keyboarding logic to enable movement via the arrow keys without triggering selection until a 'Space' or 'Enter' key is pressed.

Private Methods

Method	Description
InvokeItem ( object focusedItem ) : void
ItemClickedHandler ( object sender, ItemClickEventArgs e ) : void
OnPaneToggled ( ) : void	Re-size the ListView's Panel when the SplitView is compact so the items will fit within the visible space and correctly display a keyboard focus rect.
TryMoveFocus ( FocusNavigationDirection direction ) : void	This method is a work-around until the bug in FocusManager.TryMoveFocus is fixed.

Method Details

NavMenuListView() public method

public NavMenuListView ( ) : System
return	System

OnApplyTemplate() protected method

protected OnApplyTemplate ( ) : void
return	void

OnKeyDown() protected method

Custom keyboarding logic to enable movement via the arrow keys without triggering selection until a 'Space' or 'Enter' key is pressed.

protected OnKeyDown ( KeyRoutedEventArgs e ) : void
e	Windows.UI.Xaml.Input.KeyRoutedEventArgs
return	void

SetSelectedItem() public method

Mark the item as selected and ensures everything else is not. If the item is null then everything is unselected.

public SetSelectedItem ( ListViewItem item ) : void
item	Windows.UI.Xaml.Controls.ListViewItem
return	void