Inherits from UIView
Declared in IGFunnelChartView.h

Overview

This class represents the funnel chart view.

The funnel chart view is a data visualization tool that displays funnel slices with progressively increasing or decreasing values. The shape of the funnel chart most often resembles an upside-down trapezoid. Funnel chart data is a collection of numeric values, and each slice represents one value.

The funnel chart view supports multiple slice selection, tooltips, tap and long press gestures.

Properties

allowSliceSelection

Determines whether selected slices appear as selected or not. When set to false, this property disables all visual cues that indicate that a slice is selected. All selected slices will appear as not selected. Once this property is set to true, any slices that are marked as selected will visually appear as selected. Changing the value of this property has no effect on the selectedSlices property.

@property (nonatomic) BOOL allowSliceSelection

Declared In

IGFunnelChartView.h

bottomEdgeWidth

Determines the width of the bottom of the funnel. This value should be between 0 and 1 and is expressed as percentage of the total width of the control. For example, setting this property to 0 will create a pointy bottom, while setting it to 1 will make the bottom take up the entire width of the control.

@property (nonatomic) CGFloat bottomEdgeWidth

Declared In

IGFunnelChartView.h

brushes

An array of IGBrush objects that are used to color the funnel slices. This array takes precedence over themes.

@property (nonatomic, retain) NSArray *brushes

Declared In

IGFunnelChartView.h

dataPoints

Returns an array of IGCategoryPoint objects. (read-only)

@property (nonatomic, readonly) NSMutableArray *dataPoints

Declared In

IGFunnelChartView.h

dataSource

Sets the data source for the funnel chart view. This can be an interface that conforms to IGFunnelChartViewDataSource protocol or an instance of IGFunnelChartViewDataSourceHelper.

@property (nonatomic, assign) id<IGFunnelChartViewDataSource> dataSource

Declared In

IGFunnelChartView.h

delegate

Sets the interaction delegate for the funnel chart.

@property (nonatomic, assign) id<IGFunnelChartViewDelegate> delegate

Declared In

IGFunnelChartView.h

exportVisualData

Returns a data representation of the visuals of the funnel chart.

@property (NS_NONATOMIC_IOSONLY, readonly, strong) VisualFunnelChartData *exportVisualData

Discussion

This method is available to provide a way to do validation for testing of the visuals of the funnel chart.

Declared In

IGFunnelChartView.h

font

Determines the font used by the funnel chart labels. This is the default font for the labels of the slices that are not selected. Selected labels and the others label have their own font properties.

@property (nonatomic, retain) UIFont *font

Declared In

IGFunnelChartView.h

fontBrush

Determines the font brush used by the funnel char labels. This is the default font brush for the labels of the slices that are not selected. Selected labels and the others label have their own font brush properties.

@property (nonatomic, retain) IGBrush *fontBrush

Declared In

IGFunnelChartView.h

funnelSliceDisplay

Determines the display style of the funnel. This property can be set to Weighted or Uniform. When using Weighted style, the height of each slice is based on the underlying value. In Uniform style the height of all slices is constant and depends on the size of the control.

@property (nonatomic) IGFunnelSliceDisplay funnelSliceDisplay

Declared In

IGFunnelChartView.h

innerLabelsVisible

Determines whether the inner labels should be visible.

@property (nonatomic) BOOL innerLabelsVisible

Declared In

IGFunnelChartView.h

isInverted

Determines if the slices should be displayed in reverse order.

@property (nonatomic) BOOL isInverted

Declared In

IGFunnelChartView.h

legend

Associates an item legend with the funnel chart.

@property (nonatomic, assign) IGLegend *legend

Declared In

IGFunnelChartView.h

lowerBezierControlPoint

Specifies the lower control point if a bezier curve is used to define the funnel.

@property (nonatomic) CGPoint lowerBezierControlPoint

Declared In

IGFunnelChartView.h

outerLabelAlignment

Determines whether the outer labels should be on the left or the right side of the funnel.

@property (nonatomic) IGFunnelOuterLabelAlignment outerLabelAlignment

Declared In

IGFunnelChartView.h

outerLabelsVisible

Determines whether the outer labels should be visible.

@property (nonatomic) BOOL outerLabelsVisible

Declared In

IGFunnelChartView.h

outlineThickness

Determines the thickness of the outline around the slices.

@property (nonatomic) CGFloat outlineThickness

Declared In

IGFunnelChartView.h

outlines

An array of IGBrush objects that are used to color the slice outlines. This array takes precedence over themes.

@property (nonatomic, retain) NSArray *outlines

Declared In

IGFunnelChartView.h

renderingQuality

Determines the rendering quality of the chart. This property only affects retina displays. By default, the chart will render with high quality. If the chart contains too many data points and its performance begins to degrade due to a high number of shapes, setting a lower rendering quality will increase the performance.

@property (nonatomic) IGRenderingQuality renderingQuality

Declared In

IGFunnelChartView.h

