syncfusion-wpf-3d-chart

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Implementing Syncfusion WPF 3D Charts

实现Syncfusion WPF 3D Charts

Comprehensive guide for implementing the Syncfusion® WPF 3D Charts (SfChart3D) control to create interactive 3D data visualizations in Windows Presentation Foundation applications. This skill covers setup, configuration, series types, axes, adornments, appearance customization, and interactive features for 3D charts.
本文是在Windows Presentation Foundation应用中实现Syncfusion® WPF 3D Charts(SfChart3D)控件以创建交互式3D数据可视化的综合指南。本技能涵盖3D图表的设置、配置、系列类型、轴、装饰项、外观自定义以及交互式功能。

When to Use This Skill

何时使用本技能

Use this skill when you need to:
  • Create 3D visualizations with Column, Bar, Line, Area, Scatter, or Circular series
  • Plot data in 3D space using X, Y, and Z coordinates with Depth Axis
  • Implement interactive 3D charts with rotation, tilt, and perspective controls
  • Configure 3D series with 11+ chart types (Column, Bar, Line, Scatter, Area, Stacking variants, Pie, Doughnut)
  • Set up multiple axes (Numerical, Category, DateTime, TimeSpan, Logarithmic)
  • Build Manhattan charts with multiple series on depth axis
  • Add data adornments with 3D labels, markers, and positioning
  • Customize appearance with palettes, colors, and themes
  • Enable user interaction with dynamic rotation, selection, and exploding segments
  • Optimize performance for large 3D datasets
当你需要以下功能时使用本技能:
  • 创建3D可视化效果:支持柱状图、条形图、折线图、面积图、散点图或环形图系列
  • 在3D空间中绘制数据:使用X、Y、Z坐标和深度轴
  • 实现交互式3D图表:支持旋转、倾斜和透视控制
  • 配置3D系列:包含11种以上图表类型(柱状图、条形图、折线图、散点图、面积图、堆叠变体、饼图、环形图)
  • 设置多轴:数值轴、分类轴、日期时间轴、时间跨度轴、对数轴
  • 构建曼哈顿图表:在深度轴上展示多个系列
  • 添加数据装饰项:3D标签、标记点和位置设置
  • 自定义外观:调色板、颜色和主题
  • 启用用户交互:动态旋转、选择和扇区分离效果
  • 优化性能:处理大型3D数据集

Component Overview

组件概述

The SfChart3D control provides comprehensive 3D charting capabilities for WPF applications, allowing you to visualize two-dimensional data in a three-dimensional view with full rotation support.
Key Capabilities:
  • 11+ Series Types: Column, Bar, Line, Scatter, Area, Stacking variants, Pie, Doughnut
  • 3D Visualization: Rotation, tilt, perspective angle for optimal data viewing
  • Depth Axis (Z-Axis): True 3D plotting with X, Y, Z coordinates
  • Manhattan Charts: Multiple series visualization on depth axis
  • Multiple Axis Types: Numerical, Category, DateTime, TimeSpan, Logarithmic
  • Interactive Features: Dynamic rotation, selection, exploding segments
  • Data Adornments: 3D labels, markers, positioning
  • Rich Customization: Palettes, colors, themes, styling
  • Data Binding: Full MVVM support with ObservableCollection
  • Animations: Series loading and data update animations
SfChart3D控件为WPF应用提供全面的3D图表功能,允许你以三维视图展示二维数据,并支持完整的旋转操作。
核心功能:
  • 11种以上系列类型:柱状图、条形图、折线图、散点图、面积图、堆叠变体、饼图、环形图
  • 3D可视化:旋转、倾斜、透视角度,优化数据查看体验
  • 深度轴(Z轴):支持X、Y、Z坐标的真3D绘图
  • 曼哈顿图表:在深度轴上展示多个系列
  • 多轴类型:数值轴、分类轴、日期时间轴、时间跨度轴、对数轴
  • 交互式功能:动态旋转、选择、扇区分离
  • 数据装饰项:3D标签、标记点、位置设置
  • 丰富的自定义选项:调色板、颜色、主题、样式
  • 数据绑定:全面支持MVVM和ObservableCollection
  • 动画效果:系列加载和数据更新动画

