syncfusion-winforms-xptaskpane
Guide to implementing Syncfusion XPTaskPane component for Windows Forms. Use when user needs to create Microsoft Office XP-style task pane layouts, manage multiple task pages, configure navigation headers, reorder pages, or customize appearance. Covers container setup, page management, header controls, scrolling, and styling.
How do I install this agent skill?
npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-xptaskpaneIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and code examples for implementing the Syncfusion XPTaskPane component in Windows Forms applications. It covers initialization, page management, navigation, styling, and scrolling. No security risks, malicious patterns, or suspicious external references were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Implementing Syncfusion XPTaskPane
The XPTaskPane component is a Microsoft Office XP-inspired container control that hosts multiple task pages with built-in navigation and design-time support. Use it when you need a professional-looking multi-page layout with page browsing via dropdown menu and navigation buttons.
When to Use XPTaskPane
Use XPTaskPane when you need to:
- Create multi-page layouts inspired by Office XP UI
- Provide navigation between multiple content panels
- Allow users to browse pages via dropdown menu or arrow buttons
- Build collapsible task pane interfaces
- Organize related functionality into distinct pages
- Provide design-time drag-and-drop support for pages
Component Overview
XPTaskPane consists of:
- XPTaskPane - Main container control
- WizardContainer - Page container (automatically added)
- XPTaskPage - Individual pages displayed in the pane
- Header - Navigation toolbar with buttons, menu, and close icon
XPTaskPane (main control)
├── HeaderLeftToolbar (previous/next buttons)
├── HeaderRightToolbar (menu dropdown + close button)
└── TaskPanePageContainer (WizardContainer)
├── XPTaskPage 1
├── XPTaskPage 2
└── XPTaskPage N
Documentation Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Assembly dependencies and NuGet installation
- Adding XPTaskPane via Form Designer
- Adding XPTaskPane programmatically with code
- Creating WizardContainer and XPTaskPage instances
- Basic initialization steps
Page Management
📄 Read: references/page-management.md
- Creating and adding XPTaskPage instances
- Configuring page title and layout name
- Adding controls to task pages
- Accessing the TaskPages collection
- SelectedPage property usage
Navigation & Header Controls
📄 Read: references/navigation-header.md
- Header toolbar components and items
- Navigation button visibility and functionality
- Dropdown menu for page selection
- Header menu customization
- Close button configuration
- Custom images for toolbar buttons
Page Reordering & Navigation
📄 Read: references/page-reordering.md
- Reordering pages at design-time
- NextPage and PreviousPage properties
- Sequential page navigation at runtime
- Bring to Front and Send to Back operations
- Page ordering in collection editor
Appearance & Styling
📄 Read: references/appearance-styling.md
- Visual styles (OfficeXP and Office2007)
- Font and foreground color customization
- Border styles and border properties
- Header label styling
- Page-level appearance configuration
- Custom colors and color schemes
Content Scrolling
📄 Read: references/scrolling-content.md
- Enabling vertical scrolling on pages
- ScrollSpeed property configuration
- Scroll behavior on mouse hover
- Content overflow handling
Quick Start Example
using Syncfusion.Windows.Forms.Tools;
// Step 1: Create XPTaskPane
XPTaskPane xpTaskPane1 = new XPTaskPane();
this.Controls.Add(xpTaskPane1);
// Step 2: Create and add WizardContainer
WizardContainer wizardContainer1 = new WizardContainer();
xpTaskPane1.Controls.Add(wizardContainer1);
xpTaskPane1.TaskPanePageContainer = wizardContainer1;
// Step 3: Create task pages
XPTaskPage page1 = new XPTaskPage();
page1.Title = "Page 1";
wizardContainer1.Controls.Add(page1);
XPTaskPage page2 = new XPTaskPage();
page2.Title = "Page 2";
wizardContainer1.Controls.Add(page2);
// Step 4: Set pages in TaskPages collection
xpTaskPane1.TaskPages = new XPTaskPage[] { page1, page2 };
// Step 5: Add controls to pages
Button btn = new Button() { Text = "Click Me" };
page1.Controls.Add(btn);
Common Patterns
Pattern 1: Designer-Based Setup
- Drag XPTaskPane from toolbox to form
- Click "Add Page" in Smart Tags
- Design each page visually
- No code required for basic setup
Pattern 2: Runtime Page Creation
- Create pages dynamically in response to data or conditions
- Use TaskPages property to update collection
- Useful for dynamic layouts
Pattern 3: Navigation Between Pages
- Set NextPage and PreviousPage properties
- Define page sequence programmatically
- Control order independent of collection
Pattern 4: Custom Styling
- Set VisualStyle to Office2007 or OfficeXP
- Customize Font and ForeColor globally
- Override individual page appearance
Key Properties at a Glance
| Property | Type | Purpose |
|---|---|---|
TaskPages | XPTaskPage[] | Array of all task pages |
SelectedPage | XPTaskPage | Currently active page |
TaskPanePageContainer | Control | Container for pages (WizardContainer) |
VisualStyle | VisualStyle | Office theme (OfficeXP or Office2007) |
ScrollSpeed | int | Scroll speed for page content |
VerticalScroll | bool | Enable vertical scrolling |
Font | Font | Global font for task pane |
ForeColor | Color | Global text color |
HeaderLabel | Label | Header text control |
HeaderLeftToolbar | ToolBar | Previous/next navigation buttons |
HeaderRightToolbar | ToolBar | Menu and close button |
Typical Use Cases
- Multi-Step Wizard - Create step-by-step workflows
- Settings Dashboard - Organize settings into logical sections
- Document Viewer - Browse multiple document sections
- Feature Explorer - Group related features into pages
- Task Organization - Display related tasks in collapsible pages
How can the creator link this skill?
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-xptaskpane">View syncfusion-winforms-xptaskpane on skillZs</a>