| Package | mx.charts.series |
| Class | public class PieSeries |
| Inheritance | PieSeries Series ChartElement DualStyleObject UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Hide MXML Syntax
The <mx:PieSeries> tag inherits all the properties
of its parent classes, and the following properties:
<mx:PieSeries
Properties
explodeRadius="0"
field="null"
itemType="No default"
labelFunction="No default"
maxLabelRadius="0.6"
nameField="null"
outerRadius="1"
perWedgeExplodeRadius="Array, no default"
renderDataType="No default"
reserveExplodeRadius="0"
startAngle="0"
Styles
calloutGap="10"
calloutStroke="IStroke; no default"
fills="IFill; no default"
fontSize="10"
innerRadius="0"
insideLabelSizeLimit="9"
itemRenderer="No default"
labelPosition="none|callout|inside|insideWithCallout|outside"
legendMarkerRenderer="Defaults to series's itemRenderer"
radialStroke="IStroke; no default"
stroke="IStroke; no default"
/>
See also
| Property | Defined by | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
The current accessibility options for this display object.
| DisplayObject | |
![]() | alpha : Number
Indicates the alpha transparency value of the object specified.
| DisplayObject | |
![]() | baselinePosition : Number
Determines the baseline y-coordinate
of the first line of text of the component.
| UIComponent | |
![]() | blendMode : String
A value from the BlendMode class that specifies which blend mode to use.
| DisplayObject | |
![]() | buttonMode : Boolean
Specifies the button mode of this sprite.
| Sprite | |
![]() | cacheAsBitmap : Boolean
If set to
true, Flash Player caches an internal bitmap representation of the
display object. | DisplayObject | |
![]() | cacheHeuristic : Boolean
Used by Flex to suggest bitmap caching for the object.
| UIComponent | |
![]() | cachePolicy : String
Specifies the bitmap caching policy for this object.
| UIComponent | |
![]() | chartDataProvider : Object
The data provider assigned to the enclosing chart.
| ChartElement | |
![]() | className : String
The name of this instance's class, such as
"Button". | UIComponent | |
![]() | constructor : Object
A reference to the class object or constructor function for a given object instance.
| Object | |
![]() | contentMouseX : Number
Returns the x position of the mouse, in the content coordinate system.
| UIComponent | |
![]() | contentMouseY : Number
Returns the y position of the mouse, in the content coordinate system.
| UIComponent | |
![]() | contextMenu : ContextMenu
Specifies the context menu associated with this object.
| InteractiveObject | |
![]() | currentState : String
The current view state of the component.
| UIComponent | |
![]() | dataProvider : Object
A data provider assigned to the this specific element.
| ChartElement | |
![]() | dataTransform : DataTransform
The data dataTransform the element is associated with.
| Series | |
![]() | descriptor : UIComponentDescriptor
Reference to the UIComponentDescriptor, if any, that was used
by the
createComponentFromDescriptor() method to create this
UIComponent instance. | UIComponent | |
![]() | displayName : String
The name of the series, for display to the user.
| Series | |
![]() | document : Object
A reference to the document object associated with this UIComponent.
| UIComponent | |
![]() | doubleClickEnabled : Boolean
Specifies whether the UIComponent object receives
doubleClick events. | UIComponent | |
![]() | dropTarget : DisplayObject
Specifies the display object over which the sprite is being dragged, or on
which the sprite was dropped.
| Sprite | |
![]() | enabled : Boolean
Whether the component can accept user interaction.
| UIComponent | |
![]() | errorString : String
The text that will be displayed by a component's error tip when a
component is monitored by a Validator and validation fails.
| UIComponent | |
![]() | explicitHeight : Number
Number that specifies the explicit height of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | explicitMaxHeight : Number
Number that specifies the maximum height of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | explicitMaxWidth : Number
Number that specifies the maximum width of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | explicitMinHeight : Number
Number that specifies the minimum height of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | explicitMinWidth : Number
Number that specifies the minimum width of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | explicitWidth : Number
Number that specifies the explicit width of the component,
in pixels, in the component's coordinates.
| UIComponent | |
| explodeRadius : Number
A number from 0 to 1, specifying how far all wedges of the pie
series should be exploded from the center of the chart
as a percentage of the total radius.
| PieSeries | ||
| field : String
Specifies the field of the data provider that determines
the data for each wedge of the PieChart control.
| PieSeries | ||
![]() | filterData : Boolean
This property is
true if the series filters its data
before displaying. | Series | |
![]() | filters : Array
An indexed array that contains each filter object currently associated with the display object.
| DisplayObject | |
![]() | focusEnabled : Boolean
Indicates whether the component can receive focus when clicked on.
| UIComponent | |
![]() | focusManager : IFocusManager
Gets the FocusManager that controls focus for this component
and its peers.
| UIComponent | |
![]() | focusPane : Sprite
The focus pane associated with this object.
| UIComponent | |
![]() | focusRect : Object
Specifies whether this object displays a focus rectangle.
| InteractiveObject | |
![]() | graphics : Graphics
Specifies the Graphics object that belongs to this sprite where vector
drawing commands can occur.
| Sprite | |
![]() | height : Number
Number that specifies the height of the component, in pixels,
in the parent's coordinates.
| UIComponent | |
![]() | hitArea : Sprite
Designates another sprite to serve as the hit area for a sprite.
| Sprite | |
![]() | id : String
ID of the component.
| UIComponent | |
![]() | includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container.
| UIComponent | |
![]() | inheritingStyles : Object
The beginning of this component's chain of inheriting styles.
| UIComponent | |
![]() | initialized : Boolean
A flag that determines if an object has been through all three phases
of layout: commitment, measurement, and layout (provided that any were required).
| UIComponent | |
![]() | instanceIndex : int
The index of a repeated component.
| UIComponent | |
![]() | instanceIndices : Array
An Array containing the indices required to reference
this UIComponent object from its parent document.
| UIComponent | |
![]() | interactive : Boolean
Determines whether DataTips appear when users interact
with chart data on the screen.
| Series | |
![]() | internalStyleName : Object
The name of a class selector this instance inherits values from.
| DualStyleObject | |
![]() | isDocument : Boolean
Determines whether this UIComponent instance is a document object,
that is, whether it is at the top of the hierarchy of a Flex
application, MXML component, or ActionScript component.
| UIComponent | |
![]() | isPopUp : Boolean
Set to
true by the PopUpManager to indicate
that component has been popped up. | UIComponent | |
![]() | labelContainer : Sprite
The DisplayObject that displays labels rendered by this element.
| ChartElement | |
| labelFunction : Function
Specifies a callback function used to render each label
of the PieSeries.
| PieSeries | ||
![]() | legendData : Array
An Array of LegendData instances that describe the items
that should show up in a legend representing this series.
| Series | |
![]() | loaderInfo : LoaderInfo
Returns a LoaderInfo object containing information about loading the file
to which this display object belongs.
| DisplayObject | |
![]() | mask : DisplayObject
The calling display object is masked by the specified
mask object. | DisplayObject | |
![]() | maxHeight : Number
Number that specifies the maximum height of the component,
in pixels, in the component's coordinates.
| UIComponent | |
| maxLabelRadius : Number = 0.6
The maximum amount of the PieSeries's radius
that can be allocated to labels.
| PieSeries | ||
![]() | maxWidth : Number
Number that specifies the maximum width of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | measuredHeight : Number
The default height of the component, in pixels.
| UIComponent | |
![]() | measuredMinHeight : Number
The default minimum height of the component, in pixels.
| UIComponent | |
![]() | measuredMinWidth : Number
The default minimum width of the component, in pixels.
| UIComponent | |
![]() | measuredWidth : Number
The default width of the component, in pixels.
| UIComponent | |
![]() | minHeight : Number
Number that specifies the minimum height of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | minWidth : Number
Number that specifies the minimum width of the component,
in pixels, in the component's coordinates.
| UIComponent | |
![]() | mouseChildren : Boolean
Determines whether or not the children of the object are mouse enabled.
| DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
Specifies whether this object receives mouse messages.
| InteractiveObject | |
![]() | mouseFocusEnabled : Boolean
Whether you can receive focus when clicked on.
| UIComponent | |
![]() | mouseX : Number
Indicates the x coordinate of the mouse position, in pixels.
| DisplayObject | |
![]() | mouseY : Number
Indicates the y coordinate of the mouse position, in pixels.
| DisplayObject | |
![]() | name : String
Indicates the instance name of the DisplayObject.
| DisplayObject | |
| nameField : String
Specifies the field of the data provider that determines
the name of each wedge of the PieChart control.
| PieSeries | ||
![]() | nestLevel : int
Depth of this object in the containment hierarchy.
| UIComponent | |
![]() | nonInheritingStyles : Object
The beginning of this component's chain of non-inheriting styles.
| UIComponent | |
![]() | numChildren : int
Returns the number of children of this object.
| DisplayObjectContainer | |
![]() | opaqueBackground : Object
Specifies whether the display object is opaque with a certain background color.
| DisplayObject | |
| outerRadius : Number
The percentage of the total space available to the PieSeries
to use when rendering the contents of the series.
| PieSeries | ||
![]() | owner : DisplayObjectContainer
The owner of this UIComponent.
| UIComponent | |
![]() | parent : DisplayObjectContainer
The parent container or component for this component.
| UIComponent | |
![]() | parentApplication : Object
A reference to the Application object that contains this UIComponent
instance.
| UIComponent | |
![]() | parentDocument : Object
A reference to the parent document object for this UIComponent.
| UIComponent | |
![]() | percentHeight : Number
Number that specifies the height of a component as a percentage
of its parent's size.
| UIComponent | |
![]() | percentWidth : Number
Number that specifies the width of a component as a percentage
of its parent's size.
| UIComponent | |
| perWedgeExplodeRadius : Array
An Array of numbers from 0 to 1, specifying how far each wedge
of the pie series should be exploded from the center of the chart
as a percentage of the total radius.
| PieSeries | ||
![]() | processedDescriptors : Boolean
Set to
true after immediate or deferred child creation,
depending on which one happens. | UIComponent | |
![]() | prototype : Object
[static]
A reference to the prototype object of a class or function object.
| Object | |
![]() | repeater : IRepeater
A reference to the Repeater object
in the parent document that produced this UIComponent.
| UIComponent | |
![]() | repeaterIndex : int
The index of the item in the data provider
of the Repeater that produced this UIComponent.
| UIComponent | |
![]() | repeaterIndices : Array
An Array containing the indices of the items in the data provider
of the Repeaters in the parent document that produced this UIComponent.
| UIComponent | |
![]() | repeaters : Array
An Array containing references to the Repeater objects
in the parent document that produced this UIComponent.
| UIComponent | |
| reserveExplodeRadius : Number
A number from 0 to 1, specifying how much of the total radius
of the pie series should be reserved to explode wedges at runtime.
| PieSeries | ||
![]() | root : DisplayObject
For a display object in a loaded SWF file, the
root property is the
top-most display object in the portion of the display list's tree structure represented by that SWF file. | DisplayObject | |
![]() | rotation : Number
Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation.
| DisplayObject | |
![]() | scale9Grid : Rectangle
The current scaling grid that is in effect.
| DisplayObject | |
![]() | scaleX : Number
Number that specifies the horizontal scaling factor.
| UIComponent | |
![]() | scaleY : Number
Number that specifies the vertical scaling percentage.
| UIComponent | |
![]() | screen : Rectangle
Returns an object that contains the size and position of the base
drawing surface for this object.
| UIComponent | |
![]() | scrollRect : Rectangle
The scroll rectangle bounds of the display object.
| DisplayObject | |
![]() | soundTransform : SoundTransform
Controls sound within this sprite.
| Sprite | |
![]() | stage : Stage
The Stage of the display object.
| DisplayObject | |
| startAngle : Number
Specifies the starting angle for the first slice of the PieChart control.
| PieSeries | ||
![]() | states : Array
The view states that are defined for this component.
| UIComponent | |
![]() | styleDeclaration : CSSStyleDeclaration
Storage for the inline inheriting styles on this object.
| UIComponent | |
![]() | styleName : Object
The class style used by this component.
| UIComponent | |
![]() | systemManager : ISystemManager
Returns the SystemManager object used by this component.
| UIComponent | |
![]() | tabChildren : Boolean
Determines whether the children of the object are tab enabled.
| DisplayObjectContainer | |
![]() | tabEnabled : Boolean
Specifies whether this object is in the tab order.
| InteractiveObject | |
![]() | tabIndex : int
Specifies the tab ordering of objects in a SWF file.
| InteractiveObject | |
![]() | textSnapshot : TextSnapshot
Returns a TextSnapshot object for this DisplayObjectContainer instance.
| DisplayObjectContainer | |
![]() | toolTip : String
Text to display in the ToolTip.
| UIComponent | |
![]() | transform : Transform
An object with properties pertaining to a display object's matrix, color transform, and pixel bounds.
| DisplayObject | |
![]() | transitionRenderData : Object
A render data structure passed in by a running transtion.
| Series | |
![]() | transitions : Array
An Array of Transition objects, where each Transition object defines a
set of effects to play when a view state change occurs.
| UIComponent | |
![]() | tweeningProperties : Array
Array of properties that are currently being tweened on this object.
| UIComponent | |
![]() | uid : String
A unique identifier for the object.
| UIComponent | |
![]() | updateCompletePendingFlag : Boolean
A flag that determines if an object has been through all three phases
of layout validation (provided that any were required).
| UIComponent | |
![]() | useHandCursor : Boolean
A Boolean value that indicates whether the pointing hand (hand cursor) appears when the mouse rolls
over a sprite in which the
buttonMode property is set to true. | Sprite | |
![]() | validationSubField : String
Used by a validator to associate a subfield with this component.
| UIComponent | |
![]() | visible : Boolean
Controls the visibility of this UIComponent.
| UIComponent | |
![]() | width : Number
Number that specifies the width of the component, in pixels,
in the parent's coordinates.
| UIComponent | |
![]() | x : Number
Number that specifies the component's horizontal position,
in pixels, within its parent container.
| UIComponent | |
![]() | y : Number
Number that specifies the component's vertical position,
in pixels, within its parent container.
| UIComponent | |
| Property | Defined by | ||
|---|---|---|---|
![]() | chart : ChartBase
Refers to the chart component containing this element.
| ChartElement | |
![]() | cursor : IViewCursor
Each ChartElement carries a cursor associated with their dataProvider
for their own internal use.
| ChartElement | |
| itemType : Class
[read-only]
The subtype of ChartItem used by this series
to represent individual items.
| PieSeries | ||
![]() | renderData : Object
Stores the information necessary to render this series.
| Series | |
| renderDataType : Class
[read-only]
The subtype of ChartRenderData used by this series
to store all data necessary to render.
| PieSeries | ||
![]() | unscaledHeight : Number
A convenience method for determining the unscaled height
of the component
All of a component's drawing and child layout should be done
within a bounding rectangle of this height, which is also passed
as an argument to
updateDisplayList(). | UIComponent | |
![]() | unscaledWidth : Number
A convenience method for determining the unscaled width
of the component
All of a component's drawing and child layout should be done
within a bounding rectangle of this width, which is also passed
as an argument to
updateDisplayList(). | UIComponent | |
| Method | Defined by | ||
|---|---|---|---|
|
Constructor.
| PieSeries | ||
![]() |
Adds a child DisplayObject after the end of this child list.
| ChartElement | |
![]() |
Adds a child DisplayObject instance to this DisplayObjectContainer
instance.
| ChartElement | |
![]() |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event.
| EventDispatcher | |
![]() |
Indicates whether the security restrictions
would cause any display objects to be omitted from the list returned by calling
the
DisplayObjectContainer.getObjectsUnderPoint() method
with the specified point point. | DisplayObjectContainer | |
|
Called by the SeriesInterpolate effect to initiate an interpolation.
| PieSeries | ||
![]() |
Queues a function to be called later.
| UIComponent | |
![]() |
Called by the enclosing chart to indicate that the current state
of the chart has changed.
| ChartElement | |
![]() |
Called by the chart to allow associated elements
to claim style selectors from its chartSeriesStyles Array.
| Series | |
![]() |
Deletes a style property from this component instance.
| UIComponent | |
![]() |
Called by the enclosing chart to collect any transitions
a particular element might play when the chart changes state.
| ChartElement | |
![]() |
Determines whether the specified display object is a child of the DisplayObjectContainer instance or
the instance itself.
| DisplayObjectContainer | |
![]() |
Converts a
Point object from content coordinates to global coordinates. | UIComponent | |
![]() |
Converts a
Point object from content to local coordinates. | UIComponent | |
![]() |
Creates an
id reference to this IUIComponent object
on its parent document object. | UIComponent | |
![]() |
Deletes the
id reference to this IUIComponent object
on its parent document object. | UIComponent | |
![]() |
Called by the governing DataTransform to obtain a description
of the data represented by this IChartElement.
| ChartElement | |
![]() |
Returns a UITextFormat object corresponding to the text styles
for this UIComponent.
| UIComponent | |
![]() |
Dispatches an event into the event flow.
| EventDispatcher | |
![]() |
Shows or hides the focus indicator around this component.
| UIComponent | |
![]() |
drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Programatically draws a rectangle into this skin's Graphics object.
| UIComponent | |
![]() |
Called by the effect instance when it stops playing on the component.
| UIComponent | |
![]() |
Called by the effect instance when it starts playing on the component.
| UIComponent | |
![]() |
Ends all currently playing effects on the component.
| UIComponent | |
![]() |
Called by the SeriesInterpolate effect to end an interpolation.
| Series | |
![]() |
Executes the data bindings into this UIComponent object.
| UIComponent | |
![]() |
Finds the closest data point represented by the element
under the given coordinates.
| ChartElement | |
![]() |
Called after printing is complete.
| UIComponent | |
![]() |
Returns a rectangle that defines the area of the display object relative to the coordinate system
of the
targetCoordinateSpace object. | DisplayObject | |
![]() |
Returns the child display object instance that exists at the specified index.
| DisplayObjectContainer | |
![]() |
Returns the child display object that exists with the specified name.
| DisplayObjectContainer | |
![]() |
Returns the index position of a
child DisplayObject instance. | DisplayObjectContainer | |
![]() |
Finds the type selectors for this UIComponent instance.
| UIComponent | |
|
Fills in the
elementBounds, bounds,
and visibleBounds properties of a renderData
structure generated by this series. | PieSeries | ||
![]() |
A convenience method for determining whether to use the
explicit or measured height
| UIComponent | |
![]() |
A convenience method for determining whether to use the
explicit or measured width
| UIComponent | |
![]() |
Gets the object that currently has focus.
| UIComponent | |
![]() |
Returns an array of objects that lie under the specified point and are children
(or grandchildren, and so on) of this DisplayObjectContainer instance.
| DisplayObjectContainer | |
![]() |
Returns a rectangle that defines the boundary of the display object,
based on the coordinate system defined by the
targetCoordinateSpace
parameter, excluding any strokes on shapes. | DisplayObject | |
![]() |
Returns a copy of the data needed to represent this series's data.
| Series | |
![]() |
Returns the item in the
dataProvider that was used
by the specified Repeater to produce this Repeater, or
null if this Repeater isn't repeated. | UIComponent | |
![]() |
Gets a style property that has been set anywhere in this
component's style lookup chain.
| UIComponent | |
![]() |
Converts a
Point object from global to content coordinates. | UIComponent | |
![]() |
Converts the
point object from the Stage (global) coordinates
to the display object's (local) coordinates. | DisplayObject | |
![]() |
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event.
| EventDispatcher | |
![]() |
Indicates whether an object has a specified property defined.
| Object | |
![]() |
Evaluates the display object to see if it overlaps or intersects with the
obj display object. | DisplayObject | |
![]() |
Evaluates the display object to see if it overlaps or intersects with the
point specified by the
x and y parameters. | DisplayObject | |
![]() |
Returns a box Matrix which can be passed to the
drawRoundRect() method
as the rot parameter when drawing a horizontal gradient. | UIComponent | |
![]() |
Initializes the internal structure of this component.
| UIComponent | |
![]() |
Initializes various properties which keep track of repeated instances
of this component.
| UIComponent | |
|
Called by the SeriesInterpolate effect to advance an interpolation.
| PieSeries | ||
![]() |
Marks a component so that its
updateDisplayList()
method gets called during a later screen update. | UIComponent | |
![]() |
Marks a component so that its
commitProperties()
method gets called during a later screen update. | UIComponent | |
![]() |
Marks a component so that its
measure()
method gets called during a later screen update. | UIComponent | |
![]() |
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter.
| Object | |
![]() |
Converts a
Point object from local to content coordinates. | UIComponent | |
![]() |
Converts the
point object from the display object's (local) coordinates to the
Stage (global) coordinates. | DisplayObject | |
![]() |
Called when the mapping of one or more associated axes changes.
| ChartElement | |
![]() |
Measures the specified HTML text, which may contain HTML tags such
as
<font> and <b>,
assuming that it is displayed
in a single-line UITextField using a UITextFormat
determined by the styles of this UIComponent. | UIComponent | |
![]() |
Measures the specified text, assuming that it is displayed
in a single-line UITextField using a UITextFormat
determined by the styles of this UIComponent.
| UIComponent | |
![]() |
Moves the component to a specified position within its parent.
| UIComponent | |
![]() |
Propagate style changes to the children.
| UIComponent | |
![]() |
Returns
true if the chain of owner properties
points from child to this UIComponent. | UIComponent | |
![]() |
Called by Flex when a UIComponent object is added to or removed from a parent.
| UIComponent | |
![]() |
Prepares an IFlexDisplayObject for printing.
| UIComponent | |
![]() |
Indicates whether the specified property exists and is enumerable.
| Object | |
![]() |
Builds or rebuilds the CSS style cache for this component
and, if the
recursive parameter is true,
for all descendants of this component as well. | UIComponent | |
![]() |
For each effect event, register the EffectManager
as one of the event listeners.
| UIComponent | |
![]() |
Removes the specified
child DisplayObject instance from the child list of the DisplayObjectContainer instance. | DisplayObjectContainer | |
![]() |
Removes a child DisplayObject from the specified
index position in the child list of
the DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Removes a listener from the EventDispatcher object.
| EventDispatcher | |
![]() |
[static]
Resumes the background processing of methods
queued by
callLater(), after a call to
suspendBackgroundProcessing(). | UIComponent | |
![]() |
Sets the actual size of this object.
| Series | |
![]() |
Changes the position of an existing child in the display object container.
| DisplayObjectContainer | |
![]() |
Set the current state.
| UIComponent | |
![]() |
Sets the focus to this component.
| UIComponent | |
![]() |
Sets the availability of a dynamic property for loop operations.
| Object | |
![]() |
Sets a style property on this component instance.
| UIComponent | |
![]() |
Called when the
visible property changes. | UIComponent | |
![]() |
Lets the user drag the specified sprite.
| Sprite | |
![]() |
Ends the
startDrag() method. | Sprite | |
![]() |
Detects changes to style properties.
| UIComponent | |
![]() |
Calls the
legendDataChanged() method. | Series | |
![]() |
[static]
Blocks the background processing of methods
queued by
callLater(),
until resumeBackgroundProcessing() is called. | UIComponent | |
![]() |
Swaps the z-order (front-to-back order) of the two specified child objects.
| DisplayObjectContainer | |
![]() |
Swaps the z-order (front-to-back order) of the child objects at the two specified index positions in the
child list.
| DisplayObjectContainer | |
![]() |
Returns a string indicating the location of this object
within the hierarchy of DisplayObjects in the Application.
| FlexSprite | |
![]() |
Validates the position and size of children and draws other
visuals.
| UIComponent | |
![]() |
Validate and update the properties and layout of this object
and redraw it, if necessary.
| UIComponent | |
![]() |
Used by layout logic to validate the properties of a component
by calling the
commitProperties() method. | UIComponent | |
![]() |
Validates the measured size of the component
If the
LayoutManager.invalidateSize() method is called with
this ILayoutManagerClient, then the validateSize() method
is called when it's time to do measurements. | UIComponent | |
![]() |
Handles both the
valid and invalid events from a
validator assigned to this component. | UIComponent | |
![]() |
Returns the primitive value of the specified object.
| Object | |
![]() |
Returns a box Matrix which can be passed to
drawRoundRect()
as the rot parameter when drawing a vertical gradient. | UIComponent | |
![]() |
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type.
| EventDispatcher | |
| Method | Defined by | ||
|---|---|---|---|
![]() |
Adjust the focus rectangle.
| UIComponent | |
![]() |
This is an internal method used by the Flex framework
to support the Dissolve effect.
| UIComponent | |
![]() |
Caches the values stored in the
measureName property
from the original dataProvider items in the chart item's
fieldName property. | Series | |
![]() |
Caches the values stored in the
measureName property
from the original dataProvider items in the chart item's
fieldName property. | Series | |
![]() |
Caches the values stored in the
measureName property
from the original dataProvider items in the chart item's
fieldName property. | Series | |
![]() |
Performs any final processing after child objects are created.
| UIComponent | |
![]() |
Processes the properties set on the component.
| UIComponent | |
| PieSeries | |||
![]() |
Creates a unique id to represent the a dataPoint
for comparison purposes.
| ChartElement | |
![]() |
Indicates the underlying data represented by the element has changed.
| ChartElement | |
![]() |
Extracts the minimum value, maximum value, and, optionally,
the minimum interval from an array of ChartItems.
| Series | |
![]() |
extractMinMax(cache:Array, measureName:String, desc:DataDescription, calculateInterval:Boolean = false):void
Extracts the minimum value, maximum value, and, optionally,
the minimum interval from an array of ChartItems.
| Series | |
![]() |
The event handler called when a UIComponent object gets focus.
| UIComponent | |
![]() |
The event handler called when a UIComponent object loses focus.
| UIComponent | |
|
getMissingInterpolationValues(sourceProps:Object, srcCache:Array, destProps:Object, destCache:Array, index:Number, customData:Object):void
Fills in missing values in an interpolation structure.
| PieSeries | ||
![]() |
Finalizes the initialization of this component.
| UIComponent | |
![]() |
Initializes this component's accessibility code.
| UIComponent | |
![]() |
initializeInterpolationData(srcCache:Array, dstCache:Array, iProps:Object, cacheType:Class = null, customData:Object = null):Object
Helper function for Series to implement the interpolation effect.
| Series | |
![]() |
Informs the series that the underlying data
in the dataProvider has changed.
| Series | |
![]() |
Informs the series that the filter of the data against the axes
has changed and must be recalculated.
| Series | |
![]() |
Informs the series that the mapping of the data into numeric values
has changed and must be recalculated.
| Series | |
![]() |
Informs the series that the transform the data to screen coordinates
has changed and must be recalculated.
| Series | |
![]() |
Informs the series that a significant change has occured
in the display of data.
| Series | |
![]() |
Typically overridden by components containing UITextField objects,
where the UITextField object gets focus.
| UIComponent | |
![]() |
The event handler called for a
keyDown event. | UIComponent | |
![]() |
The event handler called for a
keyUp event. | UIComponent | |
![]() |
Updates the Legend items when the series display name changes
by dispatching a new LegendDataChanged event.
| Series | |
![]() |
Calculates the default size, and optionally the default minimum size,
of the component.
| UIComponent | |
![]() |
Called when a new dataProvider is assigned to the element.
| ChartElement | |
![]() |
Removes any item from the provided cache whose
field
property is NaN. | Series | |
![]() |
This method is called when the underlying data that the series represents
has changed and needs to be reloaded out of the data provider.
| Series | |
|
Draws the object and/or sizes and positions its children.
| PieSeries | ||
![]() |
This method is called when the underlying data the series represents
needs to be filtered against the ranges represented by the axes
of the associated DataTransform.
| Series | |
![]() |
This method is called when the underlying data the series represents
needs to be mapped to numeric representations.
| Series | |
![]() |
This method is called when the underlying data the series represents
needs to be transformed from data to screen values
by the axes of the associated DataTransform.
| Series | |
![]() |
Calls the series's
updateData() and
updateMapping() functions, if necessary. | Series | |
![]() |
Calls the series's
updateFilter() and
updateTransform() functions, if necessary. | Series | |
| Style | Description | Defined by | ||
|---|---|---|---|---|
![]() | Type: Number Format: Length CSS Inheritance: no The vertical distance in pixels from the lower edge of the component to the lower edge of its parent container. | UIComponent | ||
|
calloutGap
| Type: Number Format: Length CSS Inheritance: no Specifies how much space, in pixels, to insert between the edge of the pie and the labels when rendering callouts. The default value is 10. | PieSeries | ||
|
calloutStroke
| Type: mx.graphics.IStroke CSS Inheritance: no Specifies the line style used to draw the lines to callouts. | PieSeries | ||
|
color
| Type: uint Format: Color CSS Inheritance: yes Color of text in the component, including the component label. The default value is 0x0B333C. | PieSeries | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Color of the component highlight when validation fails.. | UIComponent | ||
|
fills
| Type: Array CSS Inheritance: no Specifies an array of fill objects used to render each wedge of the PieChart control. If you do not provide enough Array elements for every slice, Flex repeats the fill from the beginning of the Array. | PieSeries | ||
![]() | Type: String CSS Inheritance: no Blend mode used by the focus rectangle. | UIComponent | ||
![]() | Type: Class CSS Inheritance: no Skin used to draw the focus rectangle. | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: no Thickness, in pixels, of the focus rectangle outline. | UIComponent | ||
|
fontFamily
| Type: String CSS Inheritance: yes Name of the font to use. Unlike in a full CSS implementation, comma-separated lists are not supported. You can use any font family name. If you specify a generic font name, it is converted to an appropriate device font. The default value is "Verdana". | PieSeries | ||
|
fontSize
| Type: Number Format: Length CSS Inheritance: yes Height of the text in pixels. The default value is 10. | PieSeries | ||
|
fontStyle
| Type: String CSS Inheritance: yes Determines whether the text is italic font. Recognized values are "normal" and "italic".
The default value is "normal". | PieSeries | ||
|
fontWeight
| Type: String CSS Inheritance: yes Determines whether the text is boldface. Recognized values are "normal" and "bold".
The default value is "normal". | PieSeries | ||
![]() | Type: Number Format: Length CSS Inheritance: no The horizontal distance in pixels from the center of the component's parent container to the center of the component. | UIComponent | ||
|
innerRadius
| Type: Number CSS Inheritance: no A number from 0 to 1 specifying the distance from the center of the series to the inner edge of the rendered wedges, as a percentage of the total radius assigned to the series. This property is assigned directly to the series. | PieSeries | ||
|
insideLabelSizeLimit
| Type: Number CSS Inheritance: no Specifies the font size threshold, in points, below which inside labels are considered illegible. Below this threshold, Flex either removes labels entirely or renders them as callouts based on the setting of the labelPosition property.
| PieSeries | ||
|
itemRenderer
| Type: mx.core.IFactory CSS Inheritance: no A factory that represents the class the series will use to represent individual items on the chart. This class is instantiated once for each element in the chart. Classes used as an itemRenderer should implement the IFlexDisplayObject, ISimpleStyleClient, and IDataRenderer interfaces. The data property is assigned the
chartItem that the skin instance renders.
| PieSeries | ||
|
labelPosition
| Type: String CSS Inheritance: no Specifies how to render value labels. You can set this property in MXML or using styles. Valid values are:
| PieSeries | ||
![]() | Type: Number Format: Length CSS Inheritance: no The horizontal distance in pixels from the left edge of the component's parent container to the left edge of the component. | UIComponent | ||
|
legendMarkerRenderer
| Type: mx.core.IFactory CSS Inheritance: no The class that the series uses to render the series's marker in any associated legends. If this style is null, most series default to
using their itemRenderer as a legend marker skin instead. Classes used as legend markers should implement the IFlexDisplayObject interface, and optionally the ISimpleStyleClient and IDataRenderer interfaces.
If the class used as a legend marker implements the IDataRenderer interface, the data property is assigned a LegendData instance.
| PieSeries | ||
|
radialStroke
| Type: mx.graphics.IStroke CSS Inheritance: no Specifies the line style used to draw the border between the wedges of the pie. | PieSeries | ||
![]() | Type: Number Format: Length CSS Inheritance: no The horizontal distance in pixels from the right edge of the component to the right edge of its parent container. | UIComponent | ||
|
stroke
| Type: mx.graphics.IStroke CSS Inheritance: no Sets the stroke style for this data series. You must specify a Stroke object to define the stroke. | PieSeries | ||
|
textDecoration
| Type: String CSS Inheritance: no Determines whether the text is underlined. Possible values are "none" and "underline".
The default value is "none". | PieSeries | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Theme color of a component. | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: no The vertical distance in pixels from the top edge of the component's parent container to the top edge of the component. | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: no The vertical distance in pixels from the center of the component's parent container to the center of the component. | UIComponent | ||
| explodeRadius | property |
explodeRadius:Number [read-write]A number from 0 to 1, specifying how far all wedges of the pie series should be exploded from the center of the chart as a percentage of the total radius.
This value explodes all wedges in the pie series uniformly.
You can set the value for individual wedges
via the perWedgeExplodeRadius property.
The explode radius for any individual wedge is the value of the
explodeRadius property plus its value
in the perWedgeExplodeRadius Array.
To guarantee that the pie series
stays within its containing chart's bounds while pulling out wedges,
the pie series might shrink the total radius of the pie.
If you dynamically pull out wedges at run time,
the total pie radius shrinks.
To avoid this effect, you can "reserve" the space
and shrink the total radius initially by setting the
reserveExplodeRadius property to the maximum explode radius
you intend to set at run time.
public function get explodeRadius():Number
public function set explodeRadius(value:Number):void
| field | property |
field:String [read-write]Specifies the field of the data provider that determines the data for each wedge of the PieChart control.
The default value is null.
public function get field():String
public function set field(value:String):void
| itemType | property |
itemType:Class [read-only]The subtype of ChartItem used by this series to represent individual items. Subclasses can override and return a more specialized class if they need to store additional information in the items.
Implementation protected function get itemType():Class
| labelFunction | property |
labelFunction:Function [read-write]Specifies a callback function used to render each label of the PieSeries. The callback function has the following format:
function_name(data:Object, field:String, index:Number, percentValue:Number):String { ... }
The data Object is the dataProvider item being rendered.
The field String is the name of the field in the data that is being rendered.
The index Number is the index in the original dataProvider of the item being rendered.
The percent Number is the percentage of the total this item represents.
This function returns a String that is the label for this item.
Implementation
public function get labelFunction():Function
public function set labelFunction(value:Function):void
| maxLabelRadius | property |
public var maxLabelRadius:Number = 0.6The maximum amount of the PieSeries's radius that can be allocated to labels. This value is only applicable when the series is rendering callout labels.
When rendering callout labels, the PieSeries reduces the radius of the wedges to allow space for the labels along the sides. Once the amount of space allocated to the labels reaches this limit, the series begins reducing the size of the labels to stay within this size.
| nameField | property |
nameField:String [read-write]Specifies the field of the data provider that determines the name of each wedge of the PieChart control.
The default value is null.
public function get nameField():String
public function set nameField(value:String):void
| outerRadius | property |
outerRadius:Number [read-write]The percentage of the total space available to the PieSeries to use when rendering the contents of the series. This value is managed by the containing chart, and should not be assigned to directly.
This value ranges from 0 to 1.
Implementation public function get outerRadius():Number
public function set outerRadius(value:Number):void
| perWedgeExplodeRadius | property |
perWedgeExplodeRadius:Array [read-write]An Array of numbers from 0 to 1, specifying how far each wedge of the pie series should be exploded from the center of the chart as a percentage of the total radius.
The nth value in this Array corresponds to the nth pie wedge.
For example, to pull the third wedge half way out,
you assign perWedgeExplodeRadius = [ 0, 0, 50];.
null or missing values in the Array are treated as 0.
To guarantee that the pie series stays within its containing chart's bounds while pulling out wedges, the pie series might shrink the total radius of the pie.
If you dynamically pull out wedges at run time,
the total pie radius shrinks.
To avoid this effect, you can "reserve" the space
and shrink the total radius initially by setting the
reserveExplodeRadius property to the maximum explode radius
you intend to set at run time.
The value for an individual wedge in the
perWedgeExplodeRadius Array is added to the value
of the series's explodeRadius property to calculate
the total explode radius for any given wedge.
public function get perWedgeExplodeRadius():Array
public function set perWedgeExplodeRadius(value:Array):void
| renderDataType | property |
renderDataType:Class [read-only]The subtype of ChartRenderData used by this series to store all data necessary to render. Subclasses can override and return a more specialized class if they need to store additional information for rendering.
Implementation protected function get renderDataType():Class
| reserveExplodeRadius | property |
reserveExplodeRadius:Number [read-write]
A number from 0 to 1, specifying how much of the total radius
of the pie series should be reserved to explode wedges at runtime.
When a pie wedge is exploded, the series must shrink
the total radius of the pie to make sure it doesn't exceed
the bounds of its containing chart.
Thus if a developer changes the explode value of a wedge at runtime,
it can effectively shrink all the wedges rather than
the desired effect of pulling out a single wedge.
To avoid this, set reserveExplodeRadius
to the maximum value you intend to explode any wedge at runtime.
public function get reserveExplodeRadius():Number
public function set reserveExplodeRadius(value:Number):void
| startAngle | property |
startAngle:Number [read-write]Specifies the starting angle for the first slice of the PieChart control. The default value is 0, which is horizontal on the right side of the PieChart control.
Implementation public function get startAngle():Number
public function set startAngle(value:Number):void
| PieSeries | () | constructor |
public function PieSeries()Constructor.
| beginInterpolation | () | method |
public override function beginInterpolation(sourceRenderData:Object, destRenderData:Object):Object
Called by the SeriesInterpolate effect to initiate an interpolation.
The effect passes in the source and destination data
for the series to interpolate between.
The effect passes the return value of this method
repeatedly to the series's interpolate() method
to advance the animation of the duration of the effect.
The series calculates the data it needs to
perform the interpolation and returns it in this method.
sourceRenderData:Object — The source data for the series to interpolate between.
|
|
destRenderData:Object — The destination data for the series to interpolate between.
|
Object —
The data the series needs to perform the interpolation.
|
| createChildren | () | method |
protected override function createChildren():void
| getElementBounds | () | method |
public override function getElementBounds(renderData:Object):void
Fills in the elementBounds, bounds,
and visibleBounds properties of a renderData
structure generated by this series.
Effect classes call this function to fill in these fields
for use in implementing various effect types.
Derived classes should implement this function
to generate the bounds of the series's items only when requested.
renderData:Object |
| getMissingInterpolationValues | () | method |
protected override function getMissingInterpolationValues(sourceProps:Object, srcCache:Array, destProps:Object, destCache:Array, index:Number, customData:Object):void
Fills in missing values in an interpolation structure.
When a series calls the initializeInterpolationData() method,
it passes in an Array of source and destination values
for the interpolation.
If either of those two Arrays are incomplete, the series needs
to provide "appropriate" placeholder values for the interpolation.
How those placeholder values are determined
is specific to the series type.
Series extenders should override this method
to provide those placeholder values.
sourceProps:Object — An object containing the source values
being interpolated for a particular item.
When this method exits, all properties in this Object
should have non-NaN values.
|
|
srcCache:Array — The Array of source chart items that are being interpolated.
|
|
destProps:Object — An Object containing the destination values
that are being interpolated for a particular item.
When this method exits, all properties in this Object
should have non-NaN values.
|
|
destCache:Array — The Array of destination chart items that are being interpolated.
|
|
index:Number — The index of the item that is being populated in the cache.
|
|
customData:Object — The data that was passed by the series
into the initializeInterpolationData() method.
|
| interpolate | () | method |
public override function interpolate(interpolationValues:Array, interpolationData:Object):void
Called by the SeriesInterpolate effect to advance an interpolation.
The effect calls this once per frame until the interpolation
is complete.
The series is responsible for using the parameters
to render the interpolated values.
By default, the series assumes that interpolationData
is a data structure returned by the
initializeInterpolationData() method, and passes it
through to the applyInterpolation() method.
interpolationValues:Array — An Array of Numbers, each ranging
from 0 to 1, where the nth number indicates the percentage
of the way the nth value in the data series should be
interpolated between the start and end values.
|
|
interpolationData:Object — The data returned from the
beginInterpolation() method.
|
| updateDisplayList | () | method |
protected override function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):voidDraws the object and/or sizes and positions its children. This is an advanced method that you might override when creating a subclass of UIComponent.
You do not call this method directly. Flex calls the
updateDisplayList() method when the component is added to a container
using the addChild() method, and when the component's
invalidateDisplayList() method is called.
If the component has no children, this method
is where you would do programmatic drawing
using methods on the component's Graphics object
such as graphics.drawRect().
If the component has children, this method is where
you would call the move() and setActualSize()
methods on its children.
Components may do programmatic drawing even if
they have children. In doing either, you should use the
component's unscaledWidth and unscaledHeight
as its bounds.
It is important to use unscaledWidth and
unscaledHeight instead of the width
and height properties.
unscaledWidth:Number — Specifies the width of the component, in pixels,
in the component's coordinates, regardless of the value of the
scaleX property of the component.
|
|
unscaledHeight:Number — Specifies the height of the component, in pixels,
in the component's coordinates, regardless of the value of the
scaleY property of the component.
|
<?xml version="1.0"?>
<!-- Simple example to demonstrate the PieChart control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
[Bindable]
private var medalsAC:ArrayCollection = new ArrayCollection( [
{ Country: "USA", Gold: 35, Silver:39, Bronze: 29 },
{ Country: "China", Gold: 32, Silver:17, Bronze: 14 },
{ Country: "Russia", Gold: 27, Silver:27, Bronze: 38 } ]);
private function displayGold(data:Object, field:String, index:Number, percentValue:Number):String {
var temp:String= (" " + percentValue).substr(0,6);
return data.Country + ": " + '\n' + "Total Gold: " + data.Gold + '\n' + temp + "%";
}
]]>
</mx:Script>
<mx:Panel title="Olympics 2004 Medals Tally Panel" height="100%" width="100%">
<mx:PieChart id="chart" height="100%" width="100%"
paddingRight="5" paddingLeft="5"
showDataTips="true" dataProvider="{medalsAC}" >
<mx:series>
<mx:PieSeries labelPosition="callout" field="Gold" labelFunction="displayGold">
<mx:calloutStroke>
<mx:Stroke weight="0" color="0x888888" alpha="100"/>
</mx:calloutStroke>
<mx:radialStroke>
<mx:Stroke weight="0" color="#FFFFFF" alpha="20"/>
</mx:radialStroke>
<mx:stroke>
<mx:Stroke color="0" alpha="20" weight="2"/>
</mx:stroke>
</mx:PieSeries>
</mx:series>
</mx:PieChart>
</mx:Panel>
</mx:Application>
Send me an e-mail when comments are added to this page | Comment Report
Current page: http://livedocs.adobe.com/flex/2/langref/mx/charts/series/PieSeries.html