Documentation and Navigation Guide

文档与导航指南

Getting Started

快速入门

📄 Read: references/getting-started.md
  • Installation and assembly references (Syncfusion.SfChart.WPF)
  • Adding SfChart3D control to WPF projects
  • XAML namespace configuration
  • Setting up PrimaryAxis and SecondaryAxis
  • Basic data binding with ItemsSource, XBindingPath, YBindingPath
  • Creating your first 3D chart with complete example
  • Adding titles, legends, tooltips, and data labels
  • ViewModel setup with ObservableCollection
📄 阅读: references/getting-started.md
  • 安装和程序集引用(Syncfusion.SfChart.WPF)
  • 向WPF项目中添加SfChart3D控件
  • XAML命名空间配置
  • 设置PrimaryAxis和SecondaryAxis
  • 基础数据绑定:ItemsSource、XBindingPath、YBindingPath
  • 创建首个3D图表的完整示例
  • 添加标题、图例、工具提示和数据标签
  • 使用ObservableCollection设置ViewModel

Series Types

系列类型

📄 Read: references/series-types.md
  • Overview of 11+ series types and common properties
  • Column charts (ColumnSeries3D) with Spacing and SegmentSpacing
  • Bar charts (BarSeries3D)
  • Line charts (LineSeries3D)
  • Scatter charts (ScatterSeries3D) with size configuration
  • Area charts (AreaSeries3D)
  • Stacking charts (StackingColumnSeries3D, StackingColumn100Series3D, StackingBarSeries3D, StackingBar100Series3D)
  • Circular charts (PieSeries3D, DoughnutSeries3D)
  • Circular chart features (coefficients, semi-circular, dynamic explode)
  • Series selection and Interior property
  • When to use each series type
📄 阅读: references/series-types.md
  • 11种以上系列类型概述及通用属性
  • 柱状图(ColumnSeries3D):支持Spacing和SegmentSpacing
  • 条形图(BarSeries3D)
  • 折线图(LineSeries3D)
  • 散点图(ScatterSeries3D):支持尺寸配置
  • 面积图(AreaSeries3D)
  • 堆叠图表(StackingColumnSeries3D、StackingColumn100Series3D、StackingBarSeries3D、StackingBar100Series3D)
  • 环形图表(PieSeries3D、DoughnutSeries3D)
  • 环形图表功能:系数、半圆、动态分离
  • 系列选择和Interior属性
  • 各系列类型的适用场景

Axes Configuration

轴配置

📄 Read: references/axes-configuration.md
  • Axis overview (PrimaryAxis, SecondaryAxis, DepthAxis)
  • NumericalAxis3D for numeric data
  • CategoryAxis3D for categorical data
  • DateTimeAxis3D for time-series data
  • TimeSpanAxis3D for time duration data
  • LogarithmicAxis3D for exponential data
  • Depth Axis (Z-Axis) setup with ZBindingPath
  • True 3D plotting with X, Y, Z coordinates
  • Manhattan Charts with multiple series on depth axis
  • Axis customization (headers, intervals, ranges)
  • Troubleshooting axis configuration issues
📄 阅读: references/axes-configuration.md
  • 轴概述(PrimaryAxis、SecondaryAxis、DepthAxis)
  • 数值轴(NumericalAxis3D):用于数值数据
  • 分类轴(CategoryAxis3D):用于分类数据
  • 日期时间轴(DateTimeAxis3D):用于时间序列数据
  • 时间跨度轴(TimeSpanAxis3D):用于时长数据
  • 对数轴(LogarithmicAxis3D):用于指数数据
  • 深度轴(Z轴)设置:ZBindingPath
  • 支持X、Y、Z坐标的真3D绘图
  • 基于深度轴的曼哈顿图表
  • 轴自定义:标题、间隔、范围
  • 轴配置问题排查

Data Adornments

数据装饰项

📄 Read: references/adornments.md
  • ChartAdornmentInfo3D configuration
  • Enabling data labels with ShowLabel property
  • Data markers (types, shapes, customization)
  • Label positioning options
  • Label formatting and templates
  • Adornment styling and appearance
  • Performance considerations for large datasets
