PrimaryAxis Enumeration

Value representing which axis of a DataRow must be completely visible in order to determine which DataRow will receive the focus when the page-up or page-down buttons are pressed.

Syntax

Visual Basic
C#

'Declaration
 
Public Enum PrimaryAxis 
   Inherits System.Enum

'Usage
 
Dim instance As PrimaryAxis

public enum PrimaryAxis : System.Enum

Members

Member	Description
Both	Both the vertical and horizontal axes must be completely visible (see item 1 in the image below).
Horizontal	The horizontal axis ust be completely visible (see item 2 in the image below).
None	Neither the vertical nor horizontal axes must be completely visible (see item 4 in the image below).
Vertical	The vertical axis must be completely visible (see item 3 in the image below).

Remarks

The primary axis determines which DataRow will receive the focus when the page-up or page-down buttons are pressed.

For example, let's assume that the focus is currently in the top-left DataRow (item 0). If the page-down button is pressed while the ItemsPrimaryAxis Property is set to Vertical, the DataRow on the bottom-right whose vertical axis is completely visible will receive the focus (item 3). If set to Horizontal, the DataRow on the bottom-right whose horizontal axis is completely visible will receive the focus (item 2), while setting the property to Both will send the focus to the DataRow whose vertical and horizontal axes are completely visible (item 1). Setting the ItemsPrimaryAxis property to None indicates that neither the vertical nor horizontal axes need to be completely visible and thus the focus will be sent to the last DataRow on the bottom-right that is at least partially visible (item 4).

The ItemsPrimaryAxis property applies only when a pixel-scrolling panel template is assigned to a grid's ItemsPanel property. The default VirtualizingStackPanel and VirtualizingCardPanel panels use item-scrolling rather than pixel-scrolling.

Inheritance Hierarchy

System.Object
   System.ValueType
      System.Enum
         Xceed.Wpf.DataGrid.PrimaryAxis

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Xceed.Wpf.DataGrid Namespace

Properties

ItemsPrimaryAxis Property (DataGridControl Class)