skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
syncfusion/winforms-ui-components-skills68 installs

syncfusion-winforms-record-navigation-control

Guide for implementing Syncfusion GridRecordNavigationControl in Windows Forms applications for record navigation functionality. Use this skill when implementing Microsoft Access-like navigation bars, first/last/previous/next navigation for grids, or record browsing in Windows Forms. Covers integration with GridControl, GridDataBoundGrid, and GridGroupingControl.

How do I install this agent skill?

npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-record-navigation-control
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a documentation resource for Syncfusion WinForms record navigation controls. It contains instructional markdown and code snippets without any executable code or malicious patterns.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Implementing Grid Record Navigation Controls

A comprehensive guide for implementing the Syncfusion GridRecordNavigationControl in Windows Forms applications. This control provides a Microsoft Access-like navigation bar for navigating between records in grid controls.

When to Use This Skill

Use the GridRecordNavigationControl when you need to:

  • Add navigation controls to browse through grid records
  • Implement Microsoft Access-like record navigation UI
  • Provide first, last, previous, next navigation functionality
  • Navigate large datasets in GridControl or GridDataBoundGrid
  • Integrate navigation bar with GridGroupingControl
  • Create data-driven applications with intuitive record browsing
  • Display record count and current position to users

Component Overview

The GridRecordNavigationControl allows users to navigate between records using a navigation bar positioned at the bottom of a grid. It provides built-in support for navigating to the first, last, previous, and next record with a familiar Microsoft Access-style interface.

Key Features:

  • Built-in Navigation Methods - MoveFirst, MoveLast, MoveNext, MovePrevious
  • Localization Support - Customize navigation bar text and labels
  • Visual Styles - Default, Metro, Office2016 themes
  • GridGroupingControl Integration - ShowNavigationBar property for easy integration
  • Programmatic Control - Navigate records dynamically through code
  • Record Display - Shows current record and total record count

Documentation and Navigation Guide

Getting Started and Setup

📄 Read: references/getting-started.md

  • Assembly deployment requirements (Syncfusion.Grid.Windows, Syncfusion.Shared.Base)
  • Creating GridRecordNavigationControl through Visual Studio Designer
  • Creating GridRecordNavigationControl programmatically through code
  • Adding child grid controls (GridControl, GridDataBoundGrid)
  • Basic configuration and initialization
  • Complete setup examples in C# and VB.NET

Navigation Methods and Functionality

📄 Read: references/navigation-methods.md

  • MoveFirst() - Navigate to the first record
  • MoveLast() - Navigate to the last record
  • MoveNext() - Navigate to the next record
  • MovePrevious() - Navigate to the previous record
  • Use case scenarios for large datasets
  • Programmatic navigation examples
  • Navigation method reference with code samples

Styling and Themes

📄 Read: references/styling.md

  • Visual styles: Default, Metro, Office2016
  • Style property configuration
  • Office2016 color schemes (Black, Colorful, DarkGray, White)
  • GridOfficeScrollBars integration
  • Theme examples with screenshots
  • Appearance customization

GridGroupingControl Integration

📄 Read: references/gridgrouping-integration.md

  • ShowNavigationBar property for GridGroupingControl
  • RecordNavigationBar property access
  • Built-in navigation support integration
  • Enabling navigation bar for grouped data
  • Complete integration examples
  • Record navigation in grouped grids

Quick Start Example

Through Designer (Recommended)

// Step 1: Drag GridRecordNavigationControl from toolbox to form
// Step 2: Position and size the control
// Step 3: Drag GridDataBoundGrid into the GridRecordNavigationControl
// Step 4: Set GridDataBoundGrid.DataSource property

// Designer generates this code:
this.recordNavigationControl1 = new Syncfusion.Windows.Forms.Grid.GridRecordNavigationControl();
this.gridDataBoundGrid1 = new Syncfusion.Windows.Forms.Grid.GridDataBoundGrid();

this.recordNavigationControl1.Controls.Add(this.gridDataBoundGrid1);
this.gridDataBoundGrid1.DataSource = myDataSource;

Through Code

using Syncfusion.Windows.Forms.Grid;
using System.Drawing;

// Create GridRecordNavigationControl
this.recordNavigationControl1 = new GridRecordNavigationControl();
this.recordNavigationControl1.Location = new Point(32, 48);
this.recordNavigationControl1.Size = new Size(520, 256);
this.recordNavigationControl1.MaxRecord = 1000;
this.recordNavigationControl1.MaxLabel = "of 1000";
this.recordNavigationControl1.NavigationBarWidth = 237;

// Create child grid
this.gridControl1 = new GridControl();
this.gridControl1.RowCount = 1000;
this.gridControl1.ColCount = 16;
this.gridControl1.NumberedRowHeaders = false;

// Add grid to navigation control
this.recordNavigationControl1.Controls.Add(this.gridControl1);

// Add to form
this.Controls.Add(this.recordNavigationControl1);

Common Patterns

Pattern 1: Data-Bound Grid with Navigation

using Syncfusion.Windows.Forms.Grid;
using System.Data;

