New to Telerik UI for WinForms? Start a free 30-day trial

Displays data points as vertically stacked funnel segments whose geometry reflects their values and layout settings.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

C#
public class FunnelSeries : ChartSeries, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartSeries, IChartElementPresenter, IAxisProvider

Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesFunnelSeries...

Implements: IAxisProviderIBorderElementIBoxElementIBoxStyleIChartElementPresenterIChartSeriesICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode...

Inherited Members ChartSeries.PointSizePropertyChartSeries.LabelFormatPropertyChartSeries.DrawLinesToLabelsPropertyChartSeries.SyncLinesToLabelsColorPropertyChartSeries.LinesToLabelsColorPropertyChartSeries.LabelRotationAnglePropertyChartSeries.OnDataPointIsSelectedChanged(DataPoint)ChartSeries.EnsureVisualState(ChartArea)ChartSeries.ApplyStyleSettingsCore(PropertySettingGroup)ChartSeries.Refresh()ChartSeries.OnPropertyChanged(RadPropertyChangedEventArgs)ChartSeries.CreateDataPointElementCollection()ChartSeries.CreateDataPoint()ChartSeries.CreateDataPointElement(DataPoint)ChartSeries.OnApplyPalette()ChartSeries.GetElement(Point)ChartSeries.GetStyleIndex()ChartSeries.HitTest(int, int)ChartSeries.GetDefaultTrackballTextForPoint(DataPoint)ChartSeries.OnCreatePoint(ChartViewCreatePointEventArgs)ChartSeries.OnTrackballPointTextNeeded(TrackballPointTextNeededEventArgs)ChartSeries.SelectedStyleChartSeries.LabelFormatChartSeries.ShowLabelsChartSeries.LabelFormatProviderChartSeries.PointSizeChartSeries.DrawLinesToLabelsChartSeries.SyncLinesToLabelsColorChartSeries.LinesToLabelsColorChartSeries.DataPointsChartSeries.DataSourceChartSeries.DataMemberChartSeries.DisplayMemberChartSeries.FamilyChartSeries.NameChartSeries.AxesChartSeries.BoundsChartSeries.IsVisibleChartSeries.PaletteChartSeries.LabelRotationAngleChartSeries.TrackballFormatStringChartSeries.CreatePointChartSeries.TrackballPointTextNeededUIChartElement.IsVisiblePropertyUIChartElement.ClassPropertyUIChartElement.VisualStatePropertyUIChartElement.IsMouseDownPropertyUIChartElement.IsMouseOverPropertyUIChartElement.FontPropertyUIChartElement.CustomFontPropertyUIChartElement.CustomFontSizePropertyUIChartElement.CustomFontStylePropertyUIChartElement.ForeColorPropertyUIChartElement.BackColorPropertyUIChartElement.BackColor2PropertyUIChartElement.BackColor3PropertyUIChartElement.BackColor4PropertyUIChartElement.NumberOfColorsPropertyUIChartElement.GradientStylePropertyUIChartElement.GradientAnglePropertyUIChartElement.GradientPercentagePropertyUIChartElement.GradientPercentage2PropertyUIChartElement.BorderBoxStylePropertyUIChartElement.BorderDrawModePropertyUIChartElement.BorderWidthPropertyUIChartElement.BorderLeftWidthPropertyUIChartElement.BorderRightWidthPropertyUIChartElement.BorderTopWidthPropertyUIChartElement.BorderBottomWidthPropertyUIChartElement.BorderGradientAnglePropertyUIChartElement.BorderGradientStylePropertyUIChartElement.BorderColorPropertyUIChartElement.BorderColor2PropertyUIChartElement.BorderColor3PropertyUIChartElement.BorderColor4PropertyUIChartElement.BorderInnerColorPropertyUIChartElement.BorderInnerColor2PropertyUIChartElement.BorderInnerColor3PropertyUIChartElement.BorderInnerColor4PropertyUIChartElement.BorderLeftColorPropertyUIChartElement.BorderTopColorPropertyUIChartElement.BorderRightColorPropertyUIChartElement.BorderBottomColorPropertyUIChartElement.BorderLeftShadowColorPropertyUIChartElement.BorderTopShadowColorPropertyUIChartElement.BorderRightShadowColorPropertyUIChartElement.BorderBottomShadowColorPropertyUIChartElement.BackgroundShapePropertyUIChartElement.BorderDashStylePropertyUIChartElement.BorderDashPatternPropertyUIChartElement.BorderCornerRadiusPropertyUIChartElement.ShapePropertyUIChartElement.PaddingPropertyUIChartElement.SmoothingModePropertyUIChartElement.GetValue(RadProperty)UIChartElement.Attach(UIChartElement)UIChartElement.Dettach()UIChartElement.Invalidate()UIChartElement.MeasureContentOverride(ChartNode, object)UIChartElement.DpiScaleChanged(SizeF)UIChartElement.GetScaledFont(float)UIChartElement.GetCurrentShape()UIChartElement.GetThemeEffectiveType()UIChartElement.ApplyStyle()UIChartElement.BuildVisualState()UIChartElement.AddStylePropertySetting(IPropertySetting)UIChartElement.ApplyStyleByIndex(PropertySettingGroup, int)UIChartElement.ParentUIChartElement.LevelUIChartElement.ChildrenUIChartElement.IsMouseDownUIChartElement.IsMouseOverUIChartElement.ViewUIChartElement.ForeColorUIChartElement.FontUIChartElement.BackColorUIChartElement.BackColor2UIChartElement.BackColor3UIChartElement.BackColor4UIChartElement.GradientStyleUIChartElement.GradientAngleUIChartElement.GradientPercentageUIChartElement.GradientPercentage2UIChartElement.NumberOfColorsUIChartElement.BorderLeftColorUIChartElement.BorderTopColorUIChartElement.BorderRightColorUIChartElement.BorderBottomColorUIChartElement.BorderLeftShadowColorUIChartElement.BorderTopShadowColorUIChartElement.BorderRightShadowColorUIChartElement.BorderBottomShadowColorUIChartElement.BorderBoxStyleUIChartElement.BorderDrawModeUIChartElement.BorderWidthUIChartElement.BorderLeftWidthUIChartElement.BorderTopWidthUIChartElement.BorderRightWidthUIChartElement.BorderBottomWidthUIChartElement.BorderGradientAngleUIChartElement.BorderGradientStyleUIChartElement.BorderColorUIChartElement.BorderColor2UIChartElement.BorderColor3UIChartElement.BorderColor4UIChartElement.BorderInnerColorUIChartElement.BorderInnerColor2UIChartElement.BorderInnerColor3UIChartElement.BorderInnerColor4UIChartElement.BorderDashStyleUIChartElement.BorderDashPatternUIChartElement.BorderCornerRadiusUIChartElement.SizeUIChartElement.ShapeUIChartElement.BackgroundShapeUIChartElement.PaddingUIChartElement.SmoothingModeUIChartElement.IsAttachedUIChartElement.DpiScaleFactorUIChartElement.ClassUIChartElement.VisualStateUIChartElement.ThemeRoleUIChartElement.ChildrenHierarchyUIChartElement.StyleUIChartElement.StateManagerUIChartElement.FallbackToDefaultThemeRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.SetValueCore(RadPropertyValue, object, object, ValueSource)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.IsPropertyCancelable(RadPropertyMetadata)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.PerformDispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