📄 阅读: references/adornments.md
  • ChartAdornmentInfo3D配置
  • 启用数据标签:ShowLabel属性
  • 数据标记点:类型、形状、自定义
  • 标签位置选项
  • 标签格式化和模板
  • 装饰项样式和外观
  • 大型数据集的性能考量

Appearance Customization

外观自定义

📄 Read: references/appearance-customization.md
  • Predefined color palettes (Metro, AutumnBrights, FloraHues, Pineapple, TomotoSpectrum, RedChrome, PurpleChrome, BlueChrome, GreenChrome, Elite, LightCandy, SandyBeach)
  • Applying palettes to series vs segments
  • Custom palettes with ColorModel and CustomBrushes
  • SegmentColorPath for data-driven coloring
  • Series Interior property
  • Theme integration
  • Styling best practices
📄 阅读: references/appearance-customization.md
  • 预定义调色板(Metro、AutumnBrights、FloraHues、Pineapple、TomotoSpectrum、RedChrome、PurpleChrome、BlueChrome、GreenChrome、Elite、LightCandy、SandyBeach)
  • 为系列或扇区应用调色板
  • 使用ColorModel和CustomBrushes自定义调色板
  • SegmentColorPath:基于数据的着色
  • 系列Interior属性
  • 主题集成
  • 样式设置最佳实践

Interactive Features

交互式功能

📄 Read: references/interactive-features.md
  • 3D rotation and navigation (EnableRotation, Rotation, Tilt, PerspectiveAngle)
  • Dynamic rotation with mouse and touch devices
  • Selection support (segment and series selection)
  • Circular series explode (ExplodeOnMouseClick, ExplodeIndex, ExplodeAll)
  • Tooltip configuration (ShowTooltip property)
  • Animation support for series loading
  • User interaction patterns and best practices
📄 阅读: references/interactive-features.md
  • 3D旋转与导航(EnableRotation、Rotation、Tilt、PerspectiveAngle)
  • 支持鼠标和触摸设备的动态旋转
  • 选择支持(扇区和系列选择)
  • 环形系列分离(ExplodeOnMouseClick、ExplodeIndex、ExplodeAll)
  • 工具提示配置(ShowTooltip属性)
  • 系列加载动画支持
  • 用户交互模式和最佳实践

Quick Start Example

快速入门示例

Here's a minimal example to create a 3D Column chart:
XAML:
xml
<Window xmlns:chart="clr-namespace:Syncfusion.UI.Xaml.Charts;assembly=Syncfusion.SfChart.WPF">
    
    <Window.DataContext>
        <local:ViewModel/>
    </Window.DataContext>
    
    <chart:SfChart3D Header="Sales Data 3D" Width="500" Height="500">
        
        <!-- Primary Axis (X-Axis) -->
        <chart:SfChart3D.PrimaryAxis>
            <chart:CategoryAxis3D Header="Month"/>
        </chart:SfChart3D.PrimaryAxis>
        
        <!-- Secondary Axis (Y-Axis) -->
        <chart:SfChart3D.SecondaryAxis>
            <chart:NumericalAxis3D Header="Sales"/>
        </chart:SfChart3D.SecondaryAxis>
        
        <!-- Legend -->
        <chart:SfChart3D.Legend>
            <chart:ChartLegend/>
        </chart:SfChart3D.Legend>
        
        <!-- 3D Column Series -->
        <chart:ColumnSeries3D 
            Label="Revenue" 
            ItemsSource="{Binding SalesData}" 
            XBindingPath="Month" 
            YBindingPath="Sales"
            ShowTooltip="True">
            
            <!-- Data Labels -->
            <chart:ColumnSeries3D.AdornmentsInfo>
                <chart:ChartAdornmentInfo3D ShowLabel="True"/>
            </chart:ColumnSeries3D.AdornmentsInfo>
        </chart:ColumnSeries3D>
        
    </chart:SfChart3D>
    
</Window>
C# ViewModel:
csharp
using System.Collections.ObjectModel;

public class SalesData
{
    public string Month { get; set; }
    public double Sales { get; set; }
}

public class ViewModel
{
    public ObservableCollection<SalesData> SalesData { get; set; }
    