// Create navigation control
var navControl = new GridRecordNavigationControl();
navControl.Location = new Point(20, 20);
navControl.Size = new Size(600, 400);

// Create data-bound grid
var dataGrid = new GridDataBoundGrid();
dataGrid.DataSource = GetDataTable(); // Your data source

// Add grid to navigation control
navControl.Controls.Add(dataGrid);

// Configure navigation
navControl.MaxRecord = dataGrid.Model.RowCount;
navControl.MaxLabel = $"of {dataGrid.Model.RowCount}";

this.Controls.Add(navControl);

Pattern 2: Programmatic Navigation

private RecordNavigationControl recordNavigationControl;
// Navigate to first record
this.recordNavigationControl.NavigationBar.MoveFirst();

// Navigate to last record
this.recordNavigationControl.NavigationBar.MoveLast();

// Navigate to next record
this.recordNavigationControl.NavigationBar.MoveNext();

// Navigate to previous record
this.recordNavigationControl.NavigationBar.MovePrevious();

Pattern 3: Styled Navigation Control

using Syncfusion.Windows.Forms;

// Apply Metro theme
this.recordNavigationControl1.Style = Appearance.Metro;

// Apply Office2016 theme with Black color scheme
this.recordNavigationControl1.Style = Appearance.Office2016;
this.recordNavigationControl1.GridOfficeScrollBars = OfficeScrollBars.Office2016;
this.recordNavigationControl1.Office2016ScrollBarsColorScheme = 
    ScrollBarOffice2016ColorScheme.Black;

Pattern 4: GridGroupingControl with Navigation

using Syncfusion.Windows.Forms.Grid.Grouping;

// Enable navigation bar on GridGroupingControl
this.gridGroupingControl1.ShowNavigationBar = true;

// Access navigation methods through RecordNavigationBar property
this.gridGroupingControl1.RecordNavigationBar.MoveFirst();
this.gridGroupingControl1.RecordNavigationBar.MoveNext();

Key Properties

PropertyTypeDescription
MaxRecordintTotal number of records in the dataset
MaxLabelstringLabel showing total record count (e.g., "of 1000")
NavigationBarWidthintWidth of the navigation bar in pixels
SplitBarsDynamicSplitBarsSplit bar configuration (None, Both, Horizontal, Vertical)
StyleAppearanceVisual style (Default, Metro, Office2016)
Office2016ScrollBarsColorSchemeScrollBarOffice2016ColorSchemeOffice2016 color scheme
GridOfficeScrollBarsOfficeScrollBarsOffice scrollbar style
ShowNavigationBarbool(GridGroupingControl) Shows/hides navigation bar

Key Methods

MethodDescription
MoveFirst()Navigate to the first record
MoveLast()Navigate to the last record
MoveNext()Navigate to the next record
MovePrevious()Navigate to the previous record

Common Use Cases

Use Case 1: Database Viewer Application

Create a data viewer that allows users to browse through database records one at a time, similar to Microsoft Access forms.

Use Case 2: Record Editor

Build an editor interface where users can navigate between records while editing data, with clear indication of current position.

Use Case 3: Large Dataset Navigation

Enable efficient navigation through large datasets (1000+ records) without loading all records into view at once.

Use Case 4: Grouped Data Navigation

Navigate through grouped records in GridGroupingControl while maintaining group structure.

Required Assemblies

To use GridRecordNavigationControl, add these assembly references:

  1. Syncfusion.Grid.Windows.dll - Core grid functionality and navigation control
  2. Syncfusion.Shared.Base.dll - Shared styles, editors, and base components

Implementation Checklist

  • Add required assembly references
  • Create GridRecordNavigationControl (designer or code)
  • Add child grid control (GridControl or GridDataBoundGrid)
  • Configure MaxRecord and MaxLabel properties
  • Set data source if using data-bound grid
  • Apply visual style/theme (optional)
  • Test navigation methods (first, last, next, previous)
  • Handle any custom navigation events (optional)

Best Practices

  1. Designer First: Use Visual Studio Designer for initial setup - it generates correct initialization code
  2. Drop Order: When using designer, drop navigation control first, then drop grid INTO the navigation control (not onto the form)
  3. Set MaxRecord: Always set MaxRecord property to match your dataset size for accurate navigation
  4. Update MaxLabel: Keep MaxLabel synchronized with data changes
  5. Theme Consistency: Apply the same visual style across all Syncfusion controls in your application
  6. Assembly References: Verify both required assemblies are referenced before using the control

Troubleshooting

Navigation doesn't work:

  • Verify child grid is added to navigation control's Controls collection
  • Check that MaxRecord is set correctly
  • Ensure grid has data source or populated rows

Designer issues:

  • Drop grid control INTO navigation control, not onto the form
  • If controls aren't nested properly, recreate in correct order

Styling not applied:

  • Verify Office2016ScrollBarsColorScheme is set when using Office2016 style
  • Check that GridOfficeScrollBars matches the Style property

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/syncfusion/winforms-ui-components-skills/syncfusion-winforms-record-navigation-control">View syncfusion-winforms-record-navigation-control on skillZs</a>