Creates a funnel series without value or legend-title member bindings.

C#
public FunnelSeries()

Creates a funnel series bound to value and legend-title members.

C#
public FunnelSeries(string valueMember, string legendTitleMember)
Parameters:valueMemberstring

The source member that supplies each segment's value.

legendTitleMemberstring

The source member that supplies each segment's legend title.

Creates a funnel series bound to the specified value member.

C#
public FunnelSeries(string valueMember)
Parameters:valueMemberstring

The source member that supplies each segment's value.

Fields

Identifies the alignment used to position labels within funnel segments.

C#
public static RadProperty LabelAlignmentProperty

Properties

Gets or sets how segments height is calculated. When false all the segments will share the same height. When true the height of each segment is determined according to its value. Default value is true.

C#
public bool DynamicHeight { get; set; }

Gets or sets whether the form of each segment will be based on the ratio between the value from the current and the next segment. Default value is false.

C#
public bool DynamicSlope { get; set; }

Gets or sets the alignemnt of the label of each funnel segment.

C#
public ContentAlignment LabelAlignment { get; set; }

Gets or sets the source member bound to each funnel point's legend title.

C#
[Browsable(true)]
public string LegendTitleMember { get; set; }

Changing this member updates the binding used to populate legend titles.

Gets the model that computes funnel segment geometry and layout.