    public ViewModel()
    {
        SalesData = new ObservableCollection<SalesData>
        {
            new SalesData { Month = "Jan", Sales = 35000 },
            new SalesData { Month = "Feb", Sales = 48000 },
            new SalesData { Month = "Mar", Sales = 42000 },
            new SalesData { Month = "Apr", Sales = 56000 },
            new SalesData { Month = "May", Sales = 63000 },
            new SalesData { Month = "Jun", Sales = 71000 }
        };
    }
}
以下是创建3D柱状图的最简示例:
XAML:
xml
<Window xmlns:chart="clr-namespace:Syncfusion.UI.Xaml.Charts;assembly=Syncfusion.SfChart.WPF">
    
    <Window.DataContext>
        <local:ViewModel/>
    </Window.DataContext>
    
    <chart:SfChart3D Header="Sales Data 3D" Width="500" Height="500">
        
        <!-- Primary Axis (X-Axis) -->
        <chart:SfChart3D.PrimaryAxis>
            <chart:CategoryAxis3D Header="Month"/>
        </chart:SfChart3D.PrimaryAxis>
        
        <!-- Secondary Axis (Y-Axis) -->
        <chart:SfChart3D.SecondaryAxis>
            <chart:NumericalAxis3D Header="Sales"/>
        </chart:SfChart3D.SecondaryAxis>
        
        <!-- Legend -->
        <chart:SfChart3D.Legend>
            <chart:ChartLegend/>
        </chart:SfChart3D.Legend>
        
        <!-- 3D Column Series -->
        <chart:ColumnSeries3D 
            Label="Revenue" 
            ItemsSource="{Binding SalesData}" 
            XBindingPath="Month" 
            YBindingPath="Sales"
            ShowTooltip="True">
            
            <!-- Data Labels -->
            <chart:ColumnSeries3D.AdornmentsInfo>
                <chart:ChartAdornmentInfo3D ShowLabel="True"/>
            </chart:ColumnSeries3D.AdornmentsInfo>
        </chart:ColumnSeries3D>
        
    </chart:SfChart3D>
    
</Window>
C# ViewModel:
csharp
using System.Collections.ObjectModel;

public class SalesData
{
    public string Month { get; set; }
    public double Sales { get; set; }
}

public class ViewModel
{
    public ObservableCollection<SalesData> SalesData { get; set; }
    
    public ViewModel()
    {
        SalesData = new ObservableCollection<SalesData>
        {
            new SalesData { Month = "Jan", Sales = 35000 },
            new SalesData { Month = "Feb", Sales = 48000 },
            new SalesData { Month = "Mar", Sales = 42000 },
            new SalesData { Month = "Apr", Sales = 56000 },
            new SalesData { Month = "May", Sales = 63000 },
            new SalesData { Month = "Jun", Sales = 71000 }
        };
    }
}

Common Patterns

常见模式

Pattern 1: 3D Chart with Rotation

模式1:带旋转功能的3D图表

Enable interactive rotation for better data exploration:
xml
<chart:SfChart3D EnableRotation="True" Rotation="45" Tilt="-30" PerspectiveAngle="90">
    <!-- Axes and series configuration -->
</chart:SfChart3D>
启用交互式旋转以优化数据探索:
xml
<chart:SfChart3D EnableRotation="True" Rotation="45" Tilt="-30" PerspectiveAngle="90">
    <!-- Axes and series configuration -->
</chart:SfChart3D>

Pattern 2: Manhattan Chart (Multiple Series on Depth Axis)

模式2:曼哈顿图表(深度轴多系列)

Visualize multiple series across depth axis:
xml
<chart:SfChart3D Rotation="43">
    <chart:SfChart3D.PrimaryAxis>
        <chart:CategoryAxis3D/>
    </chart:SfChart3D.PrimaryAxis>
    <chart:SfChart3D.SecondaryAxis>
        <chart:NumericalAxis3D/>
    </chart:SfChart3D.SecondaryAxis>
    
    <!-- Depth Axis (Z-Axis) -->
    <chart:SfChart3D.DepthAxis>
        <chart:CategoryAxis3D/>
    </chart:SfChart3D.DepthAxis>
    
    <chart:LineSeries3D Label="Product A" ItemsSource="{Binding Data1}" 
                        XBindingPath="X" YBindingPath="Y"/>
    <chart:LineSeries3D Label="Product B" ItemsSource="{Binding Data2}" 
                        XBindingPath="X" YBindingPath="Y"/>