resolvedSelectedBrush

Determines the brush of selected slices.

@property (nonatomic, readonly) IGBrush *resolvedSelectedBrush

Declared In

IGFunnelChartView.h

resolvedSelectedOutline

Determines the outline color around selected slices.

@property (nonatomic, readonly) IGBrush *resolvedSelectedOutline

Declared In

IGFunnelChartView.h

resolvedSelectedOutlineThickness

Determines the thickness of the outline around selected slices.

@property (nonatomic, readonly) CGFloat resolvedSelectedOutlineThickness

Declared In

IGFunnelChartView.h

selectedBrush

Determines the brush of selected slices.

@property (nonatomic, retain) IGBrush *selectedBrush

Declared In

IGFunnelChartView.h

selectedItems

Returns an array of selected items from the datasource.

@property (nonatomic, readonly) NSArray *selectedItems

Discussion

This property returns instances of IGFunnelPoint that are selected.

Declared In

IGFunnelChartView.h

selectedOutline

Determines the outline color around selected slices.

@property (nonatomic, retain) IGBrush *selectedOutline

Declared In

IGFunnelChartView.h

selectedOutlineThickness

Determines the thickness of the outline around selected slices.

@property (nonatomic) CGFloat selectedOutlineThickness

Declared In

IGFunnelChartView.h

selectedSlices

An index collection of selected sliced.

@property (nonatomic, retain) NSIndexSet *selectedSlices

Discussion

This property contains a set of indices that represent the selected slices. For example, a set of {0,1,3} means that the first, second and fourth slices are selected.

Declared In

IGFunnelChartView.h

theme

This property can be used to apply a theme to a funnel chart.

@property (nonatomic, assign) id<IGFunnelChartThemeDefinition> theme

Discussion

This can be a pre-defined or a custom theme. Pre-defined themes can be used by setting this property to one of the themes in IGFunnelChartDefaultThemes interface.

Declared In

IGFunnelChartView.h

tooltipPinLocation

Specifies the tooltip location.

@property (nonatomic) IGTooltipPinLocation tooltipPinLocation

Discussion

This property determines where the tooltip will be positioned. The default setting uses a floating tooltip, which follows the location of the long press. Tooltip can also be pinned to top, bottom, left, or right.

Declared In

IGFunnelChartView.h

upperBezierControlPoint

Specifies the upper control point if a bezier curve is used to define the funnel.

@property (nonatomic) CGPoint upperBezierControlPoint

Declared In

IGFunnelChartView.h

useBezierCurve

Determines whether a bezier curve should be used to define the funnel.

@property (nonatomic) BOOL useBezierCurve

Declared In

IGFunnelChartView.h

useOuterLabelsForLegend

Specifies whether outer labels should be displayed in the legend items, when a legend is associated with the funnel. By default inner labels are used.

@property (nonatomic) BOOL useOuterLabelsForLegend

Declared In

IGFunnelChartView.h

Instance Methods

clearItemsForDataSource:

Notifies the chart view that all items in the data source were cleared.

- (void)clearItemsForDataSource:(id<IGFunnelChartViewDataSource>)source

Parameters

source

Data source that had its items removed.

Discussion

This method is used to tell the chart view that all of the items in a given data source have been removed.

Declared In

IGFunnelChartView.h

insertItemAtIndex:withSource:

Notifies the chart view that an item has been inserted in the data source.

- (void)insertItemAtIndex:(NSInteger)index withSource:(id<IGFunnelChartViewDataSource>)source

Parameters

index

Index of an item that has been inserted.

source

Data source that had an item inserted.

Discussion

This method is used to tell the chart view that an item has been inserted into a given data source at a given index.

Declared In

IGFunnelChartView.h

removeItemAtIndex:withSource:

Notifies the chart view that an item has been removed from the data source.

- (void)removeItemAtIndex:(NSInteger)index withSource:(id<IGFunnelChartViewDataSource>)source

Parameters

index

Index of an item that has been removed.

source

Data source that had an item removed.

Discussion

This method is used to tell the chart view that an item has been removed from a given data source at a given index.

Declared In

IGFunnelChartView.h

replaceItemAtIndex:withSource:

Notifies the chart view that an item has been replaced in the data source.

- (void)replaceItemAtIndex:(NSInteger)index withSource:(id<IGFunnelChartViewDataSource>)source

Parameters

index

Index of an item that has been replaced.

source

Data source that had an item replaced.

Discussion

This method is used to tell the chart view that an item has been replaced in a given data source at a given index.

Declared In

IGFunnelChartView.h

updateItemAtIndex:withSource:

Notifies the chart view that an item has been updated in the data source.

- (void)updateItemAtIndex:(NSInteger)index withSource:(id<IGFunnelChartViewDataSource>)source

Parameters

index

Index of an item that has been replaced.

source

Data source that had an item replaced.

Discussion

This method is used to tell the chart view that an item has been updated in a given data source at a given index.

Declared In

IGFunnelChartView.h