C#
public override ChartSeriesModel Model { get; }

Overrides: ChartSeries.Model

Gets or sets the ratio between the top and the bottom bases of the whole funnel series. The property can take effect only if the DynamicSlope property is set to false.

C#
public float NeckRatio { get; set; }

Gets or sets the space between the different segments of the funnel chart in pixels.

C#
public int SegmentSpacing { get; set; }

Gets or sets the source member bound to each funnel point's value.

C#
[Browsable(true)]
public string ValueMember { get; set; }

Changing this member updates the binding used to populate point values.

Methods

Binds the configured value and legend-title members and invalidates the funnel's prepared data.

C#
protected override void BindMembers()

Overrides: ChartSeries.BindMembers()

Creates the default data point type for this series.

C#
protected override DataPoint CreateDefaultDataPoint()
Returns:

DataPoint

A new FunnelDataPoint.

Overrides: ChartSeries.CreateDefaultDataPoint()

Creates the funnel model and data-point collection, and subscribes to collection resets to clear the funnel area's legend items.

C#
protected override ChartDataPointCollection CreateModel()
Returns:

ChartDataPointCollection

The collection used to store this series' funnel data points.

Overrides: ChartSeries.CreateModel()

Creates the visual element for a funnel data point.

C#
protected override DataPointElement CreatePointElement(DataPoint point)
Parameters:pointDataPoint

The funnel data point to render.

Returns:

DataPointElement

The point element associated with point.

Overrides: ChartSeries.CreatePointElement(DataPoint)

Unsubscribes from the data-point collection before releasing managed series resources.

C#
protected override void DisposeManagedResources()

Overrides: ChartSeries.DisposeManagedResources()

Gets the palette entry used to color a funnel segment at the specified index.

C#
public PaletteEntry GetFunnelSegmentColors(int i)
Parameters:iint

The segment index used to look up the palette entry.

Returns:

PaletteEntry

The matching palette entry, or null when no entry is available.

Requires a FunnelArea parent and relayouts the view after attachment.

C#
protected override void OnAttached(UIChartElement parent)
Parameters:parentUIChartElement

The chart element to which the series is being attached.

Exceptions: InvalidOperationException

parent is not a FunnelArea.

Overrides: ChartSeries.OnAttached(UIChartElement)

Detaches child funnel points before running the base-series detach logic.

C#
protected override void OnDettached()

Overrides: ChartSeries.OnDettached()

Invalidates prepared funnel data and relayouts the view after a series-property change.

C#
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters:propertyNamestring

The name of the changed property.

Overrides: RadObject.OnNotifyPropertyChanged(string)

Ensures that this series contains only funnel data points.

C#
protected override void ValidatePoint(DataPoint item)
Parameters:itemDataPoint

The data point to validate.

Exceptions: ArgumentException

item is not a FunnelDataPoint.

Overrides: ChartSeries.ValidatePoint(DataPoint)