</chart:SfChart3D>
在深度轴上展示多个系列:
xml
<chart:SfChart3D Rotation="43">
    <chart:SfChart3D.PrimaryAxis>
        <chart:CategoryAxis3D/>
    </chart:SfChart3D.PrimaryAxis>
    <chart:SfChart3D.SecondaryAxis>
        <chart:NumericalAxis3D/>
    </chart:SfChart3D.SecondaryAxis>
    
    <!-- Depth Axis (Z-Axis) -->
    <chart:SfChart3D.DepthAxis>
        <chart:CategoryAxis3D/>
    </chart:SfChart3D.DepthAxis>
    
    <chart:LineSeries3D Label="Product A" ItemsSource="{Binding Data1}" 
                        XBindingPath="X" YBindingPath="Y"/>
    <chart:LineSeries3D Label="Product B" ItemsSource="{Binding Data2}" 
                        XBindingPath="X" YBindingPath="Y"/>
</chart:SfChart3D>

Pattern 3: True 3D Plotting with X, Y, Z Coordinates

模式3:X、Y、Z坐标的真3D绘图

Plot data using all three dimensions:
xml
<chart:SfChart3D>
    <chart:SfChart3D.PrimaryAxis>
        <chart:NumericalAxis3D/>
    </chart:SfChart3D.PrimaryAxis>
    <chart:SfChart3D.SecondaryAxis>
        <chart:NumericalAxis3D/>
    </chart:SfChart3D.SecondaryAxis>
    
    <!-- Depth Axis for Z coordinates -->
    <chart:SfChart3D.DepthAxis>
        <chart:NumericalAxis3D Interval="1"/>
    </chart:SfChart3D.DepthAxis>
    
    <chart:ColumnSeries3D 
        ItemsSource="{Binding Data3D}" 
        XBindingPath="XValue" 
        YBindingPath="YValue" 
        ZBindingPath="ZValue"/>
</chart:SfChart3D>
使用三个维度绘制数据:
xml
<chart:SfChart3D>
    <chart:SfChart3D.PrimaryAxis>
        <chart:NumericalAxis3D/>
    </chart:SfChart3D.PrimaryAxis>
    <chart:SfChart3D.SecondaryAxis>
        <chart:NumericalAxis3D/>
    </chart:SfChart3D.SecondaryAxis>
    
    <!-- Depth Axis for Z coordinates -->
    <chart:SfChart3D.DepthAxis>
        <chart:NumericalAxis3D Interval="1"/>
    </chart:SfChart3D.DepthAxis>
    
    <chart:ColumnSeries3D 
        ItemsSource="{Binding Data3D}" 
        XBindingPath="XValue" 
        YBindingPath="YValue" 
        ZBindingPath="ZValue"/>
</chart:SfChart3D>

Pattern 4: 3D Pie Chart with Explode Effect

模式4:带分离效果的3D饼图

Create interactive circular charts:
xml
<chart:PieSeries3D 
    ItemsSource="{Binding CategoryData}" 
    XBindingPath="Category" 
    YBindingPath="Value"
    ExplodeOnMouseClick="True"
    CircleCoefficient="0.8">
</chart:PieSeries3D>
创建交互式环形图表:
xml
<chart:PieSeries3D 
    ItemsSource="{Binding CategoryData}" 
    XBindingPath="Category" 
    YBindingPath="Value"
    ExplodeOnMouseClick="True"
    CircleCoefficient="0.8">
</chart:PieSeries3D>

Pattern 5: Custom Color Palette

模式5:自定义调色板

Apply custom colors to your 3D chart:
xml
<chart:SfChart3D Palette="Custom">
    <chart:SfChart3D.ColorModel>
        <chart:ChartColorModel>
            <chart:ChartColorModel.CustomBrushes>
                <SolidColorBrush Color="#6366F1"/>
                <SolidColorBrush Color="#8B5CF6"/>
                <SolidColorBrush Color="#EC4899"/>
                <SolidColorBrush Color="#F59E0B"/>
            </chart:ChartColorModel.CustomBrushes>
        </chart:ChartColorModel>
    </chart:SfChart3D.ColorModel>
    
    <!-- Series configuration -->
