ItemsPrimaryAxis Property

Gets or sets a 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 Property ItemsPrimaryAxis As PrimaryAxis

'Usage
 
Dim instance As DataGridControl

Dim value As PrimaryAxis

 

instance.ItemsPrimaryAxis = value

 

value = instance.ItemsPrimaryAxis

public PrimaryAxis ItemsPrimaryAxis {get; set;}

Property Value

A PrimaryAxis 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. By default, PrimaryAxis.Vertical.

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

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.

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).

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

DataGridControl Class
DataGridControl Members