Version

Getting Started with XamPieChart

Getting Started

To get started using the XamPieChart™ control, see the Data Binding topic.

Essential XamPieChart Properties

The following is a summary of some of the more essential properties of the Pie Chart control.

  • ItemsSource - Stores a reference to the Pie Chart’s data.

  • ValueMemberPath - A string specifying the property name on the data model to be used as value, i.e. the arc length of each pie slice.

  • LabelMemberPath - This string specifies the property name on the data model to be used as label, i.e. the text that appears on each pie slice and inside the legend.

  • LegendLabelMemberPath - This string specifies the property name on the data model to be used in the legend for each pie slice. If this is not set it will use the LabelMemberPath instead.

  • LabelsPosition - An enumerated type that specifies how labels are arranged.

    • None: Hides all labels.

    • Center: Tries to fit labels in the center of the slice. If they don’t fit, hides them.

    • InsideEnd: Tries to fit labels just inside the outer rim of the slice. If they don’t fit, hides them.

    • OutsideEnd: Shows labels outside of the pie slices.

    • BestFit: Tries to fit labels according to the following priority order: Center, InsideEnd, OutsideEnd.

  • LabelExtent - Specifies the distance between the edge of the pie slice and the start of the label. Relevant when LabelsPosition is set to OutsideEnd.

  • LeaderLineVisibility - Specifies whether leader lines should be visible. Relevant when LabelsPosition is set to OutsideEnd.

  • ExplodedRadius - Determines the distance a pie slice shifts outward when it is exploded. The valid value range is between 0 and 1.

  • RadiusFactor Determines the radius of the pie chart. When set to 1, the radius is equal to the maximum of the control’s Width and Height. The valid value range is between 0 and 1.

  • AllowSliceSelection - Boolean; permits or disallows pie slice selection.

  • SelectedSlices - Array of index values; describes which pie slices are currently selected.

  • ExplodedSlices - Array of index values; describes which pie slices are currently exploded.

  • StartAngle - The offset angle, in degrees, at which pie slices start to be rendered.

  • SweepDirection - Determines the angular direction in which pie slices are rendered, beginning from the StartAngle.

  • SliceClick - Event that is raised when the user clicks on a pie slice; see Selection and Explosion.

  • Legend - Stores an optional reference to the ItemLegend object to be associated with the Pie Chart.

  • Brushes - An optional reference to a collection of brushes, used in sequential order to color the pie slices.