</chart:SfChart3D>
为3D图表应用自定义颜色:
xml
<chart:SfChart3D Palette="Custom">
    <chart:SfChart3D.ColorModel>
        <chart:ChartColorModel>
            <chart:ChartColorModel.CustomBrushes>
                <SolidColorBrush Color="#6366F1"/>
                <SolidColorBrush Color="#8B5CF6"/>
                <SolidColorBrush Color="#EC4899"/>
                <SolidColorBrush Color="#F59E0B"/>
            </chart:ChartColorModel.CustomBrushes>
        </chart:ChartColorModel>
    </chart:SfChart3D.ColorModel>
    
    <!-- Series configuration -->
</chart:SfChart3D>

Key Properties Reference

核心属性参考

SfChart3D Control

SfChart3D控件

  • EnableRotation - Enable mouse/touch rotation
  • Rotation - Initial rotation angle (0-360)
  • Tilt - Vertical tilt angle
  • PerspectiveAngle - 3D perspective (0-180)
  • Depth - Chart depth for 3D effect
  • PrimaryAxis - X-axis configuration
  • SecondaryAxis - Y-axis configuration
  • DepthAxis - Z-axis configuration (optional)
  • Header - Chart title
  • Legend - Legend configuration
  • Palette - Color palette selection
  • EnableRotation - 启用鼠标/触摸旋转
  • Rotation - 初始旋转角度(0-360)
  • Tilt - 垂直倾斜角度
  • PerspectiveAngle - 3D透视角度(0-180)
  • Depth - 3D效果的图表深度
  • PrimaryAxis - X轴配置
  • SecondaryAxis - Y轴配置
  • DepthAxis - Z轴配置(可选)
  • Header - 图表标题
  • Legend - 图例配置
  • Palette - 调色板选择

Series Common Properties

系列通用属性

  • ItemsSource - Data collection binding
  • XBindingPath - Property for X values
  • YBindingPath - Property for Y values
  • ZBindingPath - Property for Z values (depth axis)
  • Label - Series name for legend
  • ShowTooltip - Enable tooltips
  • Interior - Series fill color
  • AdornmentsInfo - Data label configuration
  • ItemsSource - 数据集合绑定
  • XBindingPath - X值对应的属性
  • YBindingPath - Y值对应的属性
  • ZBindingPath - Z值对应的属性(深度轴)
  • Label - 图例中的系列名称
  • ShowTooltip - 启用工具提示
  • Interior - 系列填充颜色
  • AdornmentsInfo - 数据标签配置

Spacing Properties (Column/Bar)

间距属性(柱状图/条形图)

  • Spacing - Space between segments (0-1)
  • SegmentSpacing - Space between series (0-1)
  • Spacing - 扇区间的间距(0-1)
  • SegmentSpacing - 系列间的间距(0-1)

Circular Series Properties

环形系列属性

  • CircleCoefficient - Inner circle size (Pie)
  • DoughnutCoefficient - Inner circle size (Doughnut)
  • StartAngle - Starting angle for semi-circular
  • EndAngle - Ending angle for semi-circular
  • ExplodeOnMouseClick - Enable click-to-explode
  • ExplodeIndex - Index of segment to explode
  • ExplodeAll - Explode all segments
  • CircleCoefficient - 内圆尺寸(饼图)
  • DoughnutCoefficient - 内圆尺寸(环形图)
  • StartAngle - 半圆的起始角度
  • EndAngle - 半圆的结束角度
  • ExplodeOnMouseClick - 启用点击分离
  • ExplodeIndex - 要分离的扇区索引
  • ExplodeAll - 分离所有扇区

Common Use Cases

常见用例

Use Case 1: Financial Data Visualization

用例1:金融数据可视化

Visualize quarterly revenue across multiple products in 3D:
  • Use ColumnSeries3D with DepthAxis for product comparison
  • Apply CategoryAxis3D for quarters and products
  • Enable Rotation for different viewing angles
  • Add data labels to show exact values
