Xceed DataGrid for WPF v7.3 Documentation
Xceed.Wpf.DataGrid Assembly / Xceed.Wpf.DataGrid Namespace / PrimaryAxis Enumeration


In This Topic
    PrimaryAxis Enumeration
    In This Topic
    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
    'Declaration
     
    Public Enum PrimaryAxis 
       Inherits System.Enum
    'Usage
     
    Dim instance As PrimaryAxis
    public enum PrimaryAxis : System.Enum 
    Members
    MemberDescription
    BothBoth the vertical and horizontal axes must be completely visible (see item 1 in the image below).
    HorizontalThe horizontal axis ust be completely visible (see item 2 in the image below).
    NoneNeither the vertical nor horizontal axes must be completely visible (see item 4 in the image below).
    VerticalThe 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

    See Also