Xceed Toolkit Plus for WPF v5.0 Documentation
Xceed.Wpf.DataGrid Assembly / Xceed.Wpf.DataGrid Namespace / DataGridControl Class / ItemsPrimaryAxis Property


In This Topic
    ItemsPrimaryAxis Property
    In This Topic
    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
    '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

    See Also