以3D形式展示多款产品的季度收入:
  • 使用ColumnSeries3DDepthAxis进行产品对比
  • 为季度和产品应用CategoryAxis3D
  • 启用Rotation以支持不同视角
  • 添加数据标签显示精确数值

Use Case 2: Scientific Data Analysis

用例2:科学数据分析

Plot scientific measurements with X, Y, Z coordinates:
  • Use ScatterSeries3D with ZBindingPath for 3D points
  • Apply NumericalAxis3D for all three axes
  • Enable dynamic rotation for data exploration
  • Use custom markers for data point visualization
使用X、Y、Z坐标绘制科学测量数据:
  • 使用ScatterSeries3DZBindingPath绘制3D点
  • 为三个轴应用NumericalAxis3D
  • 启用动态旋转以探索数据
  • 使用自定义标记点可视化数据点

Use Case 3: Market Share Dashboard

用例3:市场份额仪表盘

Display market share distribution in 3D:
  • Use PieSeries3D or DoughnutSeries3D for proportional data
  • Apply custom palettes for brand colors
  • Enable ExplodeOnMouseClick for interactivity
  • Add tooltips for detailed information
以3D形式展示市场份额分布:
  • 使用PieSeries3DDoughnutSeries3D展示比例数据
  • 应用自定义调色板匹配品牌颜色
  • 启用ExplodeOnMouseClick提升交互性
  • 添加工具提示显示详细信息

Use Case 4: Time-Series Comparison

用例4:时间序列对比

Compare multiple datasets over time in 3D:
  • Use LineSeries3D with Manhattan chart pattern
  • Apply DateTimeAxis3D for time-based X-axis
  • Use Label property for series identification
  • Enable Legend for series navigation
以3D形式对比多组时间序列数据:
  • 使用LineSeries3D曼哈顿图表模式
  • 为基于时间的X轴应用DateTimeAxis3D
  • 使用Label属性标识系列
  • 启用Legend以导航系列

Use Case 5: Performance Metrics Dashboard

用例5:性能指标仪表盘

Visualize stacked performance metrics:
  • Use StackingColumnSeries3D for cumulative data
  • Apply custom colors via ColorModel
  • Add data labels for metric values
  • Enable tooltips for drill-down details
可视化堆叠性能指标:
  • 使用StackingColumnSeries3D展示累计数据
  • 通过ColorModel应用自定义颜色
  • 添加数据标签显示指标数值
  • 启用工具提示查看详细信息

Troubleshooting Tips

故障排除技巧

Issue: Chart not displaying
  • Verify assembly reference:
    Syncfusion.SfChart.WPF
  • Check XAML namespace declaration
  • Ensure ItemsSource has data
  • Verify XBindingPath and YBindingPath match property names
Issue: 3D effect not visible
  • Set Depth property (default: 100)
  • Configure Rotation and Tilt angles
  • Adjust PerspectiveAngle for depth perception
Issue: Rotation not working
  • Set EnableRotation="True"
  • Ensure chart has sufficient space (Width/Height)
  • Check for mouse event conflicts
Issue: Depth axis not showing
  • Add DepthAxis configuration to SfChart3D
  • Set ZBindingPath on series
  • Verify series type supports depth axis (Column, Bar, Line, Scatter, StackingColumn, StackingBar)
For detailed troubleshooting and advanced scenarios, refer to the specific reference documentation above.
问题: 图表未显示
  • 验证程序集引用:
    Syncfusion.SfChart.WPF
  • 检查XAML命名空间声明
  • 确保ItemsSource包含数据
  • 验证XBindingPath和YBindingPath与属性名称匹配
问题: 3D效果不可见
  • 设置Depth属性(默认值:100)
  • 配置RotationTilt角度
  • 调整PerspectiveAngle以增强深度感知
问题: 旋转功能不生效
  • 设置EnableRotation="True"
  • 确保图表有足够空间(Width/Height)
  • 检查鼠标事件冲突
问题: 深度轴未显示
  • 为SfChart3D添加DepthAxis配置
  • 在系列上设置ZBindingPath
  • 验证系列类型是否支持深度轴(柱状图、条形图、折线图、散点图、堆叠柱状图、堆叠条形图)
如需详细故障排除和高级场景指导,请参考上述对应参考文档。